人工智能
通过 Amazon Bedrock AgentCore 为 Snowflake Cortex AI 提供安全的 OAuth 模式如今,企业需要一种清晰的方式,将身份验证和授权控制扩展到智能体层,这通常需要宽泛的服务账户权限,或需要自定义构建的认证集成,从而增加运维开销。当运行在 Amazon Bedrock AgentCore (一个可使用任意框架或模型大规模构建、连接和优化智能体的平台)上的 AI 智能体需要通过 Model Context Protocol (MCP)调用 Snowflake 托管的 MCP 服务器 (该服务器将 Snowflake Cortex Agents 作为其工具类型之一对外提供)时,企业必须回答的第一个问题是:智能体如何进行身份验证?在本文中,我们将介绍我们在 Amazon Bedrock AgentCore Identity(Amazon Bedrock AgentCore 的一项能力)上测试的三种开放授权(OAuth)配置:Snowflake OAuth(按用户,无需外部身份提供商,即 IdP)、使用第三方身份提供商的三腿 OAuth(企业单点登录,即 SSO),以及使用第三方身份提供商的两腿 OAuth(共享服务用户)。Amazon Bedrock AgentCore Identity 还支持代表(OBO)授权(TOKEN_EXCHANGE),可为无人值守工作负载提供按用户身份,且无需同意提示。我们重点介绍我们端到端测试的三种配置,并在过程中说明 OBO 的适用场景。读完后,您将能够确定哪种模式适合您的企业场景。
解决方案概述
Amazon Bedrock AgentCore Gateway(Amazon Bedrock AgentCore 的一项能力)通过 MCP 服务器目标将 AI 智能体连接到外部工具提供商。它以 Snowflake 托管的 MCP 服务器为目标,该服务器将 Cortex Search 和 Cortex Analyst 作为 MCP 工具对外提供,支持 MCP 的客户端可以发现并调用这些工具。Gateway 并不充当包装器,而是将其配置目标的各项能力聚合到一个统一目录中,并以单个 tools/list 响应的形式呈现给智能体。
本文的核心关注点是 Amazon Bedrock AgentCore Gateway 的 出站身份验证 :它如何获取 OAuth 令牌并将其呈现给 Snowflake 托管的 MCP 服务器。Amazon Bedrock AgentCore Identity 充当凭证代理:Gateway 通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌(因为 Gateway 使用 JSON Web Token(JWT)入站身份验证),然后针对已配置的提供商调用 GetResourceOauth2Token。AgentCore Identity 负责令牌保管库、令牌刷新和用户与令牌的绑定,并自动获取、缓存和刷新令牌。
Amazon Bedrock AgentCore Identity 支持三种 OAuth 配置,涵盖两种授权类型(authorization_code 和 client_credentials):
- Snowflake OAuth:Snowflake 作为其自身的 OAuth 授权服务器。每个用户通过授权码授权(3LO)直接向 Snowflake 进行身份验证。无需外部身份提供商。
- 使用第三方身份提供商的三腿 OAuth:用户通过企业 SSO 使用授权码授权进行身份验证。Snowflake 通过其 External OAuth 安全集成信任 IdP 签发的 JSON Web Token(JWT)。
- 使用第三方 IdP 的两腿 OAuth 模式:共享服务用户通过 IdP 的 client_credentials 授权进行身份验证。无需用户交互或同意,非常适合机器对机器工作负载。
Amazon Bedrock AgentCore Identity 还提供 API 密钥凭证提供商(支持 Snowflake 编程访问令牌)。我们在此重点关注 OAuth,以实现按用户归因和自动令牌刷新。每种配置都使用 Amazon Bedrock AgentCore Identity 中的凭证提供商(CustomOauth2、OktaOauth2 或 MicrosoftOauth2)以及 Snowflake 侧相应的安全集成。
注意: 我们使用 Okta 和 Microsoft Entra ID 对 Snowflake 托管的 MCP 服务器测试了这些模式。模式 2 和模式 3(外部 IdP)遵循标准 OAuth 流程,因此可以扩展到其他受 OAuth 保护的 MCP 服务器,但请针对您的 SaaS 提供商验证令牌声明、范围和受众设置。只有模式 1 是 Snowflake 特有的,因为它依赖 Snowflake 内置的 OAuth 授权服务器。Snowflake 特有的元素包括 OAUTH_AUTHORIZATION_SERVER 的 issuer-lock 参数、session:role: / session:scope: 语法、BLOCKED_ROLES_LIST、LOGIN_NAME / EMAIL_ADDRESS 映射以及 QUERY_HISTORY 归因。如果您的 SaaS 提供自己的内部 OAuth 服务器,您可以像配置 Snowflake OAuth 一样配置出站 OAuth。
| 模式 | OAuth 授权 | AgentCore Identity 凭证提供商供应商 | Snowflake 安全集成 | Snowflake 查询身份映射 |
| Snowflake OAuth – 3LO | authorization_code | 自定义提供商(CustomOauth2) | TYPE = OAUTH, OAUTH_CLIENT = CUSTOM | 真实用户及其分配的角色 |
| 使用外部 IdP 的 3LO | authorization_code | 内置提供商(如 OktaOauth2、MicrosoftOauth2) | TYPE = EXTERNAL_OAUTH + OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT / DATABASE / SCHEMA 设置);EXTERNAL_OAUTH_TYPE = OKTA / AZURE / PING_FEDERATE / CUSTOM | 真实用户及其分配的角色 |
| 使用外部 IdP 的 2LO | client_credentials | 内置提供商(如 OktaOauth2、MicrosoftOauth2)或 CustomOauth2 | TYPE = EXTERNAL_OAUTH + OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT / DATABASE / SCHEMA 设置);EXTERNAL_OAUTH_TYPE = OKTA / AZURE / PING_FEDERATE / CUSTOM | 共享的 Snowflake 服务用户 |
说明:
- 2LO 不需要内置供应商。使用 CLIENT_CREDENTIALS 授权的 CustomOauth2 可与您选择的 OAuth 2.0 授权服务器配合使用。
- 当 Amazon Bedrock AgentCore Gateway 代理令牌时(即本文中的模式),Snowflake 通过 TYPE = EXTERNAL_OAUTH 安全集成对其进行验证。设置 OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT、DATABASE 或 SCHEMA)可使直接 MCP 客户端通过受保护资源元数据端点自动发现您的 IdP,并将 MCP 端点 issuer-lock 到该集成。
- 如果将 OAUTH_AUTHORIZATION_SERVER 设置为将某个 MCP 范围 issuer-lock 到外部 IdP(模式 2),则该范围内 MCP 服务器的 Snowflake OAuth 令牌(模式 1)会被拒绝,且不会回退。如果需要在同一账户中使用这两种模式,请按 schema 或数据库设置此参数,使每个范围解析到正确的授权服务器。
解决方案架构
下图展示了我们构建的解决方案及其使用的组件:面向用户的 AI 应用、 Strands 智能体 (运行于 Amazon Bedrock AgentCore Runtime,这是 Amazon Bedrock AgentCore 的一项能力)、 Amazon Bedrock (用于推理,并通过 Amazon Bedrock Guardrails 对提示和响应中的个人身份信息(PII)进行脱敏)、 Amazon Bedrock Knowledge Bases(完全托管的检索增强生成(RAG)能力,基于 Amazon Simple Storage Service(Amazon S3)中的策略文档)、以 Snowflake 托管的 MCP 服务器为目标的 Amazon Bedrock AgentCore Gateway,以及持有令牌保管库的 Amazon Bedrock AgentCore Identity。三种模式下的出站 OAuth 路径形态相同:Gateway 通过 AgentCore Identity 解析令牌,后者从授权服务器获取并续期令牌,然后 Gateway 将该令牌呈现给 Snowflake 托管的 MCP 服务器。各模式之间的差异在于由哪个授权服务器签发令牌以及采用哪种授权类型:Snowflake 自带的 OAuth 服务器,或第三方 IdP。这些差异在模式对比表中列出,每种模式的运行时流程在本文后面的各自时序图中展示。
图 1:解决方案概览:运行在 Amazon Bedrock AgentCore 上的参考智能体,通过 Snowflake 托管的 MCP 服务器将 Amazon Bedrock Knowledge Bases 与 Snowflake Cortex AI 相结合,以及三种 OAuth 模式中各不相同的那一个授权服务器
模式分析
以下各节详细分析每种模式:身份验证流程、配置步骤和权衡取舍,以帮助您为用例选择合适的方法。
模式 1:Snowflake OAuth(三腿)
Snowflake OAuth 模式使用三腿 OAuth(3LO)流程,无需外部身份提供商即可实现按用户身份验证。每个用户使用自己的凭证向 Snowflake 进行身份验证,同意使用特定的 Snowflake 角色,Amazon Bedrock AgentCore Identity 会缓存该用户的访问令牌和刷新令牌。之后每次调用 Snowflake 都以该用户身份执行,QUERY_HISTORY 会记录其真实用户名。请注意,按角色同意并非默认行为。Snowflake 托管的 MCP 服务器会声明 session:role:all 并回退到 DEFAULT_ROLE,因此您需要设置 OAUTH_SCOPES_SUPPORTED(通过 ALTER 设置的账户级、数据库级或 schema 级参数)来收窄服务器声明的角色范围,并限制集成上的 ALLOWED_ROLES_LIST 以强制规定用户可同意哪些角色(PRE_AUTHORIZED_ROLES_LIST 则相反:它列出跳过同意步骤的角色)。
这种模式的吸引力在于其简单性:不需要外部身份提供商。Snowflake 同时充当授权服务器和资源服务器,公开其自带的 OAuth 端点(/oauth/authorize 和 /oauth/token-request)。设置需遵循特定顺序,因为在创建凭证提供程序之前回调 URL 并不存在。管理员首先在 Amazon Bedrock AgentCore Identity 中使用占位客户端凭证创建 CustomOauth2 凭证提供程序,并记录 AgentCore Identity 返回的 callbackUrl。然后,将该 callbackUrl 注册为使用 TYPE = OAUTH 和 OAUTH_CLIENT = CUSTOM 创建的 Snowflake 安全集成上的重定向 URI。最后,管理员使用 Snowflake 签发的真实客户端 ID 和密钥更新凭证提供程序,并使用显式授权服务器元数据配置该提供程序的 oauthDiscovery:issuer(Snowflake 账户 URL)、授权端点(/oauth/authorize)和令牌端点(/oauth/token-request)。
以下截图展示了在 Amazon Bedrock AgentCore Identity 中配置凭证提供程序供应商及 Snowflake OAuth(3LO)设置的步骤。
图 2:在 Amazon Bedrock AgentCore Identity 中配置 Snowflake OAuth(3LO)凭证提供程序供应商
接下来,Amazon Bedrock AgentCore Gateway 配置指向 Snowflake 托管的 MCP 服务器端点,并引用自定义 Snowflake OAuth 作为出站身份验证。
图 3:Amazon Bedrock AgentCore Gateway 配置,指向 Snowflake 托管的 MCP 服务器端点,并以 Snowflake OAuth(3LO)作为出站身份验证
以下时序图展示了 Snowflake OAuth 模式的运行时授权流程。
图 4:Snowflake OAuth(3LO)运行时授权流程:采用 AUTHORIZATION_CODE 授权的 Amazon Bedrock AgentCore Gateway MCP 服务器目标、按用户的 Snowflake OAuth,以及 session:role:ANALYST_ROLE 范围
以下 Snowflake OAuth 授权流程 的工作方式如下:
- 当工具调用需要 Snowflake 令牌时,Amazon Bedrock AgentCore Gateway 通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并调用 GetResourceOauth2Token 在 Amazon Bedrock AgentCore Identity 的令牌保管库中检查该用户的令牌。如果没有缓存的令牌,Gateway 会返回一个 JSON-RPC 错误码 -32042 ,其中携带 URL 引导。该授权 URL 属于 AgentCore Identity,并且是
session-URI-bound。客户端在用户浏览器中打开该 URL,该 URL 被路由到 Snowflake 自带的授权服务器(/oauth/authorize),并显示 Snowflake 登录界面。 - 用户输入其 Snowflake 凭证,随后会看到同意屏幕,要求其授权使用特定 Snowflake 角色(例如 ANALYST_ROLE)进行访问。请求范围中的角色名称必须为大写(例如 session:role:ANALYST_ROLE)。
- 用户同意后,Snowflake 的授权服务器会向 Amazon Bedrock AgentCore Identity 的回调 URL 返回授权码。随后,AgentCore Identity 会将用户浏览器重定向到带有会话 URI 的返回 URL。
- AgentCore Identity 仅在应用程序使用用户身份和会话 URI(有效期为 10 分钟)调用 CompleteResourceTokenAuth 后才会完成代码交换。此步骤将代码绑定到发起请求,并阻止授权 URL 劫持。此处使用的返回 URL 通过调用 UpdateWorkloadIdentity 注册。在生产环境中,该 URL 处的端点由您的 Web 应用程序托管,或者对于具有 JWT 入站身份验证的网关,由 AgentCore Identity 同意门户(
<portal-url>/connect/callback)。agentcore dev CLI 仅在本地开发时托管它。随后,AgentCore Identity 在 Snowflake 的令牌端点(/oauth/token-request)处用该代码交换访问令牌,并可选地交换刷新令牌。 - 当客户端重试工具调用时,Amazon Bedrock AgentCore Gateway 会从 AgentCore Identity 检索缓存的访问令牌,并将其提交给由 Snowflake 托管的 MCP 服务器。Snowflake 验证该令牌,并创建一个限定在已同意角色范围内的用户会话。已同意的范围控制着 角色。由于辅助角色由集成控制,请将 OAUTH_USE_SECONDARY_ROLES 设置为 NONE(默认值),这样会话所携带的权限就不会超过已同意的角色,而 IMPLICIT 设置则允许这种情况。访问令牌的有效期很短。默认情况下,有效期为 600 秒(最长 3600 秒)。当访问令牌过期时,Amazon Bedrock AgentCore Identity 会自动使用刷新令牌获取新的访问令牌,无需用户交互。如果安全集成 角色。由于辅助角色由集成控制,请将 OAUTH_USE_SECONDARY_ROLES 设置为 NONE(默认值),这样会话所携带的权限就不会超过已同意的角色,而 IMPLICIT 设置则允许这种情况。
访问令牌的有效期很短。默认情况下,有效期为 600 秒(最长 3600 秒)。当访问令牌过期时,Amazon Bedrock AgentCore Identity 会自动使用刷新令牌获取新的访问令牌,无需用户交互。如果安全集成被配置为禁止刷新令牌,用户必须通过同意屏幕重新授权。刷新令牌的生命周期由 OAUTH_REFRESH_TOKEN_VALIDITY 控制。参考实现将其设置为 86400 秒(1 天),而 Snowflake 允许最长 90 天。OAUTH_ISSUE_REFRESH_TOKENS(默认值为 TRUE)决定是否签发刷新令牌。
注意: 默认情况下,Snowflake 会帮助防止 ACCOUNTADMIN、ORGADMIN、GLOBALORGADMIN 和 SECURITYADMIN 角色与 OAuth 集成一起使用。这由 Snowflake OAuth 的 BLOCKED_ROLES_LIST(以及 External OAuth 的 EXTERNAL_OAUTH_BLOCKED_ROLES_LIST)控制,适用于全部三种模式,并且仅涵盖主角色。当 OAUTH_USE_SECONDARY_ROLES = IMPLICIT 时,辅助角色仍可携带这些特权角色。
注意事项
Snowflake OAuth 模式是实现按用户审计追踪的最简单途径。它无需外部 IdP 配置,也无需额外的供应商依赖。它最适合以下场景:
- 用户已经拥有 Snowflake 凭证,并且习惯直接登录。
- 你希望在 QUERY_HISTORY 中实现按用户归属,而不依赖外部身份提供商。
- 你正处于概念验证阶段,希望快速验证按用户模型。
- 合规要求强制实行个人问责制,因此每个查询都必须可追溯到具体用户,而不能是共享的服务用户。
- 你倾向于完全在 Snowflake 内管理用户生命周期(预配、取消预配、角色授予)。
- 你希望避免令牌声明映射的复杂性。Snowflake 签发令牌,并确切知道它们代表哪个用户。
模式 2:使用第三方身份提供商(IdP)的三腿 OAuth(3LO)
此模式将按用户身份验证与企业单点登录相结合。用户通过外部 IdP 登录,由该 IdP 强制执行多因素身份验证(MFA)、条件访问和会话策略。IdP 签发的 JWT 会提交给 Snowflake,Snowflake 通过其 外部 OAuth 安全集成 (可选地通过 OAUTH_AUTHORIZATION_SERVER 将签发者锁定到 MCP 服务器的 schema、数据库或账户)。Snowflake 通过 JSON Web Key Set(JWKS)验证签发者、受众和签名。然后,它将一个可配置的声明(通过 EXTERNAL_OAUTH_TOKEN_USER_MAPPING_CLAIM 设置,对于 Okta,upn 用于 Microsoft Entra ID),映射到 Snowflake 用户的 LOGIN_NAME 或 EMAIL_ADDRESS(配合 EXTERNAL_OAUTH_SNOWFLAKE_USER_MAPPING_ATTRIBUTE),并以该用户身份运行查询。安全集成参数值区分大小写。
与模式 1 的关键区别在于:授权服务器是你的企业 IdP(例如 Okta、Microsoft Entra ID),而不是 Snowflake。Snowflake 仍然是资源服务器。用户使用他们访问其他所有企业应用时所用的同一套凭证和策略进行身份验证。无需单独的 Snowflake 密码。
在 Amazon Bedrock AgentCore 一侧,Amazon Bedrock AgentCore Identity 为常用身份提供商提供了内置的凭证提供程序供应商(例如 OktaOauth2 和 MicrosoftOauth2)。与模式 1 中使用的通用 CustomOauth2 提供程序相比,这些供应商通过 includedOauth2ProviderConfig 接受客户端 ID、客户端密钥和 IdP 端点。Snowflake 托管的 MCP 服务器使用预先注册的 OAuth 客户端,因此你需要提前注册每个客户端 ID 和密钥,这就是为什么必须遵循创建、记录 callbackUrl、注册、更新的顺序。
图 5:在 Amazon Bedrock AgentCore Identity 中配置 Okta OAuth(三腿)凭证提供程序供应商
接下来,Amazon Bedrock AgentCore Gateway 配置指向由 Snowflake 托管的 MCP 服务器端点,并引用 Okta 凭证提供程序进行出站身份验证。
图 6:Amazon Bedrock AgentCore Gateway 配置,指向由 Snowflake 托管的 MCP 服务器端点,并以 Okta 三腿 OAuth 作为出站身份验证
下图展示了使用外部 IdP 的三腿 OAuth 模式的运行时授权流程。
图 7:带外部 IdP 的 3LO 运行时授权流程:以 AUTHORIZATION_CODE 授权类型和第三方 IdP 出站身份验证为目标的 Amazon Bedrock AgentCore Gateway MCP 服务器
Snowflake 的外部 OAuth 安全集成流程如下:
- 当工具调用需要 Snowflake 令牌时,Amazon Bedrock AgentCore Gateway 会通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并调用 GetResourceOauth2Token 在 Amazon Bedrock AgentCore Identity 的令牌保管库中检查该用户的令牌。如果没有缓存令牌,Gateway 会返回携带 URL 引导的 JSON-RPC 错误码 -32042。该授权 URL 属于 AgentCore Identity,而不是 IdP 的。
session-URI-bound而不是 IdP 的。客户端在用户浏览器中打开该 URL,AgentCore Identity 将用户路由到 IdP。 - 用户通过第三方 IdP 使用企业 SSO(包括 MFA)进行身份验证,并同意所请求的作用域。对于 Okta,角色作用域的形式为 session:role:ANALYST_ROLE。Microsoft Entra ID 委托流则使用 session:scope:。
- IdP 将授权码返回到 Amazon Bedrock AgentCore Identity 的回调 URL,随后 AgentCore Identity 将用户浏览器重定向到带有会话 URI 的返回 URL。只有在应用程序调用 CompleteResourceTokenAuth 验证用户身份和会话 URI 之后,AgentCore Identity 才会用该授权码换取访问令牌(如果 IdP 签发刷新令牌,则还包括刷新令牌),并将它们缓存在按用户划分的令牌保管库中。
- 当客户端重试工具调用时(以及在后续调用中),Amazon Bedrock AgentCore Gateway 会从 Amazon Bedrock AgentCore Identity 检索缓存的由 IdP 签发的 JWT,并将其呈现给由 Snowflake 管理的 MCP 服务器。Snowflake 通过其外部 OAuth 集成验证该令牌:它会验证 JWKS 签名和受众(aud)声明,将配置的用户声明(Okta 为 sub,Microsoft Entra ID 为 upn)映射到 Snowflake 用户,并以该已认证用户的身份执行查询。Snowflake 在运行时不会调用 IdP。它使用 IdP 发布的 JWKS 签名密钥在本地验证令牌。
- 当访问令牌过期时,Amazon Bedrock AgentCore Identity 会使用缓存的刷新令牌自动刷新它(如果已签发刷新令牌;对于 Okta,请请求 offline_access 作用域)。在刷新令牌过期之前,无需用户交互。
令牌生命周期治理:与 Snowflake 控制令牌生命周期的模式 1 不同,访问令牌和刷新令牌的生命周期由 IdP 管理,Amazon Bedrock AgentCore Identity 会透明地处理刷新。如果签发了刷新令牌,用户仅在刷新令牌过期时(依据 IdP 的会话策略)才需要重新认证。否则,用户会在访问令牌过期时重新认证。
注意事项
在以下情况下,选择使用第三方 IdP 的三腿 OAuth(3LO):
- 当您的组织或安全团队要求所有身份验证都通过企业 SSO 进行,以实现集中式 MFA、条件访问和会话管理时。
- 当您希望使用 IdP 现有的功能(例如基于组的角色映射、会话超时策略和基于地理位置的条件访问规则)时。
- 你需要在 Snowflake 的 QUERY_HISTORY 中获取按用户划分的审计追踪。
- 你希望在所有应用程序(包括 AI 代理)中统一执行安全策略。
- 你需要集中式访问控制。在 IdP 中禁用用户有助于阻止新的 Snowflake 授权,不过缓存的令牌在过期前仍然有效。要强制用户重新授权,应用程序可以在下一次请求时传入 forceAuthentication=true,这会清除已存储的刷新令牌并启动新的授权流程。要彻底撤销访问权限,请在 IdP 或 Snowflake 中撤销授权。
模式 3:使用第三方身份提供商(IdP)的两腿 OAuth(2LO)
两腿 OAuth 模式使用 OAuth 2.0 的 client_credentials 授权。这是一种无需用户交互的机器对机器流程。Amazon Bedrock AgentCore Identity 使用配置的客户端 ID 和客户端密钥从 IdP 获取 JWT,Amazon Bedrock AgentCore Gateway 将其提交给 Snowflake,Snowflake 则以共享服务用户的身份执行请求,无论查询是由哪个最终用户发起的。
这种模式在运维上最为直接:没有同意屏幕,没有按用户划分的令牌保管库,也没有浏览器重定向。用户遵循相同的代码路径。Amazon Bedrock AgentCore Identity 会自动获取并缓存 client_credentials 令牌,Amazon Bedrock AgentCore Gateway 在每次向 Snowflake 托管的 MCP 服务器发起出站调用时都会出示该令牌。
与模式 1 和模式 2 的关键区别在于:不存在按用户划分的身份传播。Snowflake 的 QUERY_HISTORY 会为查询记录单一的服务用户。其代价是牺牲按用户划分的审计粒度,以换取运维上的简便性。在 Amazon Bedrock AgentCore 一侧,凭证提供程序使用 client_credentials 授权类型:可以是内置供应商(OktaOauth2、MicrosoftOauth2),也可以是通用的 CustomOauth2 提供程序。配置需要 IdP 的令牌端点、客户端 ID 和客户端密钥。Amazon Bedrock AgentCore Identity 会在首次工具调用时(即 Gateway 调用 GetResourceOauth2Token 时)从 IdP 获取令牌并缓存;由于 client_credentials 不签发刷新令牌,它会在令牌过期前请求一个新令牌。无需对代理级代码做任何更改。
图 8:在 Amazon Bedrock AgentCore Identity 中配置 client_credentials(两腿)凭证提供程序供应商
接下来,Amazon Bedrock AgentCore Gateway 配置会引用由 Snowflake 托管的 MCP 服务器端点,以及用于出站身份验证的两腿 OAuth 凭证提供程序。
图 9:Amazon Bedrock AgentCore Gateway 配置,指向由 Snowflake 托管的 MCP 服务器端点,并以两腿 OAuth(client_credentials)作为出站身份验证
下图展示了采用两腿 OAuth 模式时的运行时授权流程。
图 10:2LO 与外部 IdP 运行时授权流程:以 Amazon Bedrock AgentCore Gateway MCP 服务器为目标,采用 CLIENT_CREDENTIALS 授权和第三方 IdP 出站身份验证
Snowflake 的外部 OAuth 安全集成 2LO 流程工作方式如下:
- 当工具调用需要 Snowflake 令牌时,Amazon Bedrock AgentCore Gateway 会调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并在 Amazon Bedrock AgentCore Identity 凭证提供程序上调用 GetResourceOauth2Token。如果缓存中有有效令牌,Identity 会立即返回该令牌。
- Amazon Bedrock AgentCore Identity 使用 client_credentials 授权类型,并携带已配置的客户端 ID 和客户端密钥,调用第三方 IdP 的令牌端点。对于 Okta,请求的范围包含 Snowflake 角色(例如 session:role:MCP_GATEWAY_ROLE)。对于 Microsoft Entra ID,客户端请求 api:
//<application-id>/.default范围,而角色则来自应用角色,其值为 session:role:MCP_GATEWAY_ROLE,并出现在 roles 声明中。 - IdP 返回一个访问令牌(JWT,不含刷新令牌),其 aud 声明为 Snowflake 账户 URL 或 EXTERNAL_OAUTH_AUDIENCE_LIST 中列出的附加值(对于 Microsoft Entra ID,通常是 Application ID URI)。对于 Okta,sub 声明是客户端 ID。对于 Microsoft Entra ID,客户端 ID 承载在 appid/azp 中,而 sub 保存服务主体的对象 ID(一个 GUID),因此使用 Entra 时,LOGIN_NAME 必须映射到该 GUID。
- Amazon Bedrock AgentCore Gateway 将 JWT 呈现给由 Snowflake 托管的 MCP 服务器。Snowflake 通过其 External OAuth 集成验证该令牌(可选地使用 OAUTH_AUTHORIZATION_SERVER 进行颁发者锁定,如模式 2 中所述)。它通过 EXTERNAL_OAUTH_JWS_KEYS_URL(或 EXTERNAL_OAUTH_RSA_PUBLIC_KEY)验证签名,通过 EXTERNAL_OAUTH_ISSUER 验证颁发者,并针对 Snowflake 账户 URL 以及 EXTERNAL_OAUTH_AUDIENCE_LIST 中的任何附加值验证 aud 声明(这些安全集成参数值区分大小写)。随后,Snowflake 通过 LOGIN_NAME 将 sub 声明映射到 Snowflake 服务用户,并以该服务用户的角色执行查询。与模式 2 一样,Snowflake 在本地验证令牌,运行时不会调用 IdP。
- Amazon Bedrock AgentCore Identity 将令牌缓存在令牌保管库中(跨用户共享,而非按用户隔离)。后续调用会复用该令牌,Identity 会在其过期前使用 client_credentials 授权请求新令牌。
由于两腿 OAuth 目标无需用户同意,Amazon Bedrock AgentCore Gateway 会在创建目标时连接到由 Snowflake 托管的 MCP 服务器,并在目标创建期间通过隐式同步发现工具。在三腿 OAuth 模式(模式 1 和模式 2)中,Gateway 目标支持两种创建方法:(1) 管理员完成授权码流程,从而通过隐式同步发现工具;或 (2) 管理员预先提供工具架构。(发现行为是目标的 ListingMode 属性,而不是授权类型的属性。)
注意事项
对于自动化、无人值守和批处理工作负载,首选两腿 OAuth 模式。它适用于以下情况:
- 你的工作负载是机器对机器的:定时任务、后台流水线或系统级代理,全程无需人工介入。
- 不要求按用户身份,共享服务用户也可用于审计目的。
- 你需要最直接的操作模型:无需同意流程、按用户令牌管理或浏览器重定向。
- Gateway 可以在创建目标时通过隐式同步连接到 Snowflake 并发现 MCP 工具,无需等待用户交互。
- 在单一 Snowflake 角色下,所有用户共享相同的数据访问权限。
请接受以下权衡:
- 由于每个请求都以共享服务用户的身份运行,Snowflake 的行级安全策略和列掩码策略会将此用户的权限应用于请求。基于 CURRENT_USER() 和 CURRENT_ROLE() 的策略都会解析为这同一个服务用户及其单一角色,这正是采用代表用户(OBO)方案的最有力理由。
- 不存在用户级令牌撤销机制。要切断访问,请在 IdP 处撤销客户端凭证,或禁用 Snowflake 安全集成。
- 如果凭证泄露,代理访问将受到影响。请定期轮换客户端密钥,并将服务用户限制为最小权限访问。
模式对比
| 方面 | 模式 1:Snowflake OAuth(3LO) | 模式 2:使用外部 IdP 的 3LO | 模式 3:使用外部 IdP 的 2LO |
| OAuth 授权类型 | authorization_code | authorization_code | 客户端凭证 |
| AgentCore Identity 提供程序 | 自定义提供程序(CustomOauth2) | 内置提供程序(例如 OktaOauth2 或 MicrosoftOauth2) | 内置提供程序(例如 OktaOauth2、MicrosoftOauth2)或 CustomOauth2 |
| 授权服务器 | Snowflake 内置 OAuth | 第三方 IdP(例如 Okta、Entra ID) | 第三方 IdP(例如 Okta、Entra ID) |
| Snowflake 可见的身份 | 真实用户 | 真实用户 | 共享服务用户 |
| RBAC 模型 | 每用户 Snowflake 角色 | 每用户 Snowflake 角色 | 单一角色处理请求 |
| 审计粒度(QUERY_HISTORY) | 真实用户名 | 真实用户名 | 服务用户 |
| 需要外部 IdP | 否 | 是 | 是 |
| Snowflake 安全集成 | TYPE = OAUTH,OAUTH_CLIENT = CUSTOM | TYPE = EXTERNAL_OAUTH + OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT / DATABASE / SCHEMA 设置) | TYPE = EXTERNAL_OAUTH + OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT / DATABASE / SCHEMA 设置) |
| 用户登录体验 | Snowflake 登录 + 同意 | 企业 SSO | 无(无用户交互) |
| MFA / 条件访问 | 按 Snowflake 账户设置 | 由 IdP 强制执行 | MCP 协议修订版¹2025-11-252025-11-252025-11-25(未在 2LO 网关上固定)令牌生命周期治理Snowflake 安全集成IdP 授权服务器策略IdP 授权服务器策略可无人值守运行(计划任务)²仅在刷新令牌过期前有效(参考应用:1 天,最长 90 天)仅在刷新令牌过期前有效(按 IdP 会话策略)是:无需用户交互。最适合需要按用户审计但无 IdP 的 POC已有企业 SSO 的企业应用Inter |
| MCP 协议修订版¹ | 2025-11-25 | 2025-11-25 | 2025-11-25(未在 2LO 网关上固定) |
| 令牌生命周期治理 | Snowflake 安全集成 | IdP 授权服务器策略 | IdP 授权服务器策略 |
| 可无人值守运行(计划任务)² | 仅在刷新令牌过期前有效(参考应用:1 天,最长 90 天) | 仅在刷新令牌过期前有效(按 IdP 会话策略) | 是:无需用户交互。 |
| 最适合 | 需要按用户审计但无 IdP 的 POC | 已有企业 SSO 的企业应用 | 内部代理、批处理作业、服务间通信 |
¹ MCP 协议修订版:对于三腿模式(模式 1 和模式 2),网关在其支持的 MCP 修订版中固定为 2025-11-25,这是 URL 模式 elicitation(-32042)握手所要求的。参考 2LO 网关(模式 3)不固定该版本,因为 2LO 没有 elicitation 步骤。在未启用 MCP 版本更新的账户上,支持的版本集合在网关创建时即固定。
² 可无人值守运行:模式 1 和模式 2 仅在刷新令牌过期前可无人值守运行。此后重新授权需要实时浏览器、同一用户,并在 10 分钟授权窗口(CompleteResourceTokenAuth)内完成,因此 3LO 不适合完全无人值守的定时任务。模式 3(2LO)没有刷新令牌,也没有同意步骤,因此可以无限期无人值守运行。
本文中的三种配置涵盖两种授权类型:authorization_code(模式 1 和模式 2)和 client_credentials(模式 3)。Amazon Bedrock AgentCore Identity 还支持代表(OBO)令牌交换(TOKEN_EXCHANGE),可为无人值守工作负载提供按用户身份。 ,而无需同意提示。 同意提示。
OBO 将入站用户令牌交换为 Snowflake 作用域令牌,该令牌保留真实用户身份,因此 QUERY_HISTORY 会将每个查询归属于实际用户,同时保持模式 3 的无人值守、机器对机器流程(无浏览器重定向、无同意屏幕)。在 Snowflake 侧,它使用与模式 2 和模式 3 相同的 TYPE = EXTERNAL_OAUTH 集成(可选通过 OAUTH_AUTHORIZATION_SERVER 锁定颁发者)。在 AgentCore 侧,它通过 onBehalfOfTokenExchangeConfig 在 OAuth 凭证提供程序上配置(对于 Okta/RFC 8693,授权模式为 TOKEN_EXCHANGE;对于 Microsoft Entra,为 JWT_AUTHORIZATION_GRANT)。OBO 使用外部 OAuth 路径(模式 2 和模式 3)。
OBO 在 Amazon Bedrock AgentCore Identity 上已正式可用,但它不在我们为本文测试的三种配置范围之内。
亲自试一试
为了实际演示这些模式,我们构建了一个金融服务信用风险评估智能体作为参考工作负载。单个智能体将 Amazon S3 中的银行政策文档(通过 Amazon Bedrock Knowledge Bases)与 Snowflake 中的客户数据相结合。它评估贷款资格、搜索客户档案,并查询账户和交易数据。该演示在您自己的 AWS 账户中,针对全部三种 OAuth 配置调用三个 MCP 工具(Cortex Search、Cortex Analyst 和 SQL Execution),以便进行并排比较。
虽然该演示针对的是金融服务,但这些模式同样适用于医疗保健、供应链、保险等领域。三个实现均已公开,并且都通过一个单一的脚本完成端到端部署: deploy.sh 脚本:
- Snowflake OAuth(3LO): amazon-bedrock-agentcore-snowflake-mcp-gateway-3lo.
- 带外部 IdP 的 3LO: amazon-bedrock-agentcore-snowflake-mcp-gateway-3lo-okta.
- 带外部 IdP 的 2LO: amazon-bedrock-agentcore-snowflake-mcp-gateway-2lo..
注意: 出于演示目的,参考实现将 SYSTEM_EXECUTE_SQL 与 Cortex Agent 暴露在同一个 MCP 服务器上。Snowflake 建议仅将 Cortex Agent 作为面向客户端的唯一工具,用于受治理的业务问题。如果需要直接执行 SQL,请将其放在单独的 MCP 服务器上,并使用专用的最小权限角色。
结论
在本文中,我们介绍了通过 Amazon Bedrock AgentCore Gateway 在 MCP 上对 AI 代理进行身份验证以访问 Snowflake Cortex AI 的三种 OAuth 配置。Snowflake OAuth 提供了最简单的路径,可实现按用户审计追踪,且无需依赖外部 IdP。使用外部 IdP 的三腿 OAuth 增加了企业 SSO、集中式 MFA 和条件访问,同时保留按用户身份。使用外部 IdP 的两腿 OAuth 通过共享服务用户为机器对机器通信提供服务。
在全部三种模式中,代理代码和 Snowflake MCP 工具集保持不变。OAuth 的接线方式在四个具体方面有所不同:
- 授权类型发生切换:模式 1 和模式 2 使用 authorization_code,模式 3 使用 client_credentials。
- AUTHORIZATION_CODE 目标需要一个返回 URL,在目标上设置为 defaultReturnUrl,并可按请求选择性地覆盖。2LO 目标则不需要。
- 3LO 目标的创建需要隐式同步或预先提供工具架构,而 2LO 目标在创建目标期间同步其工具,无需用户授权步骤。
- 对于模式 2 和模式 3,可以设置 OAUTH_AUTHORIZATION_SERVER,以将 MCP 作用域锁定到外部 IdP,并让直接的 MCP 客户端自动发现它。模式 1 则不设置该项。如前面所述,一旦设置该项,模式 1 和模式 2 就无法共用一个作用域。
除了这四种之外,只有 Amazon Bedrock AgentCore Identity 凭证提供程序(CustomOauth2、OktaOauth2 或 MicrosoftOauth2)和 Snowflake 安全集成有所不同。理解这些在授权类型、令牌签发、用户映射和审计行为上的差异,能帮助您为自身的合规、运营和用户体验需求选择合适的 OAuth 配置。
首先,请探索我们 GitHub 仓库中的参考实现。 GitHub 仓库如需了解 Amazon Bedrock AgentCore 的更多信息,请访问 Amazon Bedrock AgentCore 服务详情页面 或 开发者指南.
AI 热点