Configurando a Autenticação de Token do Portador do Domínio de Identidades

Configure um aplicativo confidencial em um domínio de identidades do OCI IAM para emitir tokens de acesso OAuth para clientes que chamam um aplicativo hospedado usando a autenticação de token do portador de domínio de identidades.

Essas etapas se aplicam a aplicativos hospedados que usam a autenticação de token do portador do domínio de identidades. Use o URL, o escopo e o público-alvo do domínio de identidades ao configurar a autenticação do aplicativo hospedado. Consulte Autenticação.

O exemplo a seguir usa a concessão de credenciais do cliente para obter tokens de acesso. Para obter uma visão geral dos métodos de autenticação suportados, consulte Autenticação. Para obter informações sobre domínios de identidades, consulte IAM com Domínios de Identidades.

Para autenticação de sessão do browser do domínio de identidades, consulte Sessão do browser do domínio de identidades. Essa opção usa o fluxo do Código de Autorização OAuth 2.1 com PKCE, e o serviço de aplicativo hospedado obtém tokens de acesso em nome dos usuários do navegador.

Etapa 1. Criar um Domínio de Identidades (Opcional)

Cada tenancy do OCI tem um domínio de identidades padrão. Para criar outro domínio, consulte Criando um Domínio de Identidades. Exemplo de etapas:

  1. Acesse o Console do OCI.
  2. Abra o menu de navegação e selecione Identidade e Segurança.
  3. Em Identidade, selecione Domínios.
  4. Selecione Criar domínio.
  5. Forneça as informações necessárias, como o administrador de domínio.
  6. Selecione Criar e aguarde o domínio se tornar ativo.

Etapa 2. Criar um Aplicativo no Domínio de Identidades

Exemplo de etapas:

  1. Abra o domínio de identidades a ser usado para autenticação. Você pode usar o domínio padrão ou um domínio criado.
  2. Selecione a guia Aplicativos integrados.
  3. Selecione Adicionar aplicativo.
  4. Selecione Aplicativo Confidencial e, em seguida, Iniciar workflow.
  5. Forneça um Nome e uma Descrição, deixe os campos restantes como padrão e selecione Enviar.

Etapa 3. Configurar Definições do OAuth

Exemplo de etapas:

  1. Abra o aplicativo que você criou.
  2. Selecione OAuth configuration e, em seguida, Editar configuração OAuth.
  3. Ative Configurar este aplicativo como um servidor de recursos agora.

    Forneça um Público-alvo principal, por exemplo: https://your_application.com/. Público-alvo significa qual API tem permissão para aceitar e validar o token de autenticação gerado pelo servidor de identidades. Nesse caso específico, você pode inserir um URL da API do plano de dados, como https://application.generativeai.ap-osaka-1.oci.oraclecloud.com/20251112/hostedApplications/. A meta é definir a identidade do destinatário que verifica o token OAuth. Você pode usar qualquer palavra, por exemplo, my_agent_application.

    Selecione Adicionar escopos e defina um nome de escopo (por exemplo, read, write, invoke). Escopo significa quais permissões o token de autenticação concede. Você pode definir vários escopos no aplicativo integrado ao domínio de identidades e fazer com que o aplicativo hospedado use um deles para autenticação.

  4. Ative Configurar este aplicativo como um cliente agora

    Selecione Credenciais do cliente como o tipo de concessão.

  5. Selecione Enviar.
  6. No menu Ações (três pontos), selecione Ativar para ativar o aplicativo.

Após a ativação, retorne à página de detalhes do aplicativo e selecione OAuth Configuração. Você pode ver os seguintes valores:

  • ID do cliente
  • Segredo do cliente
  • Público-alvo principal
  • Escopo

Na página principal do Domínio de Identidades, você vê o URL do Domínio. Registre esses valores com segurança. Você os usa posteriormente para gerar um token de acesso para acessar o aplicativo hospedado.