Usando o OAuth 2 para Acessar a API REST

Etapa 1: Registrar um Aplicativo Confidencial em Domínios de Identidade Usando a Console

Quando você registra um aplicativo confidencial na Console do domínio de identidades, obtém alguns dos principais parâmetros necessários para trabalhar com o OAuth 2.0: ID do Cliente, Segredo do Cliente e Escopos. O OAuth 2.0 é um padrão para implementar a autorização delegada, e a autorização se baseia no token de acesso necessário para acessar um recurso. O token de acesso pode ser emitido para um determinado escopo, que define o que o token de acesso pode fazer e quais recursos ele pode acessar. Ao registrar um aplicativo Web em um domínio de identidades, você adiciona escopos. No exemplo a seguir, os escopos necessários para solicitar pesquisas, edições, criações e exclusões do Usuário são adicionados. Mas, se você fosse fazer outras coisas, por exemplo, gerenciar Eventos de Auditoria, isso exigiria outros escopos.

Para criar e registrar um aplicativo confidencial, acesse a Console do OCI e execute as seguintes etapas:

1. Abra o menu de navegação e selecione Identidade e Segurança. Em Identidade, selecione Domínios.
2. Clique no nome do domínio de identidades no qual deseja trabalhar. Talvez você precise alterar o compartimento para localizar o domínio desejado. Em seguida, clique em Aplicativos integrados.
3. Selecione Adicionar aplicativo.
4. Na caixa de diálogo Adicionar aplicativo, selecione Aplicativo Confidencial e, em seguida, selecione Iniciar workflow.
5. Na página Adicionar detalhes do aplicativo, informe um nome e uma descrição do aplicativo e selecione Próximo.
6. Na página Configurar OAuth, em Configuração de cliente, selecione Configurar este aplicativo como um cliente agora.
7. Em Autorização, selecione apenas Credenciais do Cliente como o Tipo de Concessão Permitido.
8. Na parte inferior da página, selecione Adicionar atribuições de aplicativo e, em seguida, Adicionar atribuições.
9. No painel Adicionar atribuições de aplicativo, selecione Administrador de Domínio de Identidades e, em seguida, selecione Adicionar.
10. Selecione Próximo e, em seguida, selecione Concluir.
11. Na página detalhada do aplicativo, role para baixo até Informações Gerais. Copie o ID do Cliente e o Secreto do Cliente e armazene-o em um local seguro.
12. Depois que a aplicação for criada, selecione Ativar.

Etapa 2: Base64 Codifique o ID do Cliente e o Segredo do Cliente

Janelas

1. Inicie o Bloco de Notas e cole o ID do cliente e o segredo do cliente no Bloco de Notas.

2. Coloque o ID e o segredo do cliente na mesma linha e insira dois-pontos entre eles: clientid:clientsecret

   Observação
   
   Certifique-se de que nenhum espaço seja o atributo clientid:clientsecret.

3. Salve o arquivo em C:\temp e nomeie-o como appCreds.txt.

4. No Windows Explorer, clique com o botão direito do mouse em C:\temp e selecione Prompt CMD Aqui no menu de contexto.

5. Insira o seguinte comando para codificar o ID do cliente e o segredo do cliente:

   certutil -encode appCreds.txt appbase64Creds.txt

6. No Bloco de Notas, abra C:\temp\appbase64Creds.txt, copie seu conteúdo e feche o arquivo.

   Observação
   
   Por motivos de segurança, exclua os arquivos appCreds.txt e appbase64Creds.txt após a conclusão.

Mac e Linux

1. Inicie o utilitário de anotação preferido (por exemplo, Mac Notes, Gedit Linux ou Vi) e cole o ID do cliente e o segredo do cliente no utilitário de anotação.

2. Coloque o ID e o segredo do cliente na mesma linha e insira dois-pontos entre eles: clientid:clientsecret.

   Observação
   
   Certifique-se de que não haja espaços no clientid:clientsecret.
   instrução.

3. Copie a linha clientid:clientsecret.

4. Inicie um terminal e insira o comando a seguir, substituindo clientid:clientsecret pelo valor que você copiou para a área de transferência.

   echo -n "clientid:clientsecret" | base64 -w 0

   Observação
   
   Para o Linux, adicione -w 0 ao comando para remover quebras de linha.
5. Copie o valor retornado.

   Observação
   
   Se o valor retornado for dividido em mais de uma linha, retorne ao editor de texto e certifique-se de que todos os resultados estejam em uma única linha sem quebra de texto.

Etapa 3: Obter um Token de Acesso

O próximo passo neste processo é solicitar o token de acesso.

1. Inicie um prompt de comando.

2. Insira o comando cURL abaixo, substituindo o texto entre parênteses ( < > ) pelos valores apropriados:

      curl -i
      -H "Authorization: Basic <base64encoded clientid:secret>"
      -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8"
      --request POST https://<domainURL>/oauth2/v1/token
      -d "grant_type=client_credentials&scope=urn:opc:idm:__myscopes__"

   Observação
   
   Se você estiver usando um sistema operacional UNIX, poderá anexar | awk -F"\"" '{print $4}' ao final do comando cURL para fazer parsing apenas do token do Portador. Apenas lembre-se de que a expiração padrão do token é de 3600 segundos a partir do momento da solicitação.
   Observação
   
   Se preferir, execute o seguinte comando cURL para ter o valor do token de acesso acessível por meio de uma variável UNIX chamada AccessTokenValue no seu ambiente:

      export AccessTokenValue=`curl -i
      -H "Authorization: Basic <base64encoded clientid:secret>"
      -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8"
      --request POST https://<domainURL>/oauth2/v1/token
      -d "grant_type=client_credentials&scope=urn:opc:idm:__myscopes__" | awk -F"\"" '{print $4}' |  tail -n +16`

   Em seguida, você pode executar o comando echo $AccessTokenValue para obter o valor do token de acesso.

   Texto em Intervalos	Valor
   base64encoded clientid:secret	Substitua pelas credenciais codificadas que você gerou na seção Base64 Encode o ID do cliente e o segredo do cliente. Certifique-se de que não haja espaços nas credenciais clientid:clientsecret.
   IDCS_Service_Instance	Substitua pelo URL do seu domínio de identidades (por exemplo, https://<domainURL>/).

   Observação
   
   O escopo urn:opc:idm:__myscopes__ no comando é usado como uma tag pelos clientes do domínio de identidades que solicitam tokens de acesso do servidor de autorização OAuth. São retornados tokens de acesso que contêm todos os escopos de domínios de identidades aplicáveis com base nos privilégios representados pelas atribuições de administrador de domínios de identidades concedidas ao cliente solicitante e ao usuário que está sendo especificado pela solicitação do cliente (se presente). Esse escopo não é concedido diretamente a nenhuma atribuição de administrador de domínios de identidades.

3. Copie o valor access_token da resposta. Certifique-se de copiar apenas o token real, que é o valor access_token entre aspas:

   Status: 200
   "access_token":"eyJ4NXQiOiI4Wk. . ."
   "token":"Bearer",
   "expires_in":3600
   

   Observação
   
   A resposta inclui o parâmetro expires_in: 3600. Isso significa que seu token não é mais válido após uma hora a partir do momento em que você o gera. Após uma hora, atualize o token ou obtenha um novo token de acesso. Para atualizar o token, insira o comando cURL abaixo, substituindo o texto entre parênteses ( < > ) pelos valores apropriados:

   curl -i
     -H "Authorization: Basic <base64 encoded client ID and secret>"
     -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8"
     --request POST https://<domainURL>/oauth2/v1/token
     -d "grant_type=refresh_token&refresh_token=<token_value>"

Etapa 4: Fazer uma Solicitação REST para o Ambiente

Depois de obter o token de acesso OAuth 2.0, você poderá usar o token em um comando cURL para enviar uma solicitação REST à API REST de domínios de identidades. O comando a seguir retorna uma lista de usuários em um domínio de identidades.

   curl -X GET
   -H "Content-Type:application/scim+json"
   -H "Authorization: Bearer <access_token>"
   https://<domainURL>/admin/v1/Users