View a markdown version of this page

Zoom - Amazon Bedrock AgentCore
Salida

Zoom

Zoom se puede configurar como un proveedor de credenciales de AgentCore identidad para el acceso a los recursos salientes. Esto permite a sus agentes autenticar a los usuarios a través del servicio OAuth2 de Zoom y obtener tokens de acceso para los recursos de la API de Zoom.

Salida

nota

Solo puede configurar una aplicación OAuth2 de Zoom como una federación de usuarios o como un cliente OAuth2 M2M, pero no como ambos.

nota

AgentCore Identity emite una URL de devolución de llamada de OAuth2 única para cada proveedor de credenciales que cree. La URL única de devolución de llamada permite vincular las sesiones, lo que protege el intercambio de códigos de autorización de OAuth2 contra la reproducción y los CSRF-style ataques entre proveedores, al garantizar que una respuesta de autorización solo se pueda canjear contra el proveedor de credenciales específico que la inició. Como la URL es única para cada proveedor, no la conocerás hasta que llames. CreateOauth2CredentialProvider Cree primero su cliente OAuth2 de Zoom y, a continuación, vuelva a la consola de desarrolladores de Zoom para registrar la URL de devolución de llamada una vez que AgentCore Identity la haya emitido.

Paso 1: Cree el cliente OAuth2 de Zoom

Utilice el siguiente procedimiento para configurar una aplicación Zoom OAuth2 y obtener las credenciales de cliente necesarias para Identity. AgentCore Registrará el URI de redireccionamiento en el paso 3, después de que AgentCore Identity emita la URL única de devolución de llamada.

Para configurar una aplicación Zoom OAuth2

  1. Inicie sesión en Zoom App Marketplace.

  2. Elija Desarrollar > Crear aplicación.

  3. Para una aplicación de federación de usuarios, seleccione Aplicación general y elija Crear.

    • En la página de detalles de la aplicación, añada un nombre a la aplicación y seleccione cómo se administrará la aplicación.

    • En la sección de información de OAuth, deja vacías por ahora la URL de redireccionamiento de OAuth y las listas de direcciones permitidas de OAuth. Añadirás la URL única de devolución de llamada en el paso 3.

  4. Para una aplicación M2M, selecciona Aplicación OAuth de servidor a servidor y selecciona Crear.

    • Añade un nombre a tu aplicación.

    • En la página de detalles de la aplicación, elija Ámbitos y añada los ámbitos necesarios para su aplicación.

    • Abre Información y proporciona el nombre de la empresa y la información de contacto del desarrollador.

  5. Registre el ID de cliente y el secreto de cliente que se generaron para su aplicación. Necesitará estos valores para configurar el proveedor de credenciales de Zoom en AgentCore Identity.

Para obtener más información, consulte la documentación de integración de Zoom.

Paso 2: Cree el proveedor de credenciales de AgentCore identidad

Para configurar Zoom como proveedor de recursos salientes, utilice lo siguiente:

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

La CreateOauth2CredentialProviderrespuesta incluye un callbackUrl campo. Esta URL es exclusiva de este proveedor de credenciales y tiene el siguiente aspecto:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Guarde este valor para el siguiente paso.

Paso 3: registre la URL única de devolución de llamada con Zoom

Regrese a la consola de desarrolladores de Zoom y añada la URL única de devolución de llamada a la lista de URI de redireccionamiento de su aplicación OAuth2.

  1. Inicie sesión en la consola de desarrolladores de Zoom y abra la aplicación OAuth2 que creó en el paso 1.

  2. Añada el callbackUrl valor devuelto por CreateOauth2CredentialProvider a la configuración del URI de redireccionamiento de la aplicación.

  3. Guarde los cambios.