View a markdown version of this page

X - Base amazónica AgentCore
Salida

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

X

X 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 X y obtener tokens de acceso para los recursos de la API X.

Salida

nota

AgentCore Identity emite una URL de devolución de llamada de OAuth2 única para cada proveedor de credenciales que crees. La URL de devolución de llamada única permite vincular la sesión, lo que protege el intercambio de códigos de autorización de OAuth2 contra la reproducción entre proveedores y los CSRF-style ataques, ya que garantiza 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 sabrás hasta después de llamar. CreateOauth2CredentialProvider Crea primero tu cliente OAuth2 de X y, a continuación, vuelve a la consola de desarrolladores de X para registrar la URL de devolución de llamada una vez que AgentCore Identity la haya emitido.

Paso 1: Crea el cliente X OAuth2

Utilice el siguiente procedimiento para configurar una aplicación X 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 de devolución de llamada única.

Para configurar una aplicación X OAuth2

  1. Abra el portal para desarrolladores de X.

  2. En la barra de navegación izquierda, selecciona Proyecto y aplicaciones.

  3. Selecciona el proyecto X que has creado para la aplicación.

  4. En el encabezado Aplicaciones, selecciona Agregar una aplicación.

  5. Elija Crear nuevo.

  6. Proporcione un nombre y una descripción para su aplicación.

  7. En la barra de navegación izquierda, elige la aplicación que se acaba de generar.

  8. En la página de detalles de la aplicación nueva, selecciona Editar en la configuración de autenticación de usuario.

  9. Selecciona los permisos de aplicación necesarios para tu aplicación.

  10. En Tipo de aplicación, seleccione Aplicación web, Aplicación automatizada o Bot.

  11. En Información de la aplicación, deja vacío el campo URL de devolución de llamada por ahora; añadirás la URL de devolución de llamada única en el paso 3.

  12. En URL del sitio web, introduce la URL de tu aplicación.

  13. Seleccione Save.

  14. En la pestaña Claves y claves de tu aplicación, ve al ID de cliente y al secreto del cliente de OAuth 2.0.

  15. Selecciona Generar y anota el ID de cliente y el secreto que se generan, ya que necesitarás esta información para configurar el proveedor de recursos X en AgentCore Identity.

nota

X solo muestra el secreto completo del cliente cuando se genera. Si pierdes esta información, tendrás que volver a generar el secreto del cliente en el portal para desarrolladores de X.

Para obtener más información, consulta la documentación de OAuth 2.0 de X.

Paso 2: Crear el proveedor de credenciales de AgentCore identidad

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

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

La CreateOauth2CredentialProvider respuesta 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 de devolución de llamada única con X

Vuelve a la consola para desarrolladores de X y añade la URL de devolución de llamada única a la lista de URI de redireccionamiento de tu aplicación OAuth2.

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

  2. Agregue el callbackUrl valor devuelto por CreateOauth2CredentialProvider a la configuración de URI de redireccionamiento de la aplicación.

  3. Guarde los cambios.