Documentazione dell'infrastruttura Oracle Cloud

Impostazione dell'autenticazione del token Bearer del dominio di Identity

Configurare un'applicazione riservata in un dominio di Identity IAM OCI per eseguire i token di accesso OAuth per i client che richiamano un'applicazione hosted utilizzando l'autenticazione del token bearer del dominio di Identity.

Questi passi si applicano alle applicazioni hosted che utilizzano l'autenticazione del token bearer del dominio di Identity. Utilizzare l'URL, l'ambito e l'audience del dominio di Identity durante la configurazione dell'autenticazione per l'applicazione hosted. Vedere Autenticazione.

Nell'esempio riportato di seguito viene utilizzata la concessione delle credenziali client per ottenere i token di accesso. Per una panoramica dei metodi di autenticazione supportati, vedere Autenticazione. Per informazioni sui domini di Identity, vedere IAM with Identity Domains.

Per l'autenticazione della sessione del browser del dominio di Identity, vedere Sessione del browser del dominio di Identity. Questa opzione utilizza il flusso del codice di autorizzazione OAuth 2.1 con PKCE e il servizio di applicazioni hosted ottiene i token di accesso per conto degli utenti del browser.

Passo 1. Crea un dominio di Identity (facoltativo)

Ogni tenancy OCI ha un dominio di Identity predefinito. Per creare un altro dominio, vedere Creazione di un dominio di Identity. Passi di esempio:

  1. Connettersi a OCI Console.
  2. Aprire il menu di navigazione e selezionare Identità e sicurezza.
  3. In Identità selezionare Domini.
  4. Selezionare Crea dominio.
  5. Fornire le informazioni richieste, ad esempio l'amministratore del dominio.
  6. Selezionare Crea e attendere che il dominio diventi attivo.

Passo 2. Crea un'applicazione nel dominio di Identity

Passi di esempio:

  1. Aprire il dominio di Identity da utilizzare per l'autenticazione. È possibile utilizzare il dominio predefinito o un dominio creato.
  2. Selezionare la scheda Applicazioni integrate.
  3. Selezionare Aggiungi applicazione.
  4. Selezionare Applicazione riservata, quindi selezionare Avvia workflow.
  5. Specificare un Nome e una Descrizione, lasciare i campi rimanenti come predefiniti e selezionare Sottometti.

Passo 3. Configurare le impostazioni OAuth

Passi di esempio:

  1. Aprire l'applicazione creata.
  2. Selezionare Configurazione OAuth, quindi selezionare Modifica configurazione OAuth.
  3. Abilitare l'opzione Configura questa applicazione come server risorse ora.

    Fornire un audience principale, ad esempio https://your_application.com/. Audience indica quale API è autorizzata ad accettare e convalidare il token di autenticazione generato dal server delle identità. In questo caso specifico, è possibile immettere un URL API del piano dati, ad esempio https://application.generativeai.ap-osaka-1.oci.oraclecloud.com/20251112/hostedApplications/. L'obiettivo è impostare l'identità del destinatario che verifica il token OAuth. È possibile utilizzare qualsiasi parola, ad esempio my_agent_application.

    Selezionare Aggiungi ambiti e definire un nome di ambito (ad esempio, read, write, invoke). Ambito indica le autorizzazioni concesse dal token di autenticazione. È possibile definire diversi ambiti nell'applicazione integrata del dominio di Identity e fare in modo che l'applicazione ospitata ne utilizzi uno per l'autenticazione.

  4. Abilitare Configurare questa applicazione come client ora

    Selezionare Credenziali client come tipo di privilegio.

  5. Selezionare Sottometti.
  6. Dal menu Azioni (tre punti), selezionare Attiva per attivare l'applicazione.

Dopo l'attivazione, tornare alla pagina dei dettagli dell'applicazione e selezionare OAuth Configuration. È possibile visualizzare i seguenti valori:

  • ID client
  • Segreto client
  • Destinatari primari
  • Ambito

Nella pagina principale del dominio di Identity viene visualizzato l'URL del dominio. Registrare questi valori in modo sicuro. Li si utilizza in un secondo momento per generare un token di accesso per accedere all'applicazione ospitata.