AWS bedrock-agentcore high security documentation change
Summary
Updated Spotify integration documentation to require registering a unique callback URL per credential provider instead of a fixed URL. Added security note about session binding protection against replay and CSRF attacks.
Security assessment
The change explicitly adds security documentation about session binding protection against cross-provider replay and CSRF attacks. It modifies the workflow to use unique callback URLs, which is a security measure to prevent authorization code interception and replay attacks.
Diff
diff --git a/bedrock-agentcore/latest/devguide/identity-idp-spotify.md b/bedrock-agentcore/latest/devguide/identity-idp-spotify.md index 16a4226a7..5b3dde609 100644 --- a//bedrock-agentcore/latest/devguide/identity-idp-spotify.md +++ b//bedrock-agentcore/latest/devguide/identity-idp-spotify.md @@ -15 +15 @@ Spotify can be configured as an AgentCore Identity credential provider for outbo -**Step 1** +###### Note @@ -17 +17,5 @@ Spotify can be configured as an AgentCore Identity credential provider for outbo -Use the following procedure to set up a Spotify OAuth2 application and obtain the necessary client credentials for AgentCore Identity. +AgentCore Identity issues a unique OAuth2 callback URL for each credential provider you create. The unique callback URL enables session binding, which protects the OAuth2 authorization-code exchange against cross-provider replay and CSRF-style attacks by ensuring an authorization response can only be redeemed against the specific credential provider that initiated it. Because the URL is unique per provider, you won’t know it until **after** you call `CreateOauth2CredentialProvider`. Create your Spotify OAuth2 client first, then return to the Spotify developer console to register the callback URL once AgentCore Identity has issued it. + +**Step 1: Create the Spotify OAuth2 client** + +Use the following procedure to set up a Spotify OAuth2 application and obtain the necessary client credentials for AgentCore Identity. You will register the redirect URI in Step 3, after AgentCore Identity issues the unique callback URL. @@ -27,3 +31 @@ Use the following procedure to set up a Spotify OAuth2 application and obtain th - 4. Use the following as the **Redirect URI** for your application: - - https://bedrock-agentcore.region.amazonaws.com/identities/oauth2/callback + 4. Leave the **Redirect URI** field empty for now — you will add the unique callback URL in Step 3. @@ -42 +44 @@ Use the following procedure to set up a Spotify OAuth2 application and obtain th -**Step 2** +**Step 2: Create the AgentCore Identity credential provider** @@ -57,0 +60,15 @@ To configure Spotify as an outbound resource provider, use the following: +The [CreateOauth2CredentialProvider](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html) response includes a `callbackUrl` field. This URL is unique to this credential provider and looks like: `https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`. Save this value for the next step. + +**Step 3: Register the unique callback URL with Spotify** + +Return to the Spotify developer console and add the unique callback URL to your OAuth2 application’s redirect URI list. + + 1. Sign in to the Spotify developer console and open the OAuth2 application you created in Step 1. + + 2. Add the `callbackUrl` value returned by `CreateOauth2CredentialProvider` to the application’s redirect URI configuration. + + 3. Save your changes. + + + +