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:
| Perfil | O que faz nesta jornada |
|---|---|
| Admin | Cria 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. |
| Owner | Aprova 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
- Crie sua aplicação: defina o nome, selecione os CNPJs e os produtos (APIs) e configure a restrição de IP, se necessário.
- Crie as credenciais e o certificado: siga as orientações desta página.
- 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.
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.
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.
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.
O Client Secret aparece uma única vez
Por segurança, o Client ID e o Client Secret são exibidos só nesta tela e não ficam armazenados no portal. Se você perder o Client Secret, é preciso gerar uma nova credencial.
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.
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.
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.
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.
Emitir o certificado
Selecione Emitir certificado
Com a aprovação, o card mostra Aprovação concluída. Selecione Emitir certificado.
Prazo de 72 horas
Se o certificado não for emitido em até 72 horas depois da aprovação, é preciso pedir a aprovação de novo.
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.
Baixe o certificado
Quando aparecer Certificado criado!, selecione Baixar certificado.
Baixe o certificado agora
Por segurança, o certificado não fica armazenado na nossa base de dados. O arquivo só está disponível nesta tela: se você fechar a janela antes do download, é preciso emitir um novo 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.
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.
Glossário
| Termo | Significado |
|---|---|
| Client ID | Identificador da aplicação no servidor de autenticação (OAuth). |
| Client Secret | Senha da aplicação no servidor de autenticação (OAuth). Aparece uma única vez. |
| Token temporário | Valor 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. |
| Ambiente | Onde 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.