Itaú – Clientes e certificados

Cada cliente representa uma credencial do Portal do Desenvolvedor Itaú: client_id e token temporário de ativação. Com eles o sistema gera o CSR, solicita o certificado dinâmico e recebe o client_secret.

Endpoints
  • POST /itau/seguranca/v1/certificado/solicitacao – body text/plain com o CSR (CN = client_id); header Authorization: Bearer {token temporário}, ou um access_token na renovação.
  • POST /itau/api/oauth/token – application/x-www-form-urlencoded; mTLS desligado (ItauApi:RequireClientCertificate = false).

No Kestrel, as chamadas com mTLS usam a porta 44319. No IIS, o site precisa aceitar certificado de cliente.

Kit de teste (só no simulador): gera chave, CSR e certificado no servidor, sem openssl, e entrega o PFX. Como uma nova solicitação de certificado, ele troca o certificado e o client_secret do cliente.

Certificado da CA (PEM)
Cliente Token temporário client_secret Certificado Ações
ColegioIntegrado
53098aaa-914e-3038-b839-65bc674d0e70
Criado em 16/09/2026 10:47
Utilizado
bb59b6bf7b2a14cef6060066b9770ddf1bddf4d771158c1f5ae6adc2495b0308
Expira em 19/09/2026 12:56
Para registrar pelo app (ItauRegisterCsr), gere um Novo token temporário.
d49b67a3-8834-4cee-a4b8-d98d201bc346 Válido
Emitido em 16/09/2026 13:08
Expira em 16/09/2027 13:08
5DDE920A1686EE347F25BD8E46DCC9DBA5270527
Gerar kit de teste

O kit emite um novo certificado e um novo client_secret, que só o simulador conhece, e consome o token temporário.

Não use em cliente que vai ser registrado pelo app (ItauRegisterCsr): lá, use o token temporário.

Excluir

Exclui o cliente, os tokens e o kit de teste. Só é permitido enquanto o cliente não tiver boletos.