A API do Validador de Assinaturas Digitais fornece endpoints para validar assinaturas eletrônicas em documentos. Ela suporta tanto a validação de Assinaturas Eletrônicas Qualificadas (QES) quanto de Assinaturas Eletrônicas Avançadas (AdES) sob padrões como o eIDAS. O processo de validação garante a autenticidade, conformidade e validade jurídica das assinaturas.
Em um modelo simplificado, validar uma assinatura digital envolve duas etapas principais:
Validação Criptográfica: Garantir a integridade criptográfica da assinatura digital, descriptografando seu valor e comparando o resultado com o hash dos dados assinados.
Validação do Certificado: Confirmar a validade do certificado de assinatura, que inclui a realização da validação do caminho de certificação.
Este endpoint valida Assinaturas Eletrônicas Qualificadas (QES) em um documento para garantir sua autenticidade,
conformidade e validade legal sob regulamentos como o eIDAS. O processo de validação inclui:
1. Extração da Assinatura: Identifica e extrai a assinatura e seus metadados associados do documento.
2. Verificação de Integridade Criptográfica: Garante que os mecanismos criptográficos da assinatura (por exemplo, hash, criptografia) sejam válidos e não alterados.
3. Validação da Qualificação do Certificado:
- Confirma que o certificado utilizado para criar a assinatura é um Certificado Qualificado para Assinaturas Eletrônicas (QC).
- Verifica a validade do certificado, incluindo expiração, status de revogação (via CRL e OCSP) e conformidade com CAs raiz confiáveis.
- Verifica o status de qualificação do certificado usando extensões e identificadores definidos em normas como ETSI EN 319 412.
- Garante que a Autoridade Certificadora (CA) emissora esteja em uma lista oficialmente confiável (por exemplo, Lista de Confiabilidade da UE).
4. Verificação de Conformidade Regulatória: Verifica se a assinatura cumpre todos os requisitos legais e técnicos para QES conforme o eIDAS.
O método suporta validação de assinatura para os seguintes formatos de documento: PDF, XML.
Validação de Assinatura Eletrônica Qualificada - Recursos do endpoint
| Objeto | Descrição |
|---|---|
Corpo da requisição |
[Obrigatório] Arquivo binário |
{
"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"'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
A API confirma que o certificado utilizado na assinatura é um Certificado Qualificado (QC) por: 1. Verificando sua conformidade com os padrões ETSI EN 319 412 2. Verificando seu status de revogação utilizando Listas de Revogação de Certificados (CRL) e Protocolo de Status de Certificado Online (OCSP) 3. Garantindo que a CA emissora seja reconhecida na Lista de Confiáveis da UE
Uma Assinatura Eletrônica Qualificada (AEQ) é o mais alto nível de assinatura eletrônica sob regulamentos como o eIDAS Ela fornece equivalência legal às assinaturas manuscritas A validação garante que a assinatura é autêntica legalmente compatível e não foi adulterada
A API atualmente suporta a validação de assinaturas QES em formatos de documentos PDF e XML
Sim a API garante que assinaturas validadas atendam a todos os requisitos legais e técnicos definidos sob eIDAS e outros padrões relevantes de assinatura eletrônica Isso a torna adequada para uso em transações digitais juridicamente vinculativas
A API segue um processo de múltiplas etapas para validar QES, incluindo 1. Extraindo a assinatura e os metadados do documento 2. Realizando uma verificação de integridade criptográfica para garantir que a assinatura não foi alterada 3. Validando o certificado, verificando a expiração, o status de revogação e a conformidade com listas oficiais de confiança (por exemplo, Lista de Confiança da UE) 4. Garantindo que a assinatura atenda aos requisitos legais e técnicos do eIDAS
O endpoint retorna uma resposta JSON contendo detalhes sobre o documento incluindo o número total de assinaturas assinaturas válidas e informações específicas para cada assinatura como status de validação detalhes do signatário e informações sobre o certificado
Os campos principais incluem `documentName`, `summary` (com `totalSignatures` e `validSignatures`), e um array de `signatures` contendo detalhes como `signatureId`, `indication`, `signer` e `signingCertificate`
A resposta é estruturada em um formato hierárquico começando com informações em nível de documento seguida por um resumo de assinaturas e resultados de validação detalhados para cada assinatura em um formato de array
Os usuários podem personalizar suas solicitações fornecendo parâmetros como o formato do documento (PDF ou XML) e os dados da assinatura a serem validados garantindo que a API processe as informações corretas
O ponto final fornece informações sobre a validade das assinaturas detalhes sobre o certificado de assinatura tempo de validação tempo de assinatura e quaisquer erros ou avisos encontrados durante o processo de validação
Os usuários podem analisar o `resumo` para avaliar a validade geral da assinatura e revisar `assinaturas` individuais para obter resultados de validação detalhados, incluindo quaisquer erros ou avisos, para garantir conformidade e autenticidade
A API realiza múltiplas verificações, incluindo verificação de integridade criptográfica, validação de certificados contra listas confiáveis e conformidade com os padrões eIDAS, garantindo alta precisão e confiabilidade dos dados
Os casos de uso típicos incluem validar contratos eletrônicos garantir a conformidade em documentos legais e verificar assinaturas em transações financeiras onde a autenticidade e a validade legal são cruciais
Nível de serviço:
100%
Tempo de resposta:
618ms
Nível de serviço:
100%
Tempo de resposta:
120ms
Nível de serviço:
88%
Tempo de resposta:
650ms
Nível de serviço:
100%
Tempo de resposta:
605ms
Nível de serviço:
100%
Tempo de resposta:
86ms
Nível de serviço:
100%
Tempo de resposta:
254ms
Nível de serviço:
100%
Tempo de resposta:
577ms
Nível de serviço:
100%
Tempo de resposta:
106ms
Nível de serviço:
100%
Tempo de resposta:
1.120ms
Nível de serviço:
100%
Tempo de resposta:
592ms
Nível de serviço:
97%
Tempo de resposta:
2.966ms
Nível de serviço:
100%
Tempo de resposta:
1.409ms
Nível de serviço:
100%
Tempo de resposta:
1.779ms
Nível de serviço:
100%
Tempo de resposta:
3.147ms
Nível de serviço:
100%
Tempo de resposta:
235ms
Nível de serviço:
100%
Tempo de resposta:
484ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
3.531ms
Nível de serviço:
100%
Tempo de resposta:
4.363ms
Nível de serviço:
100%
Tempo de resposta:
0ms