View a markdown version of this page

GitHub - 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.

GitHub

GitHub se puede configurar como 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 GitHub del servicio OAuth2 y obtener tokens de acceso para los recursos de la API. GitHub

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 GitHub OAuth2 y, a continuación, vuelve a la consola del GitHub desarrollador para registrar la URL de devolución de llamada una vez que AgentCore Identity la haya emitido.

Paso 1: Crea el cliente OAuth2 GitHub

Utilice el siguiente procedimiento para configurar una aplicación GitHub 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 GitHub OAuth2

  1. Elige la imagen de perfil de tu cuenta de github y elige Configuración.

  2. Elige la configuración del desarrollador.

  3. Selecciona Aplicaciones de OAuth.

  4. En la página de aplicaciones de OAuth2, selecciona Nueva aplicación de OAuth.

  5. Introduce los detalles necesarios específicos de tu aplicación. Deje vacío el campo URL de devolución de llamada de autorización por ahora; añadirá la URL de devolución de llamada única en el paso 3.

  6. Selecciona Registrar aplicación para crear tu aplicación Github OAuth.

  7. En la página de aplicaciones OAuth de Github, ve a tu proveedor recién creado.

  8. En la sección de secretos del cliente, elige Generar un nuevo secreto de cliente.

  9. Anota el secreto del cliente recién creado. Lo necesitarás para configurar tu aplicación de Github con AgentCore Identity.

    nota

    Github solo devuelve el secreto completo cuando se crea. Si lo pierdes de vista, tendrás que volver a crear el secreto del cliente para configurar el proveedor en AgentCore Identity.

Para obtener más información, consulta la documentación de Github Cómo crear una aplicación OAuth.

Paso 2: Crear el proveedor de credenciales de AgentCore identidad

Para configurar el proveedor de GitHub recursos salientes, utilice lo siguiente:

{
        "name": "NAME",
        "credentialProviderVendor": "GithubOauth2",
        "oauth2ProviderConfigInput": {
            "GithubOauth2ProviderConfigInput": {
                "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 GitHub

Vuelve a la consola del GitHub desarrollador 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 GitHub desarrolladores 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.