La API del Validador de Firmas Digitales proporciona puntos finales para validar firmas electrónicas en documentos. Soporta tanto la validación de Firmas Electrónicas Cualificadas (QES) como de Firmas Electrónicas Avanzadas (AdES) bajo estándares como eIDAS. El proceso de validación garantiza la autenticidad, el cumplimiento y la validez legal de las firmas.
En un modelo simplificado, validar una firma digital implica dos pasos principales:
Validación Criptográfica: Asegurar la integridad criptográfica de la firma digital al descifrar su valor y comparar el resultado con el hash de los datos firmados.
Validación de Certificado: Confirmar la validez del certificado de firma, lo que incluye realizar la validación de la ruta de certificación.
Este punto final valida las Firmas Electrónicas Cualificadas (QES) en un documento para garantizar su autenticidad,
cumplimiento y validez legal bajo regulaciones como eIDAS. El proceso de validación incluye:
1. Extracción de la Firma: Identifica y extrae la firma y sus metadatos asociados del documento.
2. Verificación de la Integridad Criptográfica: Asegura que los mecanismos criptográficos de la firma (por ejemplo, hash, cifrado) son válidos y no han sido alterados.
3. Validación de la Cualificación del Certificado:
- Confirma que el certificado utilizado para crear la firma es un Certificado Cualificado para Firmas Electrónicas (QC).
- Verifica la validez del certificado, incluyendo la expiración, el estado de revocación (a través de CRL y OCSP) y el cumplimiento con autoridades de certificación raíz de confianza.
- Verifica el estado de cualificación del certificado utilizando extensiones e identificadores definidos en normas como ETSI EN 319 412.
- Asegura que la Autoridad de Certificación (CA) emisora está en una lista de confianza oficialmente reconocida (por ejemplo, Lista de Confianza de la UE).
4. Verificación de Cumplimiento Regulatorio: Verifica que la firma cumple con todos los requisitos legales y técnicos para QES según eIDAS.
El método admite la validación de firmas para los siguientes formatos de documento: PDF, XML.
Validación de Firma Electrónica Cualificada - Características del Endpoint
| Objeto | Descripción |
|---|---|
Cuerpo de la Solicitud |
[Requerido] Archivo Binario |
{
"documentName": "string",
"summary": {
"totalSignatures": 1073741824,
"validSignatures": 1073741824
},
"signatures": [
{
"signatureId": "string",
"indication": "string",
"indicationDetails": "string",
"signer": "string",
"validationTime": "2025-02-08T20:59:59.039Z",
"signingTime": "2025-02-08T20:59:59.039Z",
"signingCertificate": {
"subject": "string",
"issuer": "string",
"serialNumber": "string",
"validFrom": "2025-02-08T20:59:59.039Z",
"validTo": "2025-02-08T20:59:59.039Z"
},
"certificateChain": [
{
"subject": "string",
"issuer": "string",
"serialNumber": "string",
"validFrom": "2025-02-08T20:59:59.039Z",
"validTo": "2025-02-08T20:59:59.039Z"
}
],
"signatureDetails": {
"errors": [
"string"
],
"warns": [
"string"
],
"infos": [
"string"
]
}
}
]
}
curl --location 'https://zylalabs.com/api/6122/digital+signature+verification+api/8389/qualified+electronic+signature+validation' \
--header 'Content-Type: application/json' \
--form 'image=@"FILE_PATH"'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
La API confirma que el certificado utilizado en la firma es un Certificado Calificado (QC) mediante: 1. Verificar su conformidad con las normas ETSI EN 319 412. 2. Verificar su estado de revocación utilizando Listas de Revocación de Certificados (CRL) y Protocolo de Estado de Certificado en Línea (OCSP). 3. Asegurarse de que la CA emisora esté reconocida en la Lista de Confianza de la UE.
Una Firma Electrónica Cualificada (QES) es el nivel más alto de firma electrónica bajo regulaciones como eIDAS. Proporciona equivalencia legal a las firmas manuscritas. La validación asegura que la firma es auténtica, cumple con la legalidad y no ha sido alterada.
La API actualmente soporta la validación de firmas QES en formatos de documentos PDF y XML.
Sí, la API garantiza que las firmas validadas cumplen con todos los requisitos legales y técnicos definidos bajo eIDAS y otros estándares relevantes de firma electrónica. Esto lo hace adecuado para su uso en transacciones digitales con validez legal.
La API sigue un proceso de múltiples pasos para validar QES, que incluye: 1. Extraer la firma y los metadatos del documento. 2. Realizar una verificación de integridad criptográfica para asegurarse de que la firma no esté alterada. 3. Validar el certificado, comprobar la expiración, el estado de revocación y la conformidad con las listas oficiales de confianza (por ejemplo, la Lista de Confianza de la UE). 4. Asegurarse de que la firma cumpla con los requisitos legales y técnicos de eIDAS.
El punto final devuelve una respuesta JSON que contiene detalles sobre el documento, incluyendo el número total de firmas, firmas válidas y información específica para cada firma, como el estado de validación, detalles del firmante e información del certificado.
Los campos clave incluyen `documentName`, `summary` (con `totalSignatures` y `validSignatures`), y un arreglo de `signatures` que contiene detalles como `signatureId`, `indication`, `signer` y `signingCertificate`.
La respuesta está estructurada en un formato jerárquico, comenzando con información a nivel de documento, seguido de un resumen de firmas y resultados de validación detallados para cada firma en un formato de matriz.
Los usuarios pueden personalizar sus solicitudes proporcionando parámetros como el formato del documento (PDF o XML) y los datos de la firma que se deben validar, asegurando que la API procese la información correcta.
El punto final proporciona información sobre la validez de las firmas, detalles sobre el certificado de firma, el tiempo de validación, el tiempo de firma y cualquier error o advertencia encontrados durante el proceso de validación.
Los usuarios pueden analizar el `resumen` para evaluar la validez general de la firma y revisar las `firmas` individuales para obtener resultados de validación detallados, incluidos errores o advertencias, para garantizar el cumplimiento y la autenticidad.
La API realiza múltiples verificaciones, incluida la verificación de integridad criptográfica, la validación de certificados contra listas de confianza y el cumplimiento de los estándares eIDAS, asegurando una alta precisión y confiabilidad de los datos.
Los casos de uso típicos incluyen la validación de contratos electrónicos, asegurando el cumplimiento en documentos legales y verificando firmas en transacciones financieras, donde la autenticidad y la validez legal son cruciales.
Nivel de Servicio:
100%
Tiempo de Respuesta:
493ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
577ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
605ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
120ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
37ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.865ms
Nivel de Servicio:
88%
Tiempo de Respuesta:
650ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
681ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.120ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
441ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
166ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
865ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
4.553ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
296ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.249ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
40ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
44ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
751ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.060ms