View a markdown version of this page

GitHub - Amazon Bedrock AgentCore
아웃바운드

GitHub

GitHub는 아웃바운드 리소스 액세스를 위한 AgentCore 자격 증명 공급자로 구성할 수 있습니다. 이를 통해 에이전트는 GitHub의 OAuth2 서비스를 통해 사용자를 인증하고 GitHub API 리소스에 대한 액세스 토큰을 얻을 수 있습니다.

아웃바운드

참고

AgentCore 자격 증명은 생성한 각 자격 증명 공급자에 대해 고유한 OAuth2 콜백 URL을 발급합니다. 고유한 콜백 URL을 사용하면 세션 바인딩이 가능하여 권한 부여 응답을 시작한 특정 자격 증명 공급자에 대해서만 사용할 수 있도록 하여 교차 공급자 재생 및 CSRF 스타일 공격으로부터 OAuth2 권한 부여 코드 교환을 보호합니다. URL은 공급자별로 고유하므로를 호출할 때까지 URL을 알 수 없습니다CreateOauth2CredentialProvider. 먼저 GitHub OAuth2 클라이언트를 생성한 다음 AgentCore Identity가 콜백 URL을 발급한 후 GitHub 개발자 콘솔로 돌아가 콜백 URL을 등록합니다.

1단계: GitHub OAuth2 클라이언트 생성

다음 절차에 따라 GitHub OAuth2 애플리케이션을 설정하고 AgentCore 자격 증명에 필요한 클라이언트 자격 증명을 가져옵니다. AgentCore 자격 증명이 고유한 콜백 URL을 발급한 후 3단계에서 리디렉션 URI를 등록합니다.

GitHub OAuth2 애플리케이션을 구성하려면

  1. github 계정의 프로필 사진을 선택하고 설정을 선택합니다.

  2. 개발자 설정을 선택합니다.

  3. OAuth 앱을 선택합니다.

  4. OAuth2 앱 페이지에서 새 OAuth 앱을 선택합니다.

  5. 애플리케이션과 관련된 필수 세부 정보를 입력합니다. 지금은 권한 부여 콜백 URL 필드를 비워 둡니다. 3단계에서 고유한 콜백 URL을 추가합니다.

  6. 애플리케이션 등록을 선택하여 Github OAuth 앱을 생성합니다.

  7. Github의 OAuth 앱 페이지에서 새로 생성된 공급자로 이동합니다.

  8. 클라이언트 보안 암호 섹션에서 새 클라이언트 보안 암호 생성을 선택합니다.

  9. 새로 생성된 클라이언트 보안 암호를 기록해 둡니다. AgentCore 자격 증명으로 Github 애플리케이션을 구성하려면이 값이 필요합니다.

    참고

    Github는 생성 시 전체 보안 암호만 반환합니다. 이를 추적하지 못하면 클라이언트 보안 암호를 다시 생성하여 AgentCore 자격 증명에서 공급자를 구성해야 합니다.

자세한 내용은 Github의 설명서 OAuth 앱 생성을 참조하세요.

2단계: AgentCore 자격 증명 공급자 생성

아웃바운드 GitHub 리소스 공급자를 구성하려면 다음을 사용합니다.

{
        "name": "NAME",
        "credentialProviderVendor": "GithubOauth2",
        "oauth2ProviderConfigInput": {
            "GithubOauth2ProviderConfigInput": {
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
            }
        },
    }

CreateOauth2CredentialProvider 응답에는 callbackUrl 필드가 포함됩니다. 이 URL은이 자격 증명 공급자에 고유하며 다음과 같습니다https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. 다음 단계를 위해이 값을 저장합니다.

3단계: GitHub에 고유한 콜백 URL 등록

GitHub 개발자 콘솔로 돌아가 OAuth2 애플리케이션의 리디렉션 URI 목록에 고유한 콜백 URL을 추가합니다.

  1. GitHub 개발자 콘솔에 로그인하고 1단계에서 생성한 OAuth2 애플리케이션을 엽니다.

  2. 에서 반환한 callbackUrl 값을 애플리케이션의 CreateOauth2CredentialProvider 리디렉션 URI 구성에 추가합니다.

  3. 변경 내용을 저장합니다.