Certificado Itau

---
title: Certificado Itau
slug: certificado-itau
sistema:
  - Teorema Pay
categoria: user_manual
tipo: how-to
autor: Pellison Leutner Cesar
setor: Qualidade
modulo: TeoremaPay
publico: "Equipe técnica responsável pela integração bancária com o Itaú"
keywords:
  - certificado
  - Itaú
  - OpenSSL
  - CSR
  - PFX
  - TeoremaPay
  - integração bancária
revisao: Andreia Burko Bley
aprovado_em: 06/2024
versao_pipeline: 2.5.2
chamado: ""
ultima_revisao: "2026-06-12"
---

## Visão Geral

Geração dos certificados digitais para integração bancária com o Itaú no TeoremaPay. O processo utiliza OpenSSL para criação do par de chaves e CSR (Certificate Signing Request), envio ao banco via Postman e geração do arquivo PFX (certificado A1).

## Procedimentos Iniciais

O processo exige OpenSSL versão 1.1.1 ou superior.

Para verificar se já há uma versão instalada, execute no Prompt de Comando:

```
openssl version
```

Se necessário, faça o download em: [https://www.openssl.org/source/](https://www.openssl.org/source/)

## Passo 1 — Gerar o CSR e a KEY

Execute o comando abaixo no Prompt de Comando (como Administrador):

```
openssl req -new -out nome_arquivo.csr -nodes -sha512 -newkey rsa:2048 -keyout nome_arquivo.key
```

Após executar o comando, o OpenSSL solicitará os dados para compor o Distinguished Name (DN) do certificado. Preencha conforme o modelo abaixo:

![Terminal OpenSSL solicitando campos do Distinguished Name: Country Name (BR), State or Province Name (sigla UF, ex.: PR), Locality Name (nome da cidade, ex.: GUARAPUAVA), Organization Name (nome da empresa, ex.: TEOREMA SISTEMAS), Organizational Unit Name (número do CNPJ, ex.: 01.234.567/0001-00), Common Name (Client ID Itaú, ex.: 123abc34-567d-8b9e-010f-f000a11b123c), Email Address (e-mail cadastrado no banco). Os campos "challenge password" e "optional company name" devem ser deixados em branco.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-01.png)

## Passo 2 — Verificar o Subject do CSR

Execute o comando abaixo para inspecionar o arquivo CSR gerado:

```
openssl req -in nome_arquivo.csr -noout -text
```

Confira o campo Subject. O resultado deve conter os dados preenchidos no passo anterior, conforme o exemplo destacado:

![Terminal OpenSSL exibindo Certificate Request com o campo Subject destacado: C=BR, ST=PR, L=GUARAPUAVA, O=TEOREMA SISTEMAS, OU=01.234.567/0001-00, CN=123abc34-567d-8b9e-010f-f000a11b123c. Exibe também algoritmo RSA 2048 bits e assinatura sha512WithRSAEncryption.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-02.png)

## Passo 3 — Enviar o CSR ao Itaú

O envio é realizado via Postman. Download disponível em: [https://www.postman.com/downloads/](https://www.postman.com/downloads/)

Crie uma requisição **POST** para o endpoint:

```
https://sts.itau.com.br/seguranca/v1/certificado/solicitacao
```

**Configurar Authorization:**

Na aba **Authorization**, selecione **Auth Type** como **Bearer Token** e cole no campo **Token** o token temporário recebido do Itaú:

![Postman — aba Authorization da requisição POST para https://sts.itau.com.br/seguranca/v1/certificado/solicitacao. Auth Type definido como Bearer Token; campo Token preenchido com o valor do token temporário do Itaú (exibido parcialmente).](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-03.png)

**Configurar Headers:**

Na aba **Headers**, verifique se o campo **Content-Type** está definido como **text/plain**. Corrija caso necessário:

![Postman — aba Headers com lista de cabeçalhos da requisição. O campo Content-Type está destacado com valor text/plain. Demais headers: Authorization (mascarado), Cookie, Cache-Control (no-cache), Postman-Token, Content-Length, Host, User-Agent (PostmanRuntime/7.39.0), Accept, Accept-Encoding, Connection.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-04.png)

**Configurar Body:**

Abra o arquivo CSR no Bloco de Notas, copie todo o conteúdo. Na aba **Body** do Postman, selecione a opção **raw** e cole o conteúdo copiado:

![Postman — aba Body com opção raw selecionada. O conteúdo exibe o bloco -----BEGIN CERTIFICATE REQUEST----- seguido do conteúdo codificado e -----END CERTIFICATE REQUEST-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-05.png)

## Passo 4 — Salvar a Secret Key e o Certificado Digital

Clique em **Send**. Se a configuração estiver correta, o banco retornará a Secret Key e, abaixo, o conteúdo do certificado CRT:

![Postman — aba Body da resposta com status 403 Forbidden. Na seção Raw da resposta exibe: secret: 1f09-... (truncado), -----BEGIN CERTIFICATE----- seguido de conteúdo codificado e -----END CERTIFICATE-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-06.png)

> ⚠️ **Atenção:** Salve a Secret Key imediatamente — ela não será exibida novamente.

Copie o conteúdo do certificado (bloco `-----BEGIN CERTIFICATE-----` até `-----END CERTIFICATE-----`), abra o Bloco de Notas, cole e salve com a extensão `.crt` (ex.: `nome_arquivo.crt`). Mantenha este arquivo na mesma pasta que o `nome_arquivo.key` gerado no Passo 1:

![Bloco de Notas exibindo o conteúdo do arquivo de certificado: -----BEGIN CERTIFICATE----- seguido de conteúdo codificado (MIIDp......) e -----END CERTIFICATE-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/certificado-itau/certificado-itau-07.png)

## Passo 5 — Gerar o Arquivo PFX (A1)

Com os arquivos `.crt` e `.key` na mesma pasta, execute o comando abaixo no Prompt de Comando (como Administrador):

```
openssl pkcs12 -export -out arquivo_nome.pfx -inkey arquivo_nome.key -in arquivo_nome.crt
```

> **Nota:** O OpenSSL solicitará uma senha (campo `password`) ao final da execução. Defina e guarde essa senha — ela será necessária para usar o certificado PFX no TeoremaPay.

## Informações do documento

> Autor: Pellison Leutner Cesar
> Setor: Qualidade
> Módulo: TeoremaPay
> Chamado:
> Versão do Sistema: 23.07a
> Versão do documento: 01
> Revisão: Andreia Burko Bley
> Aprovado em: 06/2024

---

> 📎 **Arquivos originais:** [Manual Certificado Itau .docx](https://drive.google.com/uc?export=download&id=1EaD0XH76vw3a7pnGbiRW6mhIG6URojCJ) · [Manual Certificado Itau .pdf](https://drive.google.com/uc?export=download&id=1Yf6l1Ix6jwDk4ouzXwY2H1joMqFKfOwc)