AgentCore 接入 Snowflake 的三种认证方案
AWS 在 AgentCore Identity 上测试了三种 OAuth 方案,用于智能体通过 MCP 调用 Snowflake Cortex AI。方案包括 Snowflake OAuth、接入企业身份提供商的三方 OAuth,以及两方 OAuth。
AI 深度解读
AI 助手通过 MCP 查 Snowflake 时,用户已经登录应用,数据库却未必知道是谁在查。AWS ML Blog 实测了三种 Amazon Bedrock AgentCore 的出站 OAuth 配置。两种让 Snowflake 按个人身份执行查询,一种让后台任务共用服务账号。
这篇最值得读的是授权失败后怎么接回原来的工具调用,以及三种配置最终会在数据库里留下谁的名字。前端要处理浏览器授权和调用重试,全栈还得把角色范围、令牌续期和离职撤权算进同一条链路。
应用已经登录,为什么查库还要授权
应用发给 Amazon Bedrock AgentCore Gateway 的 JSON Web Token(JWT),用于识别调用 Gateway 的人。Gateway 发给 Snowflake 托管 MCP 服务的 OAuth 令牌,则决定 Snowflake 以谁的身份、用什么角色执行请求。两段认证有各自的校验规则,选型主要发生在第二段。
Gateway 把配置好的目标汇成一份工具目录,统一通过 tools/list 返回。能发现 Cortex Search、Cortex Analyst 等工具,和有权实际调用它们,是两回事。工具调用需要出站令牌时,Gateway 先用 GetWorkloadAccessTokenForJWT 取得工作负载令牌,再调用 GetResourceOauth2Token。AgentCore Identity 管理令牌保险库、用户与令牌的绑定,以及缓存和续期。Snowflake 收到出站令牌后,再按对应的集成配置建立会话。
需要追到个人,就先选谁来签发令牌
两种三方 OAuth(3LO)都走 authorization_code,都可以在 QUERY_HISTORY 里留下实际用户名。第一种由 Snowflake 签发令牌,适合用户已经有 Snowflake 账号的场景。配置顺序有个依赖:先用占位凭据创建 CustomOauth2,拿到 callbackUrl 后去 Snowflake 注册重定向地址,创建 TYPE = OAUTH、OAUTH_CLIENT = CUSTOM 的安全集成,再将真实的 client ID 和 secret 填回凭据提供方。oauthDiscovery 里要填 Snowflake 账户 URL 作为 issuer,以及 /oauth/authorize 和 /oauth/token-request 两个端点。
角色也要主动收窄。Snowflake 托管 MCP 服务会声明 session:role:all,并回退到 DEFAULT_ROLE。想请求特定角色,可以用 ALTER 设置 OAUTH_SCOPES_SUPPORTED 来收窄服务声明的范围,再用 ALLOWED_ROLES_LIST 限制用户能同意哪些角色。PRE_AUTHORIZED_ROLES_LIST 列出的是可跳过同意的角色。请求形如 session:role:ANALYST_ROLE,角色名要大写。用户同意的范围只管主角色,OAUTH_USE_SECONDARY_ROLES 应保持默认的 NONE。设成 IMPLICIT 时,次要角色仍可能带入高权限,而 BLOCKED_ROLES_LIST 和 EXTERNAL_OAUTH_BLOCKED_ROLES_LIST 只约束主角色。
第二种由企业身份提供商(IdP)签发令牌,用户走 Okta 或 Microsoft Entra ID 的单点登录(SSO),沿用多因素认证(MFA)和条件访问策略。AgentCore Identity 可用 OktaOauth2 或 MicrosoftOauth2,通过 includedOauth2ProviderConfig 配置。Snowflake 用 TYPE = EXTERNAL_OAUTH 集成校验签发方、受众和签名,借助 IdP 公布的 JWKS 签名公钥在本地验签。EXTERNAL_OAUTH_TOKEN_USER_MAPPING_CLAIM 选择用于查找用户的声明,Okta 示例是 sub,Entra ID 示例是 upn。EXTERNAL_OAUTH_SNOWFLAKE_USER_MAPPING_ATTRIBUTE 则指定对应 Snowflake 的 LOGIN_NAME 或 EMAIL_ADDRESS。集成参数值区分大小写,Okta 的角色范围示例是 session:role:ANALYST_ROLE,Entra ID 的委托流使用 session:scope:。
对于直连的 MCP 客户端,可以用 OAUTH_AUTHORIZATION_SERVER 让客户端通过受保护资源元数据发现 IdP,同时把对应范围锁定到该签发方。某个范围锁到外部 IdP 后,Snowflake 自签的 OAuth 令牌在该范围会被拒绝,且没有回退。同一账户需要并行使用两种方案时,可以按数据库或 schema 分别设置。
首次调用缺令牌,前端怎么接回去
两种 3LO 在没有缓存令牌时,都会返回带授权 URL 的 JSON-RPC 错误 -32042。客户端打开浏览器进入授权流程。这个 URL 由 AgentCore Identity 发出,并绑定到会话 URI。授权服务器把 code 发到 AgentCore Identity 的 callbackUrl 后,浏览器还会回到应用的返回地址。应用必须带上用户身份和会话 URI 调用 CompleteResourceTokenAuth,Identity 才会交换令牌。会话 URI 有效期为 10 分钟,完成绑定后,客户端再重试原工具调用。
返回地址通过 UpdateWorkloadIdentity 注册。生产环境可由 Web 应用托管,使用 JWT 入站认证的 Gateway 也可走 AgentCore Identity Consent Portal 的 <portal-url>/connect/callback。agentcore dev 只在本地开发时托管这个端点。
Snowflake 自签的访问令牌默认有效 600 秒,最长 3600 秒。参考实现把 OAUTH_REFRESH_TOKEN_VALIDITY 设为 86400 秒,也就是 1 天,Snowflake 允许最长 90 天。是否发放刷新令牌由默认值为 TRUE 的 OAUTH_ISSUE_REFRESH_TOKENS 控制。外部 IdP 则自行决定令牌寿命,Okta 示例要请求 offline_access 才能走刷新流程。停用 IdP 用户有助于阻止新授权,已缓存的访问令牌仍可能用到过期。forceAuthentication=true 会清掉已存的刷新令牌并开启重新授权,撤销授权则要到 IdP 或 Snowflake 处理。
无人值守任务用什么身份查库
第三种是两方 OAuth(2LO),走 client_credentials。AgentCore Identity 用 client ID 和 secret 向 IdP 取令牌,首次工具调用时获取,有缓存就复用,到期前重新申请。这个流程不发刷新令牌,也无需浏览器回跳。除了 OktaOauth2 和 MicrosoftOauth2,也能用配置了 CLIENT_CREDENTIALS 的 CustomOauth2。
Okta 示例请求 session:role:MCP_GATEWAY_ROLE,sub 是 client ID。Entra ID 请求 api://<application-id>/.default,应用角色值 session:role:MCP_GATEWAY_ROLE 通过 roles 声明传入,client ID 则在 appid/azp。aud 要匹配 Snowflake 账户 URL 或 EXTERNAL_OAUTH_AUDIENCE_LIST 里的附加值,后者在 Entra ID 中通常是 Application ID URI。
这条路的代价体现在审计上。即使请求是不同用户发起的,QUERY_HISTORY 也只记录同一个服务用户。如果后台任务仍须保留个人身份,原文另提到代表用户执行的 OBO(TOKEN_EXCHANGE),可在无人值守时传递个人身份且无需弹出同意页。它在作者本次端到端实测的三种配置之外。
我的判断
我会先用审计要求做决定。业务要求数据仓库能独立回答「谁以什么角色查了数据」,就优先考虑 3LO。在应用日志里补用户 ID,可以帮助排查共用账号发出的请求,但仓库里执行查询的主体仍是服务用户。已有统一 SSO 的团队可以沿用企业 IdP,前提是有人维护声明映射、角色配置和撤权流程。只做 Snowflake 内部验证、用户也已有账号时,自签 OAuth 少一段外部身份映射,搭起来更直接。
作者用 Snowflake 托管 MCP 服务以及 Okta、Microsoft Entra ID 验证了三种配置,原文没有给出延迟、运维工时或与 Snowflake Programmatic Access Tokens 的对照数据。「更简单」属于配置经验。换成其他 OAuth 保护的 MCP 服务,可以借用外部 IdP 的两种流程,仍要重新核对声明、scope 和 audience。所给原文在 Entra ID 的 2LO 令牌声明处截断,服务用户如何完成后续映射没有完整展开。
能拿来做什么
- 写 Web 或 Node MCP 客户端时,把
-32042接成一条可恢复的授权流程。保存待重试的工具调用,回跳后先完成CompleteResourceTokenAuth,再恢复调用,并给会话过期提供重新授权入口。 - 接企业 SSO 时,拿两名权限不同的测试用户执行同一项只读操作,核对
QUERY_HISTORY的用户名和角色。再停用其中一个用户,分别验证缓存令牌过期前后的表现。 - 给定时任务接 2LO 时,为服务用户单独配置所需的最低权限,实际确认
QUERY_HISTORY记录的是哪个账户。若项目要求仓库层审计到个人,把这一点写进接入验收条件。