

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 概念
<a name="identity-idp-notion"></a>

可以将 Notion 配置为用于出站资源访问的 AgentCore 身份凭证提供商。这允许您的代理通过 Notion 的 OAuth2 服务对用户进行身份验证，并获取 Notion API 资源的访问令牌。

## 出站
<a name="identity-idp-notion-outbound"></a>

**注意**  
AgentCore Identity 会为您创建的每个凭证提供商颁发唯一的 OAuth2 回调 URL。独特的回调 URL 支持会话绑定，通过确保授权响应只能针对发起该请求的特定凭证提供商进行兑换，从而保护 OAuth2 授权码交换免受跨提供商重放和 CSRF-style 攻击。由于每个提供商的网址都是唯一的，所以你要等到打电话**之后才**会知道`CreateOauth2CredentialProvider`。首先创建你的 Notion OAuth2 客户端，然后在 Ident AgentCore ity 发布回调网址后返回到 Notion 开发者控制台注册回调 URL。

 **第 1 步：创建 Notion OAuth2 客户端 ** 

使用以下步骤设置 Notion OAuth2 应用程序并获取身份所需的客户端凭证。 AgentCore 在 I AgentCore dentity 发布唯一回调 URL 后，您将在步骤 3 中注册重定向 URI。

 **配置 Notion OAuth2 应用程序 ** 

1. 打开 [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)。

1. 选择 ** \+ 新建集成**。

1. 选择 “**公共集成” **。

1. 为您的集成提供一个名称。

1. 选择**提交**。

1. 在集成详情页面上，打开 ** OAuth 域名和 URI ** 部分。暂时将重定向 URI 列表留空——您将在步骤 3 中添加唯一的回调 URL。

1. 记录 OAuth 客户端 ID 和 OAuth 客户端密钥，因为您需要这些信息才能在 Identity 中配置 Notion 资源提供商。 AgentCore 

有关更多详细信息，请参阅 [ Notion 的授权文档](https://developers.notion.com/docs/authorization)。

 **第 2 步：创建 AgentCore 身份凭证提供商 ** 

要将 Notion 配置为出站资源提供商，请使用以下方法：

```
{
  "name": "Notion",
  "credentialProviderVendor": "NotionOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}
```

[CreateOauth2CredentialProvider](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html)响应包含一个`callbackUrl`字段。此网址是该凭证提供商所独有的，看起来像:`https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`. 保存此值以供下一步使用。

 **第 3 步：使用 Notion 注册唯一的回调 URL ** 

返回 Notion 开发者控制台，将唯一的回调 URL 添加到 OAuth2 应用程序的重定向 URI 列表中。

1. 登录 Notion 开发者控制台，打开您在步骤 1 中创建的 OAuth2 应用程序。

1. 将返回的`callbackUrl`值添加到应用程序的重定向 URI 配置中。`CreateOauth2CredentialProvider`

1. 保存更改。