17. Obtendo um token de acesso para as APIs do Diretório

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.

1. No navegador, acesse a URL 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.

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: matls-auth.directory.openbankingbrasil.org.br

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.

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 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-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.