View a markdown version of this page

개념 - Amazon Bedrock AgentCore
아웃바운드

개념

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

아웃바운드

참고

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

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

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

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

  1. https://www.notion.so/my-integrations를 엽니다.

  2. + 새 통합을 선택합니다.

  3. 퍼블릭 통합을 선택합니다.

  4. 통합 이름을 입력합니다.

  5. 제출을 선택합니다.

  6. 통합 세부 정보 페이지에서 OAuth 도메인 및 URIs 섹션을 엽니다. 지금은 리디렉션 URI 목록을 비워 둡니다. 3단계에서 고유한 콜백 URL을 추가합니다.

  7. AgentCore 자격 증명에서 Notion 리소스 공급자를 구성하려면이 정보가 필요하므로 OAuth 클라이언트 ID와 OAuth 클라이언트 암호를 기록합니다.

자세한 내용은 Notion의 권한 부여 설명서를 참조하세요.

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

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

{
  "name": "Notion",
  "credentialProviderVendor": "NotionOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "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단계: Notion에 고유한 콜백 URL 등록

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

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

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

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