View a markdown version of this page

Dropbox - Amazon Bedrock AgentCore
Salida

Dropbox

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

nota

Dropbox no admite el flujo de credenciales. M2M/Client

Salida

nota

AgentCore Identity emite una URL de devolución de llamada de OAuth2 única para cada proveedor de credenciales que crees. 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 Crea primero tu cliente OAuth2 de Dropbox y, después, vuelve a la consola de desarrolladores de Dropbox para registrar la URL de devolución de llamada una vez que AgentCore Identity la haya emitido.

Paso 1: Crea el cliente OAuth2 de Dropbox

Usa el siguiente procedimiento para configurar una aplicación OAuth2 de Dropbox y obtener las credenciales de cliente necesarias para Identity. AgentCore Registrarás 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 OAuth2 de Dropbox

  1. Abre la consola de aplicaciones para desarrolladores de Dropbox.

  2. Seleccione Crear una aplicación.

  3. Elige Acceso limitado.

  4. Para el tipo de acceso, elija el tipo de acceso adecuado para su aplicación.

  5. Indique un nombre para su solicitud.

  6. Seleccione Crear una aplicación.

  7. En la página de información general de la aplicación, abre la sección OAuth2. Deja vacía la lista de direcciones URL de redireccionamiento por ahora; añadirás la URL única de devolución de llamada en el paso 3.

  8. En la misma sección, selecciona el menú desplegable situado debajo de Permitir clientes públicos (Implicit Grant y PKCE) y selecciona No permitir en las opciones.

  9. Registra la clave y el secreto de la aplicación, ya que necesitarás la información para configurar el proveedor de recursos de Dropbox en Identity. AgentCore

  10. En la pestaña Permisos de la aplicación, selecciona los ámbitos necesarios para tu aplicación.

Para obtener más información, consulta la guía de implementación de OAuth de Dropbox.

Paso 2: Crea el proveedor de credenciales de AgentCore identidad

Para configurar Dropbox como proveedor de recursos salientes, usa lo siguiente:

{
  "name": "DropBox",
  "credentialProviderVendor": "DropboxOauth2",
  "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: registra la URL única de devolución de llamada en Dropbox

Regresa a la consola de desarrolladores de Dropbox y añade la URL única de devolución de llamada a la lista de direcciones URL de redireccionamiento de tu aplicación OAuth2.

  1. Inicia sesión en la consola para desarrolladores de Dropbox y abre la aplicación OAuth2 que creaste en el paso 1.

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

  3. Guarde los cambios.