Configurações do Certificado Digital no Banco Itaú

Configurações do Certificado Digital no Banco Itaú

Objetivo do Processo

Este procedimento tem como finalidade orientar a criação dos arquivos .KEY e .CRT utilizados na API, que deverão ser posteriormente importados no APP Ceasa.

 

Abertura de Chamado no Itaú

Antes de iniciar o processo, é necessário manter contato com o cliente responsável pelo acompanhamento do projeto e solicitar que abra um chamado junto ao Itaú para uma aplicação de “Bolecode“ (boleto com QRCode) para o CNPJ a ser homologado.

Tendo aberto o chamado o banco deve fornecer:

  • Código Client ID

  • Código Token

  • Arquivo Collection

Caso algum desses dados não seja enviado, é necessário manter contato com o banco e solicitar que os envie, pois são indispensáveis para o processo.

 

Geração dos Arquivos .CSR e .KEY

Tendo o código Cliente ID em mãos, siga os seguintes passos para criar os arquivos .CSR (arquivo temporário) e .KEY:

  • Crie uma pasta chamada “OpenSSL” dentro do seu disco principal e extraia o arquivo abaixo:

  • Abra o CMD como administrador.

  • Utilize o comando: cd C:\OpenSSL

  • Utilize o comando: openssl

  • Utilizar o comando a baixo da seguinte maneira:

    • req -new -subj "/CN=a6827b6e-6b4e-451e-934b-6575a5a43f76/OU=NUVALLE/L=BRASILIA/ST=DISTRITO FEDEREAL/C=BR" -out Nuvalle.csr -nodes -sha512 -newkey rsa:2048 -keyout Nuvalle.key

    • Cor: trocar para o Client ID do cliente

    • Cor: trocar para o nome do cliente

    • Cor: trocar para a cidade do cliente

    • Cor: trocar para o estado do cliente

  • Tendo feito este processo corretamente, os arquivos .KEY e .CSR serão criados dentro da pasta cd C:\OpenSSL. Caso os arquivos não sejam criados ou dê algum erro no CMD, revise o processo.

 

Geração do Cliente Secret e arquivo .CRT

Tendo feito o processo anterior corretamente e possuindo o arquivo .CST, arquivo Collection e código Token em mãos, será necessário instalar o Postman para dar continuidade ao processo. Baixe a última versão diretamente no site a seguir: Download Postman.

Com o Postman instalado e aberto, clique em “Import” e selecione o arquivo Collection, conforme imagem abaixo:

image-20250625-113439.png

Tendo importado o arquivo Collection, selecione a pasta “Envio de CSR Atualizar CRT” e clique em “Envio de arquivo CSR“, conforme imagem abaixo:

image-20250625-113631.png

Tendo acessado a opção “Envio de arquivo CSR”, navegue até a guia Body, conforme imagem com dados exemplos abaixo:

image-20250625-113819.png

Abra o arquivo .CSR que você gerou e copie os dados para a guia “Body” acessada no passo anterior. Tendo feito este processo, navegue novamente até a guia “Authorization“, conforme imagem abaixo:

image-20250625-114059.png

Tendo acessado a guia “Authorization”, preencha o campo abaixo com o código Token e pressione em opção “Enviar”:

image-20250625-120228.png

Tendo feito os passos anteriores corretamente, serão exibidos os seguintes dados em tela:

image-20250625-120528.png

O dado da imagem anterior de cor azul é o código Client Secret, cujo deve ser salvo em um bloco de notas juntamente com o Client ID.

Os dados da imagem anterior de cor vermelha são os dados do arquivo CRT, onde deve ser salvo com a extensão .CRT e salvo junto com o arquivo .KEY.

 

Tendo concluído este processo corretamente, os dados abaixo devem estar disponíveis:

  • Arquivo .CRT

  • Arquivo .KEY

  • Código Client ID

  • Código Client Secret

Tendo eles em mãos, o processo está concluído.