View a markdown version of this page

Zoom - Fondamento Amazon AgentCore
In uscita

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Zoom

Zoom può essere configurato come fornitore di credenziali di AgentCore identità per l'accesso alle risorse in uscita. Ciò consente ai tuoi agenti di autenticare gli utenti tramite il servizio OAuth2 di Zoom e ottenere token di accesso per le risorse Zoom API.

In uscita

Nota

Puoi configurare un'applicazione Zoom OAuth2 solo come federazione di utenti o client M2M OAuth2, ma non entrambi.

Nota

AgentCore Identity emette un URL di callback OAuth2 univoco per ogni provider di credenziali creato. L'URL di callback univoco abilita l'associazione di sessione, che protegge lo scambio di codice di autorizzazione OAuth2 dalla ripetizione e dagli CSRF-style attacchi tra provider, garantendo che una risposta di autorizzazione possa essere riscattata solo rispetto allo specifico provider di credenziali che l'ha avviata. Poiché l'URL è unico per ogni provider, lo conoscerai solo dopo aver chiamato. CreateOauth2CredentialProvider Crea prima il tuo client Zoom OAuth2, quindi torna alla console per sviluppatori Zoom per registrare l'URL di callback una volta che AgentCore Identity lo ha emesso.

Passaggio 1: crea il client Zoom OAuth2

Utilizza la seguente procedura per configurare un'applicazione Zoom OAuth2 e ottenere le credenziali client necessarie per Identity. AgentCore Registrerai l'URI di reindirizzamento nel passaggio 3, dopo che AgentCore Identity avrà emesso l'URL di callback univoco.

Per configurare un'applicazione Zoom OAuth2

  1. Accedi a Zoom App Marketplace.

  2. Scegliere Sviluppo > Crea app.

  3. Per un'app di federazione utenti, seleziona App generale e scegli Crea.

    • Nella pagina dei dettagli dell'app, aggiungi un nome per la tua applicazione e seleziona come verrà gestita la tua applicazione.

    • Nella sezione Informazioni OAuth, lascia vuoti per il momento gli elenchi di URL di reindirizzamento OAuth e OAuth Consenti: aggiungerai l'URL di callback univoco nel passaggio 3.

  4. Per un'app M2M, seleziona l'app OAuth da server a server e scegli Crea.

    • Aggiungi un nome per la tua applicazione.

    • Nella pagina dei dettagli dell'app, scegli Ambiti e aggiungi gli ambiti necessari per la tua applicazione.

    • Apri Informazioni e fornisci il nome dell'azienda e le informazioni di contatto dello sviluppatore.

  5. Registra l'ID e il segreto del cliente che sono stati generati per la tua applicazione. Avrai bisogno di questi valori per configurare il fornitore di credenziali Zoom in AgentCore Identity.

Per maggiori dettagli, consulta la documentazione sull'integrazione di Zoom.

Passaggio 2: creare il fornitore di credenziali di AgentCore identità

Per configurare Zoom come fornitore di risorse in uscita, utilizza quanto segue:

{
  "name": "Zoom",
  "credentialProviderVendor": "ZoomOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}

La CreateOauth2CredentialProvider risposta include un callbackUrl campo. Questo URL è unico per questo fornitore di credenziali e ha il seguente aspetto:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Salva questo valore per il passaggio successivo.

Passaggio 3: registra l'URL di callback univoco con Zoom

Torna alla console per sviluppatori Zoom e aggiungi l'URL di callback univoco all'elenco degli URI di reindirizzamento della tua applicazione OAuth2.

  1. Accedi alla console per sviluppatori Zoom e apri l'applicazione OAuth2 che hai creato nel passaggio 1.

  2. Aggiungi il callbackUrl valore restituito da CreateOauth2CredentialProvider alla configurazione dell'URI di reindirizzamento dell'applicazione.

  3. Salvare le modifiche.