基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-18 04:25

AgentCore 接入 Snowflake 的三种认证方案

AWS ML Blog#身份认证#OAuth#MCP
Editor brief · 编辑速览

AWS 在 AgentCore Identity 上测试了三种 OAuth 方案,用于智能体通过 MCP 调用 Snowflake Cortex AI。方案包括 Snowflake OAuth、接入企业身份提供商的三方 OAuth,以及两方 OAuth。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 记录的是哪个账户。若项目要求仓库层审计到个人,把这一点写进接入验收条件。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 AWS ML Blog,原文版权归原作者所有。

阅读原文
上一篇
Spec Kit 生成的技能终于能追溯版本
下一篇
AI 编辑视频先审分镜再渲染

资讯速览

AWS ML Blog · 2026-11-18 04:25

AI 评分 8.0 / 10

相关标签

#身份认证#OAuth#MCP

继续阅读

  • 先匹配目标记录,再交给智能体推理
  • Spec Kit 生成的技能终于能追溯版本
  • AI 编辑视频先审分镜再渲染
  • Copilot 正式接入两款 GPT-6.2 模型
  • Gabby 为智能体提供可审计的执行环境