HISTÓRICO
| Versão | Data da Publicação | Alterações |
|---|---|---|
| v1 | 27/01/2025 | - Versão inicial |
| v2 | 25/04/2026 | - Simplificação do processo para informar a chave pública do certificado digital ICP-Brasil, bastanto selecionar o certificado em tela e efetuar as autorizações necessárias. |
ÍNDICE
Introdução
Esse material descreve como os cartórios podem consultar os dados cadastrais da CCN por API, especificando como cadastrar os IPs e assinar as requisições.
Configuração da integração
Para consumir as APIs de exportação do CCN, o cartório deverá cadastrar os IPs onde serão executadas as APIs e subir a chave pública dos certificados digitais ICP-Brasil de quem irá consultar.
Acesse a área de Administração do sistema CCN. | Em seguida, clique no Menu Integração. |
Cadastramento dos IPs
Acesse o menu Integração e depois selecione a opção "Exportar" para informar os endereços IPs do cartório nos quais serão executadas as APIs.
Autenticação de chave pública
Será necessário subir a chave pública dos certificados digitais ICP-Brasil do tabelião e prepostos do cartório que consultarão os dados da CCN por meio da API.
A exportação de registros no CCN exige que a requisição seja assinada para garantir a segurança e identificação do requisitante. Portanto, o certificado de um usuário ativo na organização deve realizar a assinatura digital CAdES e enviar
no cabeçalho da requisição das rotas de exportação.
Selecione o certificado digital ICP-Brasil do(s) usuário(s) do cartório que irá assinar as requisições da API. Depois, clique em 'Autorizar'.
Assinar as requisições da API
Consulte a documentação anexa para entender como assinar as requisições das API com o certificado digital ICP-Brasil.
Obter certificados no formato .pem
Pré-requisitos
openssl - Obrigatório - Conjunto de ferramentas de criptografia
curl - Opcional - Ferramenta que possibilita fazer requisições pela linha de comando
- Windows: Para poder utilizar essas ferramentas no Windows, uma das maneiras é efetuar a instalação da ferramenta MSYS2
- Linux: Já estão instaladas
chave privada e certificado no formato PEM - Obrigatório
- Extrair a chave privada do arquivo PFX e salvar no formato PEM.
openssl pkcs12 -legacy -in certificado.pfx -nodes -out certificado.private.pem - Extrair o certificado do arquivo PFX e salvar no formato PEM.
openssl pkcs12 -legacy -in certificado.pfx -nokeys -out certificado.public.pem
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo