Cifragem XML/XADES
4 min
Criado por João Vitor Serpa do Nascimento em 14/10/2024 14:17
Atualizado por Roger Guisassola Carrara em 11/02/2025 14:14

Caso esteja testando a API de Assinatura Digital, a assinatura é feita em 3 partes: inicialização -> cifragem -> finalização.


Na inicialização, o conteúdo a ser assinado é preparado para a assinatura. O cabeçalho e o corpo da requisição devem seguir o formato do cURL no exemplo abaixo, copie o conteúdo e cole no seu Postman ou similares.


curl --location --globoff '{{url_hub}}/api/xml-signature-service/v2/signatures/initialize' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'nonce="1"' \
--form 'binaryContent
="false"' \
--form 'operationType="SIGNATURE"' \
--form 'profile="ADRC"' \
--form 'signatureFormat ="ENVELOPED"' \
--form 'hashAlgorithm="SHA256"' \
--form 'certificate=""' \
--form 'originalDocuments[0][nonce]="1"' \
--form 'originalDocuments[0][content]=@"/path/to/file"' \
--form 'returnType="LINK"' \
--form 'policyOid="2.16.76.1.7.1.6.2.4"'


Atenção! Verifique se a sua aplicação está cadastrada no ambiente de produção ou de homologação, a url_hub é diferente para cada ambiente, a saber:


Produção: https://hub2.bry.com.br

Homoloação: https://hub2.hom.bry.com.br

O valor a ser enviado no parâmetro "certificate" é a chave pública do seu certificado codificado em Base64. Você pode obter esse valor acessando a página de testes da extensão Bry aqui. O valor será aquele presente em Dados Certificado.



O retorno da inicialização deve ser no formato:


{
 "nonce": 1,
 "signedAttributes": [
 {
 "nonce": 2,
 "content": "string"
 }
 ],
 "initializedDocuments": [
 {
 "nonce": 2,
 "content": "string"
 }
 ]
}

Agora devemos cifrar o conteúdo retornado na inicialização. A cifragem é o que faz a assinatura digital ser assinatura digital. É nesse passo que, com a chave privada do certificado, assina-se o hash do documento através da extensão.

Copie o conteúdo presente em signedAttributes no retorno da inicialização, acesse a página de testes da extenção Bry aqui e cole no campo hashes do JSON de entrada. Clique em Gerar Assinatura. Copie o valor do campo hashes do JSON de saída e insira no parâmetro finalizations[n][signatureValue] na finalização. Além disso, copie também o conteúdo de initializedDocuments na inicialização e cole como valor do parâmetro finalizations[n][initializedDocument] na finalização.

Deixamos em anexo ao final deste artigo um GIF de exemplo do processo.

O cabeçalho e o corpo da finalização devem seguir o formato do cURL no exemplo a seguir:


curl --location --globoff '{{url_hub}}/api/xml-signature-service/v2/signatures/finalize' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'nonce="12312123123123"' \
--form 'binaryContent
="false"' \
--form 'operationType="SIGNATURE"' \
--form 'profile="ADRC"' \
--form 'signatureFormat ="ENVELOPED"' \
--form 'hashAlgorithm="SHA256"' \
--form 'certificate=""' \
--form 'finalizations[0][nonce]="1"' \
--form 'finalizations[0][content]=@"/path/to/file"' \
--form 'finalizations[0][signatureValue]=""' \
--form 'finalizations[0][initializedDocument]=""' \
--form 'returnType="LINK"' \
--form 'includeXPathEnveloped="false"' \
--form 'policyOid="2.16.76.1.7.1.6.2.4"'


Inclua o mesmo valor para o certificado na inicialização e na finalização, de modo geral, todos os parâmetros de mesmo nome na inicialização e finalização devem ter os mesmos valores. O certificado usado na cifragem deve ser o mesmo usado na inicialização e na finalização.

Se tudo der certo, você receberá um link de retorno com o documento assinado ou o conteúdo do mesmo em Base64, dependendo do valor que você configurou em returnType.


Anexos

Este artigo foi útil para você?
Últimos artigos visitados