View a markdown version of this page

Dropbox - Amazon Bedrock AgentCore
아웃바운드

Dropbox

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

참고

Dropbox는 M2M/클라이언트 자격 증명 흐름을 지원하지 않습니다.

아웃바운드

참고

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

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

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

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

  1. Dropbox용 개발자 앱 콘솔을 엽니다.

  2. 앱 생성을 선택합니다.

  3. 범위가 지정된 액세스를 선택합니다.

  4. 액세스 유형에서 애플리케이션에 적합한 액세스 유형을 선택합니다.

  5. 애플리케이션의 이름을 제공합니다.

  6. 앱 생성을 선택합니다.

  7. 앱 개요 페이지에서 OAuth2 섹션을 엽니다. 지금은 리디렉션 URI 목록을 비워 둡니다. 3단계에서 고유한 콜백 URL을 추가합니다.

  8. 동일한 섹션에서 퍼블릭 클라이언트 허용(암시적 권한 부여 및 PKCE) 아래의 드롭다운을 선택하고 옵션에서 허용 안 함을 선택합니다.

  9. AgentCore 자격 증명에서 Dropbox 리소스 공급자를 구성하는 데 정보가 필요하므로 앱 키와 앱 암호를 기록합니다.

  10. 애플리케이션의 권한 탭에서 애플리케이션에 필요한 범위를 선택합니다.

자세한 내용은 Dropbox의 OAuth 구현 가이드를 참조하세요.

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

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

{
  "name": "DropBox",
  "credentialProviderVendor": "DropboxOauth2",
  "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단계: Dropbox에 고유한 콜백 URL 등록

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

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

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

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