Para acessar as APIs do Diretório do Open Finance, você precisará de um token de acesso. Esta seção descreve as etapas necessárias para adquirir tokens de acesso.
ETAPAÂncora | ||||
---|---|---|---|---|
|
Identificador do
clienteCliente
Requisitos
1. Necessário ter criado uma Criando um Software Statements para sua organização.
2. No Diretório, localize e selecione a sua organização.
3. Vá até o menu Software Statement
, acesse o artefato criado anteriormente clicando no símbolo do lápis.
4. Na janela Software Statement Details
localize o campo CLIENT ID
, selecione e copie o valor.
Âncora | ||||
---|---|---|---|---|
|
Token no Diretório
Requisitos
1. No navegador, acesse a URI URL de descoberta de conexão OpenID de acordo com o ambiente utilizado:
Sandbox:
https://auth.sandbox.directory.openbankingbrasil.org.br/.well-known/openid-configurationProdução
2. Localize o endpoint de token que será utilizado para trocar as credenciais de autenticação para tokens de acesso.
ETAPA
Etapa 3: Adicionando
certificadosCertificados SSL por
domínioDomínio
Requisitos
1. Necessário ter criado uma Criando uma solicitação de Assinatura de Certificado (CSR).
2. Para fins ilustrativos será utilizado o Postman para acessar as APIs do Diretório do Open Finance. Assim, no Postman, selecione o menu File
e em seguida o menu Settings
.
3. Na janela Settings
, selecione o menu Certificates
e clique no link Add Certificate
.
4. Na aba Certificates, no campo Host insira um dos valores descritos a seguir de acordo com o ambiente utilizado:
Sandbox
ETAPA
Etapa 3: Adicionando
certificadosCertificados SSL por
domínioDomínio
Requisitos
5. Em CRT file
, clique no botão Select file
, e localize o <arquivo>.pem
obtido na seção Criando uma solicitação de Assinatura de Certificado (CSR).
6. No passo seguinte, clique no botão KEY File
e localize o <arquivo>.key
criado no processo de geração de chaves na seção Criando uma solicitação de Assinatura de Certificado (CSR).
7. Clique no botão Add
.
ETAPA
Etapa 4: Obtendo um
tokenToken de
acessoAcesso
Requisitos
1. Para adicionar uma nova requisição a uma coleção, abra uma nova aba e salve a partir daí, ou em Collection
à esquerda do Postman, clique em ‘'...
’ '
na coleção e escolha Add Request
. Você também pode criar uma solicitação clicando no menu File
> New> New
, e em seguida Request
.
2. No campo Enter request URL
, digite o valor obtido da URI URL de token mencionado na etapa 2.
3. Defina o tipo da operação para POST
.
4. Vá para a guia Body
e selecione o botão de opção ‘x'x-www-form-
urlencoded’urlencoded'
.
5. Insira os parâmetros como descritos a seguir:
client_id = <valor <valor obtido no CLIENT ID na etapa 1>
grant_type = client_credentials
scope = directory:software
6. Uma vez que todos os parâmetros e valores estejam preenchidos, clique no botão Send
.
7. Selecione e copie o valor retornado no atributo access_token
.