SIBEL — Manual de Usuario

Exportado a HTML • 2025-09-29 02:51 UTC

Firma electrónica XAdES-BES (detached) en contenedor ASiC-E — Operación 100% offline

Edición v1.0 • Generado: 2025-09-20 19:09 UTC

1. Resumen ejecutivo

SIBEL es una aplicación portátil y 100% offline para firmar documentos PDF utilizando XAdES-BES (detached) dentro de contenedores ASiC-E.

Soporta firma inicial y cofirma (múltiples firmantes). Genera un PDF representativo y adjunta el contenedor .asice al PDF resultante.

No requiere conexión a Internet ni servicios de terceros para firmar. Las validaciones de confianza (cadena de certificados) pueden requerir anclas de confianza externas.

2. Alcance y público

Dirigido a usuarios finales que necesitan firmar documentos PDF con estándares europeos (ETSI) en entornos desconectados.

No se requieren conocimientos técnicos de criptografía; sí nociones básicas de manejo de archivos.

3. Requisitos del sistema

Windows 10/11 (x64) con .NET Framework 4.8 instalado.

Permisos para leer/escribir en las carpetas donde residan PDFs y donde se guarde la salida.

Certificado del firmante en formato .cer y clave privada en .key (PEM), más su contraseña.

4. Conceptos clave (en sencillo)

ASiC-E: es un archivo .asice (ZIP con reglas) que empaqueta el PDF y su firma.

XAdES-BES (detached): la firma es XML (signatures.xml) y ‘apunta’ al PDF por su nombre, sin incrustarlo dentro del XML.

Referencia Directa al PDF: el XML contiene un enlace (URI) al PDF en el contenedor y un hash SHA-256 para garantizar integridad.

PDF representativo: un PDF ‘portada’ que incorpora como adjunto el .asice para compartir todo en un solo archivo.

5. Instalación/Actualización

SIBEL es portable; basta con descomprimir el paquete en una carpeta con permisos de lectura/escritura.

Para actualizar, cierre SIBEL y reemplace los archivos con la nueva versión. No se instalan controladores ni servicios.

6. Flujo rápido (TL;DR)

1) Abra SIBEL.

2) Seleccione el PDF a firmar.

3) Cargue su .cer, su .key y escriba la contraseña.

4) (Opcional) Active “Múltiples firmas” si desea cofirmar un ASiC-E existente.

5) Pulse “Firmar”.

6) Revise la salida: .asice, PDF representativo y log de auditoría.

7. Pantalla principal

Selección de PDF: botón para elegir el documento a firmar.

Certificado (.cer): selección del certificado público.

Clave privada (.key) + contraseña: datos para firmar.

Múltiples firmas: si está habilitado, permite elegir un ASiC-E existente para agregar una cofirma.

Firmar: inicia el proceso.

Indicadores de salida: muestra rutas de .asice, PDF representativo y log.

8. Firma inicial (crear nuevo ASiC-E)

Tras cargar PDF, .cer y .key, pulse “Firmar”.

SIBEL calculará el resumen (SHA-256) del PDF y construirá el XML de firma con referencia directa al nombre del PDF.

Se crea el contenedor .asice con:

• mimetype (sin compresión, primera entrada).

• el PDF (en la raíz).

• META-INF/signatures0.xml (UTF-8 sin BOM) con la firma XAdES-BES.

Finalmente se genera el PDF representativo y se adjunta el .asice como adjunto embebido.

9. Cofirma (agregar firmantes a un ASiC-E existente)

Marque “Múltiples firmas”.

Elija el ASiC-E a cofirmar (la aplicación selecciona automáticamente la última versión de la ‘familia’).

Cargue su .cer y .key, introduzca la contraseña y confirme.

SIBEL agregará una nueva ds:Signature al signatures0.xml y guardará una nueva versión del contenedor (sufijos _cofirmado, _cofirmado_2, …).

10. Archivos resultantes

Archivo .asice: contenedor ASiC-E con el PDF y la firma XAdES-BES.

PDF representativo: PDF con el .asice adjunto para compartir en un único archivo.

audit.log: registro básico del proceso (huellas, rutas de salida, eventos).

11. Validación externa (opcional)

Puede validar en el DSS Demonstration WebApp (Comisión Europea).

Notas:

• Si aparece ‘NO_CERTIFICATE_CHAIN_FOUND’ u otro aviso de confianza, significa que el validador no tiene instalada la cadena de su Autoridad de Certificación (p. ej. cadena SAT).

• Esto no invalida la firma criptográfica; únicamente afecta el veredicto “de confianza”.

• Si instala los certificados raíz/intermedios en el validador, el aviso suele desaparecer.

12. Buenas prácticas

Conserve el .asice original junto con el PDF representativo.

Evite renombrar archivos internos del .asice.

Use nombres de PDF sin caracteres exóticos o déjelos tal cual, SIBEL se encarga del percent-encoding necesario.

Mantenga su .key y su contraseña en un medio seguro.

13. Solución de problemas

“Se ha especificado un tipo de proveedor no válido”: la clave privada no es compatible con el CSP; cargue .cer/.key en formato PEM como lo hace SIBEL.

“Referencia de datos firmados no encontrada”: el PDF interno no coincide con la URI del Reference; evite renombrar el PDF dentro del .asice.

“No se puede encontrar el emisor de este certificado”: falta instalar la cadena de confianza de su AC en el sistema/validador.

14. Preguntas frecuentes (FAQ)

¿Necesito Internet para firmar? No. SIBEL firma 100% offline.

¿Puedo cofirmar? Sí, agregando más firmas al mismo contenedor.

¿Por qué algunos validadores muestran advertencias? Les falta la cadena de confianza de su AC.

¿Qué estándar usa? XAdES-BES (detached) en ASiC-E (ETSI).

15. Privacidad y seguridad

Sus claves privadas nunca salen de su equipo.

Los archivos no se envían a servidores externos.

La contraseña se usa solo en memoria para abrir la clave privada.

16. Licencia y soporte

Línea de tiempo de vigencia de la licencia — La vigencia corre desde la **emisión** hasta la **expiración**. La fecha de primer uso no modifica el periodo contratado.

SIBEL funciona con licencias de tiempo determinado.

La **fecha de inicio de la vigencia** corresponde a la **fecha de emisión del archivo. lic**, y no a la fecha en que el usuario utilice por primera vez el programa. Esto significa que, si se adquiere una licencia de 30 días emitida el 1 de julio, la misma expirará el 31 de julio, incluso si el usuario comienza a usar la aplicación días después.

**Ejemplo práctico:**

- Licencia emitida: 1 de julio de 2025

- Duración: 30 días

- Expiración: 31 de julio de 2025

- Si el usuario comienza a usar SIBEL el 5 de julio, tendrá 26 días de uso efectivo.

Este modelo garantiza uniformidad en un entorno portable y completamente offline, donde no existen activaciones en línea por primer uso.

17. Anexos

Glosario:

• XAdES-BES: Perfil básico de firma XML (ETSI).

• ASiC-E: Contenedor ZIP con reglas y firma asociada.

• SHA-256: Algoritmo estándar de hash.

• Representativo: PDF con adjunto del .asice.