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
Plataformas
Licencia
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.
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
| Sistema | Requisito | Instalador |
|---|---|---|
| Windows | Windows 10 u 11, 64 bits. Usa WebView2, que viene con Windows 11 y con Windows 10 actualizado. | .msi |
| macOS | Mac con chip Apple (M1 o posterior), macOS 13 Ventura o posterior. | .dmg |
| Linux | Ubuntu 24.04 o posterior (o una distribución basada en Debian equivalente), 64 bits. | .deb |
| Conexión | Internet para el sello de tiempo, la verificación de revocación y la hora confiable de la licencia. | — |
| Certificado | Token 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
- Abrí
CodeSign-0.9.6.msicon doble clic y aceptá el permiso de administrador. - 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.6.msi /qn.
macOS
- Abrí
CodeSign-0.9.6.dmgy arrastrá CodeSign a la carpeta Aplicaciones. - Abrilo desde Aplicaciones o Launchpad.
La aplicación está firmada por CODE100 S.A. y verificada por Apple, así que se abre sin advertencias.
Linux (Ubuntu)
- Abrí
CodeSign-0.9.6.debcon doble clic, o desde una terminal:sudo apt install ./CodeSign-0.9.6.deb - 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:
- Instalá esta versión siguiendo Instalar CodeSign.
- 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.
- Volvé a configurar el driver del token, el sello de tiempo, la firma visible y el logo en Configuración.
- 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.
| Sistema | Driver del token |
|---|---|
| Windows | Instalá el driver del fabricante. CodeSign lo detecta solo. |
| macOS | Instalá el driver del fabricante. CodeSign lo detecta solo. |
| Linux | Instalá 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:
| Modalidad | Ejemplo |
|---|---|
| Por cantidad | Un paquete de 5.000 firmas, sin vencimiento de uso. |
| Por tiempo | Uso sin límite de firmas durante un año. |
| Por período | Hasta 2.000 firmas por mes durante un año. |
| Combinada | 3 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
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.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.
Cargar la licencia
CODE100 te responde con la licencia. Cargá el archivo
.liccon 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
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.
Elegir las carpetas
La carpeta de origen con los PDF y la de destino donde quedan los firmados, con el mismo nombre.
Completar la firma
Motivo y lugar de la firma. Opcionalmente, firma visible con texto y logo, y sello de tiempo.
Firmar
Firmar documentos procesa todo el lote en paralelo con progreso en vivo. Se puede detener en cualquier momento.
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.
Preparar las carpetas
Creá
C:\Firmas\pendientesy copiá ahí 3 PDF de prueba. Creá tambiénC:\Firmas\firmados, vacía.Conectar el certificado
Abrí CodeSign. Con token: conectalo, tocá Conectar token e ingresá el PIN. Con archivo S1: tocá Usar certificado S1, elegí el
.pfxe ingresá su contraseña. CodeSign muestra el titular del certificado.Elegir las carpetas
En Origen elegí
C:\Firmas\pendientesy en Destino,C:\Firmas\firmados. CodeSign muestra cuántos PDF va a firmar (3).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.
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.
Verificar
Abrí un PDF de
C:\Firmas\firmadosen 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:
| Propiedad | Contenido | Ejemplo |
|---|---|---|
NombreFirmante | Nombre del titular del certificado | JUAN PÉREZ |
DocumentoFirmante | Documento del titular (CI o RUC) | CI1234567 |
FechaFirma | Fecha y hora de la firma | 15/10/2026 10:30:00 |
Propios de tu organización
Podés sumar hasta tres campos propios, cada uno opcional:
- En Configuración → Metadato definís el nombre de cada campo una sola vez, por ejemplo Cliente, Sucursal o Expediente.
- 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ña | Qué se configura |
|---|---|
| Driver | Driver del token. En Windows y Mac muestra los detectados; en Linux se indica la ruta al archivo .so. |
| TSA | Servidor y credenciales del servicio de sellado de tiempo. |
| Verificar | Verificación de revocación (CRL/OCSP) antes de firmar. |
| Hash | Algoritmo de hash de la firma: SHA-256 (por defecto) o SHA-512. SHA-512 se recomienda para documentos de archivo a largo plazo. |
| PAdES | Nivel de la firma: Estándar (B-T con sello de tiempo, B-B sin él), B-LT (validación a largo plazo: certificados y prueba de vigencia OCSP o CRL dentro del PDF) o B-LTA (además, un sello de tiempo de todo el documento). B-LT y B-LTA necesitan el sello de tiempo; B-LTA usa dos sellos por documento. |
| Metadato | Nombres de hasta tres campos propios que se agregan al PDF. |
| Firma visible | Texto, logo, tamaño y posición del recuadro de firma. |
| Rendimiento | Documentos en paralelo: automático (según el equipo) o de 1 a 16. |
| Registro | Carpeta 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.
| Sistema | Carpeta 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érmino | Qué significa |
|---|---|
| Certificado F2 | Certificado de firma de persona física guardado en un token USB. Se desbloquea con un PIN y la clave nunca sale del token. |
| Certificado S1 | Certificado cualificado de sello electrónico de una empresa (persona jurídica), entregado como archivo .p12/.pfx con contraseña. |
| Token | Dispositivo USB que guarda el certificado y su clave privada. Necesita el driver del fabricante instalado. |
| Driver PKCS#11 | Programa del fabricante del token que permite a CodeSign usarlo. |
| Licencia de CodeSign | Archivo firmado por CODE100 que habilita el uso de CodeSign en un equipo. No es el certificado. |
| PAdES | Está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. |
| Metadatos | Datos guardados dentro del PDF firmado (firmante, fecha, campos propios) que sirven para buscar y clasificar documentos. |
| Código del equipo | Texto 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ón | Fecha | Cambios |
|---|---|---|
| 0.9.6 | 30/10/2026 |
|
| 0.9.5 | 23/10/2026 |
|
| 0.9.4 | 23/10/2026 |
|
| 0.9.3 | 23/10/2026 |
|
| 0.9.2 | 22/10/2026 |
|
| 0.9.1 | 19/10/2026 |
|
| 0.9.0 | 15/10/2026 |
|
Documentación de versiones anteriores: versión 0.9.4, versión 0.9.3, versión 0.9.2, versión 0.9.1, versión 0.9.0.
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.