CodeSign Docs
!

Documentación de la versión 0.9.0, que ya no es la actual. Ver la documentación actualizada (versión 0.9.6).

Documentación

CodeSign — firma digital masiva

CodeSign firma lotes completos de documentos PDF con tu token USB o tu certificado S1 en archivo, con sello de tiempo, verificación de revocación y firma visible con tu logo. Esta guía explica cómo instalarlo, activar la licencia y firmar.

¿Qué es CodeSign?

CodeSign es una aplicación de escritorio que firma digitalmente carpetas enteras de PDF de una sola vez. Elegís la carpeta con los documentos, la carpeta donde dejar los firmados, conectás tu token o tu certificado S1 y CodeSign firma todo el lote, mostrando el avance en vivo.

Está pensado para organizaciones que firman cientos o miles de documentos por día —contratos, recibos, liquidaciones, comprobantes— y no pueden firmarlos uno por uno.

Formato

PAdES (ETSI), válida en Adobe Reader

Plataformas

Windows, macOS y Linux

Licencia

Sin servidor de licencias, asociada al equipo

Novedades de esta versión

Esta versión se reescribió desde cero. Mantiene el flujo de trabajo de la versión anterior y suma:

  • Windows, Mac y Linux, con un instalador para cada sistema y sin instalar Java aparte.
  • Firma en paralelo: mientras el token firma un documento, los siguientes ya se preparan y piden su sello de tiempo. Con certificado S1, 500 PDF con sello de tiempo en menos de 30 segundos (medido en una notebook de 8 núcleos con el servicio de sellado de CODE100; el rendimiento depende del equipo, los documentos, el token y los servicios).
  • Licencia sin servidor de licencias, por cantidad de firmas, por tiempo o combinada, con el saldo siempre a la vista.
  • Ubicación de la firma sobre el PDF real: elegís un documento del lote y ves dónde va la firma y el logo.
  • Verificación de revocación del certificado antes de firmar.
  • Detección automática del driver del token en Windows y Mac.
  • Registro de cada lote y detalle de tiempos por paso, útil para soporte.

Por qué Go

La versión anterior estaba hecha en Java e incluía su propio entorno Java dentro del instalador, lo que la hacía más pesada. Esta versión está escrita en Go, el lenguaje creado por Google para software de servidores e infraestructura. Lo elegimos por cuatro razones:

  • Un solo programa nativo por sistema. Se compila a un ejecutable propio para Windows, macOS y Linux. No requiere Java ni otro entorno, y abre al instante.
  • Concurrencia natural. Go maneja muchas tareas simultáneas con muy poco costo, y eso es lo que hace que un lote grande termine en minutos y no en horas.
  • Criptografía de base sólida. Trae de fábrica una biblioteca criptográfica mantenida por Google (certificados X.509, TLS, Ed25519), la misma que usan servicios críticos en todo el mundo.
  • Seguro y liviano. Maneja la memoria de forma segura, consume pocos recursos y facilita aplicar actualizaciones de seguridad.

La interfaz usa el visor web que ya trae cada sistema operativo (WebView2 en Windows, WebKit en Mac y Linux), así que el instalador es chico: entre 6 y 9 MB.


Antes de comenzar

Para firmar con CodeSign necesitás tener listo:

  • Un equipo compatible: Windows 10/11, Mac con chip Apple o Ubuntu 24.04+, de 64 bits (ver Requisitos).
  • La licencia de CodeSign, que te envía CODE100 a partir del código de tu equipo.
  • Tu certificado de firma: un token USB con certificado F2, o un archivo de certificado S1 (.p12/.pfx) con su contraseña.
  • El driver del token, si firmás con token.
  • Conexión a internet, para la hora confiable, el sello de tiempo y la verificación de revocación.
  • Los PDF a firmar en una carpeta, y otra carpeta vacía para los firmados.
i

Licencia y certificado no son lo mismo. La licencia la emite CODE100 y habilita a usar CodeSign en tu equipo. El certificado es tu identidad digital (o la de tu empresa), lo emite un prestador de servicios de confianza y es con lo que se firma cada documento. Necesitás los dos.

Requisitos del sistema

SistemaRequisitoInstalador
WindowsWindows 10 u 11, 64 bits. Usa WebView2, que viene con Windows 11 y con Windows 10 actualizado..msi
macOSMac con chip Apple (M1 o posterior), macOS 13 Ventura o posterior..dmg
LinuxUbuntu 24.04 o posterior (o una distribución basada en Debian equivalente), 64 bits..deb
ConexiónInternet para el sello de tiempo, la verificación de revocación y la hora confiable de la licencia.—
CertificadoToken USB con su driver instalado, o certificado S1 en archivo .p12/.pfx.—

Instalar CodeSign

Los instaladores se descargan desde la página de descargas, junto con su huella SHA-256 para comprobar que el archivo es el original.

Windows

  1. Abrí CodeSign-0.9.0.msi con doble clic y aceptá el permiso de administrador.
  2. CodeSign queda en el menú Inicio y en el escritorio.

Si Windows muestra «Windows protegió su PC», hacé clic en Más información y luego en Ejecutar de todas formas. Para instalaciones en varios equipos, el MSI admite instalación silenciosa: msiexec /i CodeSign-0.9.0.msi /qn.

macOS

  1. Abrí CodeSign-0.9.0.dmg y arrastrá CodeSign a la carpeta Aplicaciones.
  2. Abrilo desde Aplicaciones o Launchpad.

Si la primera vez aparece «No se puede abrir CodeSign», andá a Ajustes del Sistema → Privacidad y seguridad y tocá Abrir igualmente.

Linux (Ubuntu)

  1. Abrí CodeSign-0.9.0.deb con doble clic, o desde una terminal: sudo apt install ./CodeSign-0.9.0.deb
  2. CodeSign queda en el menú de aplicaciones. Las dependencias se instalan solas.

Actualizar y desinstalar

Para actualizar, instalá la versión nueva encima: la licencia y la configuración se conservan. Para desinstalar, usá Aplicaciones en Windows, arrastrá la app a la Papelera en Mac, o sudo apt remove codesign en Linux.

Migrar desde la versión anterior

Si usás CodeSign Legacy (la versión en Java), tené en cuenta que la licencia y la configuración de la versión anterior no se trasladan a esta versión:

  1. Instalá esta versión siguiendo Instalar CodeSign.
  2. Pedí una licencia nueva: copiá el código de tu equipo y envialo a CODE100 (ver Activar la licencia). El serial de la versión anterior no sirve.
  3. Volvé a configurar el driver del token, el sello de tiempo, la firma visible y el logo en Configuración.
  4. Hacé una prueba con pocos documentos antes de firmar un lote grande (ver Ejemplo: tu primera firma).

Tus certificados y tus documentos no cambian: se siguen usando los mismos.

Token y certificado

CodeSign firma con dos tipos de certificado: F2 en token USB y S1 en archivo.

  • Token USB (certificado F2): se usa con Conectar token y se desbloquea con el PIN.
  • Certificado en archivo .p12/.pfx (S1): se usa con Usar certificado S1 y se desbloquea con su contraseña.

Tokens probados: ePass2003, Longmai mToken CryptoID y Bit4id. Funciona con cualquier token que tenga driver PKCS#11.

SistemaDriver del token
WindowsInstalá el driver del fabricante. CodeSign lo detecta solo.
macOSInstalá el driver del fabricante. CodeSign lo detecta solo.
LinuxInstalá el driver del fabricante y elegí su archivo .so en Configuración → Driver. El servicio pcscd tiene que estar instalado.
!

Driver con permisos inseguros (Mac). Si el driver quedó instalado de forma que cualquier usuario del equipo pueda modificarlo, CodeSign no lo carga y muestra el comando para corregir los permisos. Pasa con algunos instaladores, por ejemplo el de Longmai.

El PIN y las contraseñas nunca se guardan ni se escriben en el registro.


Cómo funciona la licencia

La licencia de CodeSign se valida en tu propio equipo: no hay un servidor de licencias al que la aplicación tenga que llamar. Es un archivo firmado digitalmente por CODE100 y asociado a tu equipo. No se puede modificar ni pasar a otra computadora.

Que no haya servidor de licencias no significa que CodeSign funcione sin internet: para firmar necesita conexión (ver Saldo, avisos y hora).

Se contrata según cómo firmás:

ModalidadEjemplo
Por cantidadUn paquete de 5.000 firmas, sin vencimiento de uso.
Por tiempoUso sin límite de firmas durante un año.
Por períodoHasta 2.000 firmas por mes durante un año.
Combinada3 meses de vigencia y hasta 2.000 firmas en total.

Con cupo por período, CODE100 puede habilitar un adelanto: si se terminan las firmas del mes, podés usar parte de las del mes siguiente, con tu confirmación. Lo adelantado se descuenta del período siguiente.

Activar la licencia

  1. Copiar el código del equipo

    La primera vez que abrís CodeSign aparece la pantalla de licencia con el código de tu equipo (empieza con CSREQ1-). Tocá Copiar código.

  2. Enviarlo a CODE100

    Mandá el código por correo a tu contacto comercial o a contacto@code100.com.py. El código identifica el equipo y no contiene datos privados.

  3. Cargar la licencia

    CODE100 te responde con la licencia. Cargá el archivo .lic con Cargar archivo .lic, o pegá el texto de la licencia y tocá Activar licencia.

Para renovar o ampliar la licencia se hace lo mismo: enviás el código del equipo (desde el chip de licencia, arriba a la derecha) y cargás la licencia nueva.

Saldo, avisos y hora

La franja Uso de la licencia muestra siempre el cupo del período, el saldo total y la vigencia. Antes de firmar, CodeSign avisa si el lote no entra en el saldo disponible.

  • Avisa con 15 días de anticipación antes del vencimiento, y cuando queda poco saldo.
  • Al vencer o agotarse la licencia, la aplicación se bloquea hasta cargar una nueva.
  • Para controlar la vigencia, CodeSign consulta la hora en internet: no usa la hora del equipo, que se puede cambiar. Si no puede verificar la hora, no firma y avisa. Necesita salida a internet por NTP (puerto UDP 123) o HTTPS.

Flujo de firma masiva

  1. Conectar el certificado

    Conectar token (e ingresar el PIN) o Usar certificado S1 (e ingresar la contraseña). CodeSign valida la cadena del certificado hasta la autoridad raíz.

  2. Elegir las carpetas

    La carpeta de origen con los PDF y la de destino donde quedan los firmados, con el mismo nombre.

  3. Completar la firma

    Motivo y lugar de la firma. Opcionalmente, firma visible con texto y logo, y sello de tiempo.

  4. Firmar

    Firmar documentos procesa todo el lote en paralelo con progreso en vivo. Se puede detener en cualquier momento.

  5. Revisar el resultado

    Al terminar, el resumen muestra firmados y errores. Si se cortó, volvé a firmar con las mismas carpetas: CodeSign saltea lo que ya está firmado y sigue donde quedó.

Ejemplo: tu primera firma

Un recorrido completo con documentos de prueba, para hacerlo una vez antes de firmar lotes reales. El ejemplo usa Windows; en Mac y Linux es igual, cambian solo las rutas.

  1. Preparar las carpetas

    Creá C:\Firmas\pendientes y copiá ahí 3 PDF de prueba. Creá también C:\Firmas\firmados, vacía.

  2. Conectar el certificado

    Abrí CodeSign. Con token: conectalo, tocá Conectar token e ingresá el PIN. Con archivo S1: tocá Usar certificado S1, elegí el .pfx e ingresá su contraseña. CodeSign muestra el titular del certificado.

  3. Elegir las carpetas

    En Origen elegí C:\Firmas\pendientes y en Destino, C:\Firmas\firmados. CodeSign muestra cuántos PDF va a firmar (3).

  4. Completar la firma

    Escribí el Motivo (por ejemplo «Aprobación») y el Lugar («Asunción»). Si querés firma visible, activala y ubicala sobre uno de los PDF de prueba.

  5. Firmar

    Tocá Firmar documentos. La barra muestra el avance y, al terminar, el resumen muestra 3 documentos firmados y ninguno con error, y el saldo de la licencia baja en 3.

  6. Verificar

    Abrí un PDF de C:\Firmas\firmados en Adobe Acrobat Reader: el panel de firmas debe mostrar la firma válida, con tu nombre y la hora del sello de tiempo.

Firma visible

La firma visible agrega en la última página un recuadro con «Firmado digitalmente por:» y el nombre del titular, y opcionalmente el logo de tu organización.

  • El texto y el logo son dos recuadros independientes: se mueven y se estiran por separado.
  • Para ubicarlos, elegí un PDF del lote: se muestra su última página real y ves exactamente dónde va la firma.
  • El logo admite PNG, JPEG y BMP. Si tiene fondo blanco liso, CodeSign lo vuelve transparente para no tapar el contenido.

Sello de tiempo

El sello de tiempo lo emite una autoridad de sellado (TSA) y certifica el momento exacto de la firma, independiente de la hora del equipo. CodeSign usa el servicio de sellado de CODE100. Las credenciales se cargan en Configuración → TSA, donde también se puede desactivar el sello.

El servicio tiene un límite de sellos por período según el plan contratado. Si se alcanza el límite momentáneo, CodeSign espera, muestra la cuenta regresiva y sigue solo. Si se agota el plan, detiene el lote y lo informa.

Verificación de revocación

Antes de firmar, CodeSign comprueba que el certificado no esté revocado, consultando OCSP o la lista de revocación (CRL) que publica la autoridad certificadora. Las listas se guardan mientras siguen vigentes, así un lote grande no las descarga en cada documento.

Si el certificado está revocado, no firma. Si el certificado publica dónde verificarlo pero no hay forma de contactarlo (por ejemplo, sin internet), el lote se detiene: al volver la conexión, se retoma donde quedó.

Metadatos del PDF

Los metadatos son datos que CodeSign guarda dentro de cada PDF firmado, en sus propiedades. No se ven al leer el documento, pero los pueden leer las personas y los sistemas. Se usan para:

  • Buscar y clasificar: encontrar los documentos de un cliente, una sucursal o un expediente sin abrirlos uno por uno.
  • Integrar con otros sistemas: un gestor documental o un ERP puede leerlos para archivar cada documento en su lugar automáticamente.
  • Trazabilidad: queda registrado quién firmó y cuándo, útil para auditorías y controles.

Automáticos

Se agregan siempre, sin que el operador tenga que cargar nada. Salen del certificado con el que se firma:

PropiedadContenidoEjemplo
NombreFirmanteNombre del titular del certificadoJUAN PÉREZ
DocumentoFirmanteDocumento del titular (CI o RUC)CI1234567
FechaFirmaFecha y hora de la firma15/10/2026 10:30:00

Propios de tu organización

Podés sumar hasta tres campos propios, cada uno opcional:

  1. En Configuración → Metadato definís el nombre de cada campo una sola vez, por ejemplo Cliente, Sucursal o Expediente.
  2. En la pantalla principal aparece la sección Metadato con esos campos. Antes de cada lote cargás el valor, que se aplica a todos los documentos del lote.

Los campos sin nombre no se muestran ni se agregan.

Cómo verlos

En Adobe Acrobat Reader: Archivo → Propiedades → Personalizado. Los metadatos se agregan antes de firmar, así que forman parte del documento firmado y no afectan la validez de la firma.

Configuración

PestañaQué se configura
DriverDriver del token. En Windows y Mac muestra los detectados; en Linux se indica la ruta al archivo .so.
TSAServidor y credenciales del servicio de sellado de tiempo.
VerificarVerificación de revocación (CRL/OCSP) antes de firmar.
MetadatoNombres de hasta tres campos propios que se agregan al PDF.
Firma visibleTexto, logo, tamaño y posición del recuadro de firma.
RendimientoDocumentos en paralelo: automático (según el equipo) o de 1 a 16.
RegistroCarpeta del registro y nivel de detalle para diagnóstico.

Validar un documento firmado

Las firmas de CodeSign son estándar (PAdES baseline, ETSI): cualquiera puede verificarlas sin CodeSign. Abrí el PDF en Adobe Acrobat Reader y mirá el panel de firmas, o usá un validador de firma digital. Con sello de tiempo, el validador muestra además la hora certificada de la firma.

Registro para soporte

CodeSign guarda un registro por día con lo que hizo en cada lote: certificado usado, documentos firmados, errores y tiempos. Nunca registra el PIN ni contraseñas. Se conserva 30 días.

SistemaCarpeta del registro
Windows%LOCALAPPDATA%\codesign\logs
macOS~/Library/Caches/codesign/logs
Linux~/.cache/codesign/logs

También se abre desde Configuración → Registro → Abrir carpeta. Si tenés un problema, adjuntá el archivo del día al escribir a soporte.

Glosario

TérminoQué significa
Certificado F2Certificado de firma de persona física guardado en un token USB. Se desbloquea con un PIN y la clave nunca sale del token.
Certificado S1Certificado cualificado de sello electrónico de una empresa (persona jurídica), entregado como archivo .p12/.pfx con contraseña.
TokenDispositivo USB que guarda el certificado y su clave privada. Necesita el driver del fabricante instalado.
Driver PKCS#11Programa del fabricante del token que permite a CodeSign usarlo.
Licencia de CodeSignArchivo firmado por CODE100 que habilita el uso de CodeSign en un equipo. No es el certificado.
PAdESEstándar europeo (ETSI) de firma digital para PDF. Hace que la firma sea válida en Adobe Reader y en cualquier validador.
Sello de tiempo (TSA)Certifica la fecha y hora exactas de la firma. Lo emite una autoridad de sellado de tiempo (TSA), independiente del reloj del equipo.
Revocación (CRL/OCSP)Un certificado se revoca cuando deja de ser válido antes de vencer (por ejemplo, por pérdida del token). CodeSign lo consulta antes de firmar: OCSP es la consulta en línea; la CRL es la lista de certificados revocados.
MetadatosDatos guardados dentro del PDF firmado (firmante, fecha, campos propios) que sirven para buscar y clasificar documentos.
Código del equipoTexto que empieza con CSREQ1-. Identifica tu equipo para emitir la licencia y no contiene datos privados.

Preguntas frecuentes

¿Necesito instalar Java?

No. CodeSign es un programa nativo y no depende de Java.

¿Puedo usar la licencia en otra computadora?

No. La licencia queda asociada al equipo donde se generó el código. Para cambiar de equipo, pedí una licencia nueva con el código del equipo nuevo.

¿Qué pasa si se corta la luz o internet a mitad de un lote?

Volvé a firmar con las mismas carpetas: los documentos ya firmados se saltean y el lote sigue donde quedó.

¿Necesito internet para firmar?

Sí, para el sello de tiempo, la verificación de revocación y la hora confiable de la licencia. La licencia en sí no se valida contra ningún servidor.

¿Sirve mi licencia de la versión anterior?

No. Esta versión usa una licencia nueva, asociada al equipo. Ver Migrar desde la versión anterior.

¿Puedo seguir usando la versión anterior?

Sí. Su información sigue disponible en CodeSign Legacy.

¿Firma documentos que no son PDF?

No. CodeSign firma documentos PDF.

Historial de cambios

VersiónFechaCambios
0.9.015/10/2026
  • Primera versión de la reescritura de CodeSign en Go, para Windows, macOS y Linux.
  • Firma masiva en paralelo, firma PAdES con sello de tiempo y verificación de revocación.
  • Licencia sin servidor de licencias, asociada al equipo, por cantidad de firmas, por tiempo o combinada.
  • Firma visible con logo, ubicada sobre la última página real del documento, y metadatos automáticos y propios.
  • Detección automática del driver del token en Windows y macOS.

Soporte

Para instalación, licencias o soporte técnico, escribí a contacto@code100.com.py o comunicate con tu contacto comercial de CODE100. Para agilizar, incluí la versión (en Acerca de, tocando el logo), el sistema operativo y el registro del día.