通过 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 的一项能力)上测试过的三种 Open Authorization(OAuth)配置:Snowflake OAuth(按用户,无需外部 Identity Provider,即 IdP)、使用第三方 Identity Provider 的三腿 OAuth(企业单点登录,即 SSO),以及使用第三方 Identity Provider 的两腿 OAuth(共享服务用户)。Amazon Bedrock AgentCore Identity 还支持 on-behalf-of(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 授权服务器。每个用户通过 Authorization Code 授权(3LO)直接向 Snowflake 进行认证。无需外部身份提供方。
- 使用第三方 Identity Provider 的三腿 OAuth:用户通过企业 SSO 和 Authorization Code 授权进行认证。Snowflake 通过其 External OAuth 安全集成信任 IdP 签发的 JSON Web Tokens(JWT)。
- 使用第三方 IdP 的两腿 OAuth 模式:共享服务用户通过 IdP 的 client_credentials 授权进行认证。无需用户交互或同意,非常适合机器对机器工作负载。
Amazon Bedrock AgentCore Identity 还提供 API 密钥凭证提供方(支持 Snowflake Programmatic Access Tokens)。这里我们聚焦 OAuth,以实现按用户归因和自动令牌刷新。每种配置都使用 Amazon Bedrock AgentCore Identity 中的凭证提供方(CustomOauth2、OktaOauth2 或 MicrosoftOauth2),以及 Snowflake 侧对应的安全集成。
注意:我们使用由 Snowflake 托管的 MCP server,配合 Okta 和 Microsoft Entra ID 对这些模式进行了测试。模式 2 和模式 3(外部 IdP)遵循标准 OAuth 流程,因此可以扩展到其他受 OAuth 保护的 MCP server,但请针对你的 SaaS 提供商验证 token 声明、scope 和 audience 设置。只有模式 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 代理该 token 时(即本文中的模式),Snowflake 会通过 TYPE = EXTERNAL_OAUTH 安全集成对其进行验证。设置 OAUTH_AUTHORIZATION_SERVER(通过 ALTER ACCOUNT、DATABASE 或 SCHEMA)可以让直接连接的 MCP 客户端通过 Protected Resource Metadata 端点自动发现你的 IdP,并将 MCP 端点 issuer-lock 到该集成。
- 如果你设置 OAUTH_AUTHORIZATION_SERVER,将某个 MCP scope 以 issuer-lock 方式绑定到外部 IdP(模式 2),那么在该 scope 中,Snowflake OAuth token(模式 1)会被 MCP server 拒绝,并且不会回退。如果你需要在同一个账户中使用这两种模式,请按 schema 或 database 设置该参数,以便每个 scope 都能解析到正确的授权服务器。
解决方案架构
下图展示了我们构建的解决方案及其使用的组件:一个面向用户的 AI 应用、运行在 Amazon Bedrock AgentCore Runtime 上的 Strands agent、Amazon Bedrock AgentCore 的一项能力、用于推理的 Amazon Bedrock(由 Amazon Bedrock Guardrails 对提示和响应中的个人身份信息(PII)进行脱敏)、Amazon Bedrock Knowledge Bases(基于 Amazon Simple Storage Service(Amazon S3)中的策略文档的全托管检索增强生成(RAG)能力)、以 Snowflake 托管的 MCP server 为目标的 Amazon Bedrock AgentCore Gateway,以及持有 token vault 的 Amazon Bedrock AgentCore Identity。出站 OAuth 路径在三种模式中形态相同:Gateway 通过 AgentCore Identity 解析 token,后者从授权服务器获取并续订该 token,然后 Gateway 将该 token 呈现给 Snowflake 托管的 MCP server。各模式之间的差异在于由哪个授权服务器签发 token,以及采用哪种授权类型:是 Snowflake 自己内置的 OAuth 服务器,还是第三方 IdP。这些差异已在模式比较表中列出,每种模式的运行时流程在本文后面的部分各有自己的时序图。

图 1:解决方案概览:Amazon Bedrock Agent
图 3:Amazon Bedrock AgentCore Gateway 配置,指向 Snowflake 管理的 MCP 服务器端点,并将 Snowflake OAuth (3LO) 作为出站认证
以下序列图展示了 Snowflake OAuth 模式的运行时授权流程。

图 4:Snowflake OAuth (3LO) 运行时授权流程:Amazon Bedrock AgentCore Gateway MCP 服务器目标使用 AUTHORIZATION_CODE 授权,按用户进行 Snowflake OAuth,并使用 session:role:ANALYST_ROLE 范围
Snowflake OAuth 授权流程的工作方式如下:
- 当工具调用需要 Snowflake 令牌时,Amazon Bedrock AgentCore Gateway 通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并调用 GetResourceOauth2Token 来检查 Amazon Bedrock AgentCore Identity 中该用户的令牌保管库。如果没有缓存令牌,Gateway 会返回一个 JSON-RPC 错误码 -32042,其中携带 URL elicitation。该授权 URL 属于 AgentCore Identity,并绑定到会话 URI。客户端在用户浏览器中打开该 URL,该 URL 会路由到 Snowflake 内置授权服务器 (/oauth/authorize),并显示 Snowflake 登录屏幕。
- 用户输入其 Snowflake 凭据,并会看到同意屏幕,要求其授权使用特定 Snowflake 角色(例如 ANALYST_ROLE)进行访问。请求范围中的角色名称必须大写(例如 session:role:ANALYST_ROLE)。
- 用户同意后,Snowflake 的授权服务器会向 Amazon Bedrock AgentCore Identity 的回调 URL 返回授权码。随后,AgentCore Identity 将用户浏览器重定向到带有会话 URI 的返回 URL。
- 仅当应用使用用户身份和会话 URI(有效期为 10 分钟)调用 CompleteResourceTokenAuth 后,AgentCore Identity 才会完成授权码交换。此步骤将授权码绑定到发起请求,并阻止授权 URL 劫持。此处使用的返回 URL 通过调用 UpdateWorkloadIdentity 注册。在生产环境中,该 URL 的端点由你的 Web 应用托管;或者,对于具有 JWT 入站认证的网关,由 AgentCore Identity Consent Portal (<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_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 通过其 External OAuth 安全集成对其进行验证(可选择使用 OAUTH_AUTHORIZATION_SERVER 将颁发者锁定到 MCP 服务器的 schema、数据库或账户)。Snowflake 通过 JSON Web Key Set(JWKS)验证颁发者、受众和签名。然后,它将通过 EXTERNAL_OAUTH_TOKEN_USER_MAPPING_CLAIM 设置的可配置声明(Okta 使用 sub,Microsoft Entra ID 使用 upn)映射到 Snowflake 用户的 LOGIN_NAME 或 EMAIL_ADDRESS(使用 EXTERNAL_OAUTH_SNOWFLAKE_USER_MAPPING_ATTRIBUTE),并以
图 6:Amazon Bedrock AgentCore Gateway 配置,指向由 Snowflake 托管的 MCP 服务器端点,并以 Okta 三腿 OAuth 作为出站认证
以下序列图展示了使用外部 IdP 的三腿 OAuth 模式的运行时授权流程。

图 7:使用外部 IdP 的 3LO 运行时授权流程:Amazon Bedrock AgentCore Gateway MCP 服务器目标,采用 AUTHORIZATION_CODE 授权类型和第三方 IdP 出站认证
Snowflake 的 External OAuth 安全集成流程工作方式如下:
- 当工具调用需要 Snowflake 令牌时,Amazon Bedrock AgentCore Gateway 通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并调用 GetResourceOauth2Token 在 Amazon Bedrock AgentCore Identity 的令牌保管库中查找该用户的令牌。如果没有缓存的令牌,Gateway 会返回携带 URL elicitation 的 JSON-RPC 错误码 -32042。该授权 URL 属于 AgentCore Identity,且与 session URI 绑定,而不是 IdP 的 URL。客户端在用户浏览器中打开该 URL,AgentCore Identity 将用户路由到 IdP。
- 用户通过第三方 IdP 使用企业 SSO(包括 MFA)完成认证,并同意所请求的 scope。对于 Okta,角色 scope 的形式为 session:role:ANALYST_ROLE。Microsoft Entra ID 的委派流程则使用 session:scope: 形式。
- IdP 将授权码返回到 Amazon Bedrock AgentCore Identity 的回调 URL,AgentCore Identity 将用户浏览器重定向到带有 session URI 的返回 URL。只有在应用程序调用 CompleteResourceTokenAuth 验证用户身份和 session URI 之后,AgentCore Identity 才会用授权码换取访问令牌(以及刷新令牌,如果 IdP 签发的话),并将其缓存到按用户隔离的令牌保管库中。
- 当客户端重试工具调用时(以及后续调用时),Amazon Bedrock AgentCore Gateway 从 Amazon Bedrock AgentCore Identity 获取缓存的、由 IdP 签发的 JWT,并将其提交给由 Snowflake 托管的 MCP 服务器。Snowflake 通过其 External OAuth 集成验证该令牌:校验 JWKS 签名和受众(aud)声明,将配置的用户声明(Okta 为 sub,Microsoft Entra ID 为 upn)映射到 Snowflake 用户,并以该已认证用户的身份执行查询。Snowflake 在运行时不会调用 IdP,而是使用 IdP 公布的 JWKS 签名密钥在本地验证令牌。
- 当访问令牌过期时,Amazon Bedrock AgentCore Identity 会使用缓存的刷新令牌自动刷新(如果签发了刷新令牌;对于 Okta,需请求 offline_access scope)。在刷新令牌过期之前,无需用户交互。
令牌生命周期治理:与由 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)的 two-legged OAuth(2LO)
two-legged OAuth 模式使用 OAuth 2.0 client_credentials 授权类型。这是无用户交互的机器对机器流程。Amazon Bedrock AgentCore Identity 使用配置的 client ID 和 client secret 从 IdP 获取 JWT,Amazon Bedrock AgentCore Gateway 将其提交给 Snowflake,Snowflake 会以共享服务用户身份执行请求,无论查询由哪个最终用户发起。
此模式在运维上最直接:没有同意屏幕、没有按用户划分的令牌保管库、没有浏览器重定向。用户遵循相同的代码路径。Amazon Bedrock AgentCore Identity 会自动获取并缓存 client_credentials 令牌,Amazon Bedrock AgentCore Gateway 会在每次对由 Snowflake 管理的 MCP server 的出站调用中提交该令牌。
与模式 1 和模式 2 的关键区别在于:没有按用户进行身份传播。Snowflake 的 QUERY_HISTORY 会将查询记录为单个服务用户。权衡是以牺牲按用户审计的粒度为代价,换取运维简便性。在 Amazon Bedrock AgentCore 侧,凭证提供商使用 client_credentials 授权类型:可以是内置供应商(OktaOauth2、MicrosoftOauth2)或通用 CustomOauth2 提供商。配置需要 IdP 的令牌端点、client ID 和 client secret。Amazon Bedrock AgentCore Identity 会在首次工具调用时(当 Gateway 调用 GetResourceOauth2Token 时)从 IdP 获取令牌并缓存;由于 client_credentials 不签发刷新令牌,它会在过期前请求一个新令牌。无需更改代理层代码。

图 8:在 Amazon Bedrock AgentCore Identity 中配置 client_credentials(two-legged)凭证提供商供应商
接下来,Amazon Bedrock AgentCore Gateway 配置引用由 Snowflake 管理的 MCP server 端点,以及用于出站认证的 two-legged OAuth 凭证提供商。

图 9:指向由 Snowflake 管理的 MCP server 端点,并以 two-legged OAuth(client_credentials)作为出站认证的 Amazon Bedrock AgentCore Gateway 配置
以下时序图展示了 two-legged OAuth 模式的运行时授权流程。

图 10:使用外部 IdP 的 2LO 运行时授权流程:具有 CLIENT_CREDENTIALS 授权类型和第三方 IdP 出站认证的 Amazon Bedrock AgentCore Gateway MCP server 目标
Snowflake 的 External OAuth security integration 的 2LO 流程如下:
- 当工具调用需要 Snowflake token 时,Amazon Bedrock AgentCore Gateway 通过调用 GetWorkloadAccessTokenForJWT 获取工作负载令牌,并在 Amazon Bedrock AgentCore Identity 凭证提供程序上调用 GetResourceOauth2Token。如果有效令牌已缓存,Identity 会立即返回它。
- Amazon Bedrock AgentCore Identity 使用 client_credentials 授权类型,以配置的 client ID 和 client secret 调用第三方 IdP 的令牌端点。对于 Okta,请求的 scope 包含 Snowflake 角色(例如 session:role:MCP_GATEWAY_ROLE)。对于 Microsoft Entra ID,客户端请求 api://<application-id>/.default scope,角色会出现在 roles 声明中,该声明来自一个值为 session:role:MCP_GATEWAY_ROLE 的应用角色。
- IdP 返回访问令牌(JWT,无刷新令牌),其 aud 声明为 Snowflake 账户 URL 或 EXTERNAL_OAUTH_AUDIENCE_LIST 中列出的附加值(对于 Microsoft Entra ID,通常是 Application ID URI)。对于 Okta,sub 声明是 client ID。对于 Microsoft Entra ID,client ID 承载在 appid/azp 中,而 sub 保存服务主体的对象 ID(GUID),因此使用 Entra 时,LOGIN_NAME 必须映射到该 GUID。
- Amazon Bedrock AgentCore Gateway 将 JWT 出示给 Snowflake 托管的 MCP server。Snowflake 通过其 External OAuth 集成验证令牌(可选地使用 OAUTH_AUTHORIZATION_SERVER 锁定 issuer,如 Pattern 2 所示)。它通过 EXTERNAL_OAUTH_JWS_KEYS_URL(或 EXTERNAL_OAUTH_RSA_PUBLIC_KEY)验证签名,通过 EXTERNAL_OAUTH_ISSUER 验证 issuer,并根据 Snowflake 账户 URL 以及 EXTERNAL_OAUTH_AUDIENCE_LIST 中的任何附加值验证 aud 声明(这些安全集成参数值区分大小写)。然后 Snowflake 通过 LOGIN_NAME 将 sub 声明映射到 Snowflake 服务用户,并在该服务用户的角色下执行查询。与 Pattern 2 一样,Snowflake 在本地验证令牌,运行时不会调用 IdP。
- Amazon Bedrock AgentCore Identity 将令牌缓存在令牌保管库中(跨用户共享,而非按用户)。后续调用会复用它,Identity 会在令牌过期前使用 client_credentials 授权请求新令牌。
由于两方 OAuth 目标不需要用户同意,Amazon Bedrock AgentCore Gateway 在创建目标时连接到 Snowflake 托管的 MCP server,并在目标创建期间通过隐式同步发现工具。在三方 OAuth 模式(Pattern 1 和 Pattern 2)中,Gateway 目标支持两种创建方法:(1) 管理员完成授权码流程,从而通过隐式同步发现工具;或 (2) 管理员预先提供工具 schema。(发现行为是目标的 ListingMode 属性,而不是授权类型的属性。)
注意事项
两方 OAuth 模式适用于自动化、无人值守和批处理工作负载。它在以下情况下最为理想:
- 工作负载是机器对机器:计划任务、后台管道或系统级代理,无需人工介入。
- 不需要按用户身份,且出于审计目的可以接受共享服务用户。
- 需要最直接的操作模型:无同意流程、无按用户令牌管理、无浏览器重定向。
- Gateway 可以在目标创建时连接到 Snowflake 并通过隐式同步发现 MCP 工具,而无需等待用户交互。
- 所有用户在单个 Snowflake 角色下共享相同的数据访问权限。
接受这些权衡:
- 由于每个请求都以共享服务用户身份运行,Snowflake 的行级安全和列掩码策略会将该用户的权限应用于请求。以 CURRENT_USER() 和 CURRENT_ROLE() 为键的策略都会解析到该单个服务用户及其单个角色,这是 on-behalf-of (OBO) 方法最强有力的理由。
- 没有用户级令牌撤销。要切断访问,请在 IdP 处撤销客户端凭证或禁用 Snowflake 安全集成。
- 如果凭证泄露,智能体访问将受到影响。定期轮换客户端密钥,并将服务用户限制为最小权限访问。
模式对比
| 方面 | 模式 1:Snowflake OAuth (3LO) | 模式 2:使用外部 IdP 的 3LO | 模式 3:使用外部 IdP 的 2LO |
|---|---|---|---|
| OAuth 授权类型 | authorization_code | authorization_code | client_credentials |
| 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-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 中的客户数据相结合。它评估贷款资格、搜索客户档案,并查询账户和交易数据。该演示在三种 OAuth 配置下演练了三个 MCP 工具(Cortex Search、Cortex Analyst 和 SQL Execution),以便您在自己的 AWS 账户中进行并排比较。
尽管演示是金融服务场景,但这些模式同样适用于医疗保健、供应链、保险等领域。所有三种实现都是公开的,并通过单个 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。
注意:出于演示目的,参考实现在与 Cortex Agent 相同的 MCP 服务器上暴露了 SYSTEM_EXECUTE_SQL。Snowflake 建议仅将 Cortex Agent 作为面向客户端的唯一工具,用于受治理的业务问题。如果需要直接 SQL,请将其放在单独的 MCP 服务器上,并使用专用的最小权限角色。
结论
在本文中,我们介绍了三种 OAuth 配置,用于通过 Amazon Bedrock AgentCore Gateway 在 MCP 上对 AI 代理进行身份验证以访问 Snowflake Cortex AI。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 目标创建需要隐式同步或预先提供工具 schema,而 2LO 目标在目标创建期间同步其工具,无需用户授权步骤。
- 模式 2 和 3 可以设置 OAUTH_AUTHORIZATION_SERVER,以将 MCP 作用域锁定到外部 IdP,并让直接 MCP 客户端自动发现它。模式 1 不设置此项。如前面所述,设置后,模式 1 和 2 不能共享一个作用域。
除这四点外,只有 Amazon Bedrock AgentCore Identity 凭证提供程序(CustomOauth2、OktaOauth2 或 MicrosoftOauth2)和 Snowflake 安全集成有所不同。了解授权类型、令牌颁发、用户映射和审计行为方面的这些差异,可以帮助您根据合规性、运营和用户体验需求选择正确的 OAuth 配置。
要开始使用,请浏览我们 GitHub 仓库中的参考实现。有关 Amazon Bedrock AgentCore 的更多信息,请访问 Amazon Bedrock AgentCore 服务详情页或开发者指南。