Como criar credenciais e certificados

Crie a credencial da sua aplicação, solicite a aprovação para emitir o certificado e confira como baixá-lo e renová-lo.

Antes de começar

Entenda a diferença entre credencial e certificado:

  • Credencial: reúne o Client ID e o Client Secret, usados para autenticar sua aplicação nas integrações.
  • Certificado: é o arquivo de segurança necessário para realizar as integrações.

Você pode criar a credencial sem aprovação. Para emitir o certificado, precisa da aprovação de um representante (perfil Owner) no Bankline (Internet Banking) PJ ou BBA.

Quem participa

A criação de credenciais e certificados envolve 2 perfis:

PerfilO que faz nesta jornada
AdminCria a credencial, pede a aprovação para emitir o certificado e emite e baixa o certificado. Pode ser Admin da sua organização ou do integrador parceiro.
OwnerAprova a emissão do certificado no Bankline. Pode ser o Representante Legal ou uma pessoa Delegada.

Aprovação sensível

A emissão do certificado é uma aprovação sensível: o pedido feito pelo Admin só avança depois da aprovação do representante. A criação da credencial não precisa de aprovação.

Onde este guia entra na integração

  1. Crie sua aplicação: defina o nome, selecione os CNPJs e os produtos (APIs) e configure a restrição de IP, se necessário.
  2. Crie as credenciais e o certificado: siga as orientações desta página.
  3. Autorize um integrador parceiro, se necessário: consulte o guia específico se uma empresa parceira fizer a integração em nome da sua organização.

Criar credencial

Acesse Credenciais e certificados

Na página da aplicação, selecione o atalho Criar credenciais e certificados ou, no bloco Credenciais recentes, selecione Gerir credenciais.

Página da aplicação com o atalho Criar credenciais e certificados e o bloco Credenciais recentes com a opção Gerir credenciais

Selecione Criar credencial

Na área Credenciais e Certificados, selecione Criar credencial. Se a aplicação ainda não tem credencial ativa, a opção aparece com a mensagem Crie sua primeira credencial.

Área Credenciais e Certificados sem credencial, com a mensagem Crie sua primeira credencial e o botão Criar credencial

Escolha o ambiente e o nome

Na janela Criar credencial, defina:

  • Ambiente: selecione Produção, para gerar uma credencial usada no ambiente de produção.
  • Nome da credencial: entre 4 e 80 caracteres.

Depois, selecione Criar credencial e aguarde enquanto as credenciais são geradas.

Janela Criar credencial com o ambiente Produção selecionado, o campo Nome da credencial preenchido e o botão Criar credencial

Guarde o Client ID e o Client Secret

Com a credencial criada, copie o Client ID (identificador da aplicação) e o Client Secret (senha da aplicação) e guarde em um local seguro, como um cofre de segredos. Depois, selecione Concluir.

Confirmação Credencial criada! com o aviso Salve sua credencial em local seguro e os campos Client ID e Client Secret

Pedir aprovação para emitir o certificado

Antes de emitir o certificado, o Admin precisa da aprovação de um representante, feita no Bankline.

Selecione Pedir aprovação

No card da credencial, aparece o aviso Falta um passo para emitir o certificado. Selecione Pedir aprovação.

Card da credencial com o aviso Falta um passo para emitir o certificado e a opção Pedir aprovação

Preencha a identificação do certificado

Na janela Emitir certificado, preencha os dados de identificação:

  • Identificação da empresa: nome simples para identificar o serviço integrado ao Itaú, com até 50 caracteres, só letras sem acento e números. Exemplo: ABC LTDA.
  • Cidade.
  • País e Estado.

Depois, selecione Solicitar emissão.

Janela Emitir certificado com os campos Identificação da empresa, Cidade, País e Estado preenchidos e o botão Solicitar emissão

Envie o pedido

Na janela Aprovação de certificado, selecione Enviar solicitação para enviar o pedido ao representante. Depois da aprovação, você volta a esta área para emitir o certificado.

Janela Aprovação de certificado com as opções Cancelar e Enviar solicitação

Envolva um representante para a aprovação

O pedido de certificado vai para análise de um representante no Bankline. A solicitação fica disponível no hub Integrações e Acessos a APIs, no caminho Ir para Conta Corrente>Configurações e Acessos>Configurar Produtos e Serviços>Integrações e Acessos a APIs. Qualquer representante pode aprovar. A solicitação fica no hub por até 7 dias depois do pedido; depois desse prazo, ela expira e é preciso fazer uma nova.

Card da credencial com o aviso Aguardando aprovação por um Owner via Internet Banking e a opção Emitir certificado indisponível Hub Integrações e Acessos a APIs no Bankline, onde a solicitação de certificado fica disponível para aprovação

Emitir o certificado

Selecione Emitir certificado

Com a aprovação, o card mostra Aprovação concluída. Selecione Emitir certificado.

Card da credencial com o aviso Aprovação concluída e a opção Emitir certificado

Gere o token temporário e emita o certificado

Na janela Emitir certificado, informe o Client Secret da credencial e selecione Gerar token temporário. O token temporário é o valor que comprova a autenticação da credencial e é obrigatório para gerar o certificado. Com o token gerado, selecione Emitir certificado e aguarde enquanto o certificado é gerado.

Janela Emitir certificado com o Client Secret informado, o campo Token temporário preenchido e o botão Emitir certificado

Baixe o certificado

Quando aparecer Certificado criado!, selecione Baixar certificado.

Janela Emitir certificado com a mensagem Certificado criado! e o botão Baixar certificado

O navegador pede para salvar 2 arquivos: o certificado, com extensão .crt, e a chave privada, com extensão .key. Você precisa autorizar o download dos dois no navegador.

Se o navegador bloquear o download, aparece um aviso pedindo permissão para fazer o download de vários arquivos. Selecione Permitir para salvar os dois arquivos.

Aviso do navegador para fazer o download de vários arquivos, com as opções Permitir e Bloquear

Renovar o certificado

A renovação do certificado dinâmico mantém segura a comunicação entre a sua aplicação e as APIs do Itaú. O certificado vale 365 dias e pode ser renovado a partir de 30 dias antes do vencimento. A renovação é feita da mesma forma que a emissão, necessitando da aprovação de um representante via Bankline.

Tela de renovação do certificado dinâmico

Glossário

TermoSignificado
Client IDIdentificador da aplicação no servidor de autenticação (OAuth).
Client SecretSenha da aplicação no servidor de autenticação (OAuth). Aparece uma única vez.
Token temporárioValor obtido no STS Itaú que representa a autenticação da credencial. É obrigatório para gerar o certificado pela primeira vez e, depois, para consumir as APIs do Itaú junto com o certificado.
AmbienteOnde a credencial vale. Hoje, a credencial é criada para o ambiente de Produção.

Perguntas frequentes

Quanto tempo tenho para emitir o certificado depois da aprovação?

Até 72 horas. Depois desse prazo, é preciso pedir a aprovação de novo.

Perdi o Client Secret. O que faço?

O Client Secret aparece uma única vez e não fica armazenado no portal. Crie uma nova credencial.

Fechei a janela antes de baixar o certificado. O que faço?

O certificado não fica armazenado na nossa base de dados. Emita um novo certificado e baixe o arquivo na mesma tela.

As credenciais são enviadas por e-mail?

Não. Elas ficam disponíveis só no portal autenticado, com registro de quem fez cada ação.

Preciso gerar uma nova credencial para renovar o certificado?

Não. Use o Client ID e o Client Secret que você já tem.