• Endereços oficiais do itaú:
  • URL de documentação sobre autenticação
  • URL de documentação sobre o certificado digital

Para efetuar a geração do token de autenticação e o certificado digital, deve-se realizar algumas configurações específicas, conforme detalhados abaixo:

Gostaríamos de explicar alguns conceitos importantes relacionados à segurança da sua conta e às etapas necessárias para garantir a integridade dos seus dados.

A chave privada é criada por você através de um comando específico no console. Essa chave é essencial para gerar a chave pública, que por sua vez é derivada da chave privada através de um comando no console. A chave pública é utilizada para solicitar a client-id e um Token de API provisório.

Além disso, o arquivo .csr é gerado por você para solicitar o certificado digital assinado. Esse certificado é criado pelo Banco Itaú após a sua solicitação através de uma requisição específica. Ele é fundamental para autenticar a sua identidade digital.

O Token de API, por sua vez, é gerado pelo Banco Itaú para autorizar a solicitação do certificado digital assinado. E, por fim, o client-id é um identificador único do cliente, enquanto o client-secret é uma chave secreta associada ao client-id, ambos utilizados para consumir os serviços de API de forma segura.

Esses são os principais elementos envolvidos no processo de segurança e autenticação da sua conta. Caso tenha alguma dúvida ou precise de assistência adicional, não hesite em entrar em contato com nossa equipe da Edusoft.

• Entrar em contato com o Itaú e solicitar acesso ao serviço API DE COBRANÇA v2
• Você receberá um e-mail com um passo-a-passo para gerar chave privada e pública
• Gerar a chave privada e pública
  • Para criação da chave pública SSH, deverá utilizar o GIT BASH ou até mesmo o OpenSSL nesta versão: (openssl-1.1.1n.tar.gz) download após baixar o arquivo seguir com a instalação padrão Next, Next e Finish.
  • Após instalado o OpenSSL executar no console a sequência dos comandos abaixo
  • Criar uma chave privada

    •  openssl genpkey -out ITAU_CHAVE_PRIVADA.pem -algorithm RSA -pkeyopt rsa_keygen_bits:2048 

    • Variável
      • ITAU_CHAVE_PRIVADA = nome da chave criada
    • Comando compatível com Windows e Linux
  • Criar a chave pública

    •  openssl rsa -in ITAU_CHAVE_PRIVADA.pem -pubout -out ITAU_CHAVE_PUBLICA.pem 

    • Variáveis
      • ITAU_CHAVE_PRIVADA: nome da chave privada criada
      • ITAU_CHAVE_PUBLICA: nome da chave pública a ser criada
    • Comando compatível com Windows e Linux

• Guardar ambas as chaves em locais seguros
• Responder o e-mail recebido cima com a chave pública anexada
• Você receberá um e-mail com as credenciais client-id e um token de api temporário com validade de 7 dias corridos
• Gerar solicitação de certificado
  • Comando compatível com Windows
  • Copie o comando abaixo, insira suas credenciais decifradas e o execute em seu terminal.

    • openssl req -new -subj "//CN={{CLIENT_ID}}\OU={{SITE OU APP DO PARCEIRO}}\L={{CIDADE}}\ST={{ESTADO}}\C={{PAIS}}" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key

    • Exemplo de como deve ficar o comando a ser executado:

    •  openssl req -new -subj "//CN=56a29ee3-60fe-47f8-95d9-7538b80ccf04\OU=ABC LTDA\L=SAO PAULO\ST=SP\C=BR" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key 

  • Comando compatível com Linux
  • Copie o comando abaixo, insira suas credenciais decifradas e o execute em seu terminal.

    • openssl req -new -subj "/CN={{CLIENT_ID}}/OU={{SITE OU APP DO PARCEIRO}}/L={{CIDADE}}/ST={{ESTADO}}/C={{PAIS}}" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key

    • Exemplo de como deve ficar o comando a ser executado:

    •  openssl req -new -subj "/CN=56a29ee3-60fe-47f8-95d9-7538b80ccf04OU ABC LTDA L=SAO PAULOST=SP/C=BR" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 - newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key 

• Variáveis
  • CLIENT_ID: token client-id recebido no e-mail conforme passos anteriores.
  • SITE OU APP DO PARCEIRO: Nesse campo poderá incluir o nome da empresa ou app que usa. (Exemplo: mentorweb.cliente.com.br)
  • CIDADE = Evitar acentos Ex: Sao Paulo
  • ESTADO Ex: SP
  • ARQUIVO_REQUEST_CERTIFICADO.csr, pode mudar o nome deixando mas manter a extensão .csr
  • ARQUIVO_CHAVE_PRIVADA_CERTIFICADO.key, pode mudar o nome deixando mas manter a extensão .key
• Será criado os arquivos .csr e .key
• Solicitar certificado assinado e client-secret
• Pelo postman ou pelo console, deverá efetuar a solicitação ao Itau o certificado digital assinado
• Requisição
  • POST: https://sts.itau.com.br/seguranca/v1/certificado/solicitacao
  • Authorization: Bearer token
    • Utilizar o token de api recebido via e-mail
  • Header: Content-Type: text/plain
  • Body: Texto do arquivo de solicitação de certificado .csr
• Resposta da requisição
  • Texto com client-secret e o certificado assinado
  • Armazenar o texto Secret: em um local seguro
  • Salvar o certificado após a chave Secret: criando um arquivo .crt
    • Isso pode ser feito através do bloco de notas, colando o conteúdo e salvando o arquivo

    •  **.crt**, desde **-----BEGIN CERTIFICATE-----** até **-----END CERTIFICATE-----** 

    • Tente instalar o certificado para verificar se o mesmo está válido
• Converter certificado para formato pfx (este formato é utilizado pelo MentorWeb)
• Comando compatível com Windows

  • Winpty openssl pkcs12 -export -out NOME_ARQUIVO_CERTIFICADO.pfx -inkey ARQUIVO_CHAVE_PRIVADA_CERTIFICADO.key -in CERTIFICADO_ASSINADO.crt -passout pass:SENHA

• Comando compatível com Linux

  • openssl pkcs12 -export -out NOME_ARQUIVO_CERTIFICADO.pfx -inkey ARQUIVO_CHAVE_PRIVADA_CERTIFICADO.key -in CERTIFICADO_ASSINADO.crt -passout pass:SENHA

• Variáveis
  • NOME_ARQUIVO_CERTIFICADO: Nome do novo certificado gerado no formato pfx
  • ARQUIVO_CHAVE_PRIVADA_CERTIFICADO: Chave da solicitação do certificado gerado na etapa acima.
  • CERTIFICADO_ASSINADO: Certificado assinado gerado na etapa acima.
  • SENHA: Senha que será utilizado para abrir o arquivo .pfx

• Para os clientes que utilizam o registro online. após ter o certificado gerado, é necessário cadastrar as chaves na conta bancária, e o certificado gerado no cadastro do beneficiário, para saber como cadastrar, clique aqui.