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 1: Localizando o identificador do cliente
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.
ETAPA 2: Localizando a URL de token no Diretório
Requisitos
1.No navegador, acesse a URI de descoberta de conexão OpenID de acordo com o ambiente utilizado:
Sandbox https://auth.sandbox.directory.openbankingbrasil.org.br/.well-known/openid-configuration
Produção
https://auth.directory.openbankingbrasil.org.br/.well-known/openid-configuration
2.Localize o endpoint de token que será utilizado para trocar as credenciais de autenticação para tokens de acesso.
ETAPA 3: Adicionando certificados SSL por domí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
matls-auth.sandbox.directory.openbankingbrasil.org.br
Produção
ETAPA 3: Adicionando certificados SSL por domí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 4: Obtendo um token de acesso
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, e em seguida Request.
2.No campo Enter request URL, digite o valor obtido da URI 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-www-form-urlencoded’.
5.Insira os parâmetros como descritos a seguir:
client_id = <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.
