Usando o OAuth 2 para Acessar a API REST

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

Ao registrar um aplicativo confidencial na Console do domínio de identidades, você obtém alguns dos parâmetros-chave necessários para trabalhar com OAuth 2.0: ID do Cliente, Segredo do Cliente e Escopos. OAuth 2.0 é um padrão para implementar a autorização delegada e a autorização é baseada 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. Quando você registra um aplicativo Web em um domínio de identidades, 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ê fizesse outras coisas - por exemplo, gerencie Eventos de Auditoria, isso exigiria outros escopos.

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

1. Abra o menu de navegaçãoe clique em Segurança de Identidade. Em Identidade, clique em Domínios.
2. Clique no nome do domínio de identidades no qual você deseja trabalhar. Talvez você precise alterar o compartimento para localizar o domínio desejado. Em seguida, clique em Aplicativos integrados.
3. Clique em Adicionar aplicativo.
4. Na caixa de diálogo Add application, selecione Confidential Application e clique em Launch workflow.
5. Na página Adicionar detalhes do aplicativo, digite o nome e a descrição do aplicativo e clique em Próximo.
6. Na página Configurar OAuth, em Configuração do cliente, selecione Configurar este aplicativo como 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 funções do aplicativo e clique em Adicionar funções.
9. No painel Adicionar atribuições de aplicativo, selecione Administrador de Domínio de Identidades e clique em Adicionar.
10. Clique em Próximo e depois clique em Finalizar.
11. Na página de detalhes do aplicativo, role para baixo até Informações Gerais. Copie o ID do Cliente e o Segredo do Cliente e armazene-o em um local seguro.
12. Depois que o aplicativo for criado, clique em Ativar.

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

Windows

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 do cliente 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 de CMD Aqui no menu de contexto.

5. Digite 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 depois de finalizar.

Mac e Linux

1. Inicie seu utilitário de observaçã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 observação.

2. Coloque o ID do cliente 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 digite o comando a seguir, substituindo clientid:clientsecret pelo valor copiado 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

A próxima etapa deste processo é solicitar o token de acesso.

1. Inicie um prompt de comando.

2. Digite o comando cURL abaixo, substituindo o texto entre colchetes ( < > ) 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
   
   Opcionalmente, execute o seguinte comando cURL para ter o valor do token de acesso acessível por meio de uma variável UNIX chamada AccessTokenValue em 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:segredo	Substitua pelas credenciais codificadas que você gerou na seção Base64 Codificar 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 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 identidade aplicáveis com base nos privilégios representados pelas atribuições de administrador de domínios de identidade 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.

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

Depois de obter o token de acesso OAuth 2.0, você pode usar o token em um comando cURL para enviar uma solicitação REST à API REST de domínios de identidade. 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