@aooth/idp

中文文档
0.2.6发布于 2026/11/07MITTypeScriptESM + CJS近 30 天下载 2436

框架不可知 OAuth2 / OIDC oothjs 联合登录核心(供应商注册、PKCE/状态、ID-token验证、账户解析)

中文使用文档
文档目录3 节
  1. 这是什么
  2. 安装
  3. 警卫

@ aooth/ idp (英语)

OAuth2 / OIDC 联合记录核心 阿欧斯。 。 。 .

这是 第2阶段 层 外部 IDP RFC: 便携式 没有框架依赖的部件——提供者客户端、PKCE/状态原始人、, ID - token 校验,和账户 - 解析算法. 电线 (单位:千美元)OAuthController,供应商-日志工作流程, DI 绑定)生活在 @aooth/auth-moost (第3阶段).

这是什么

  • IdentityProvider ——提供者抽象化(authorizationUrl 编号 : exchange) (中文(简体) ).
  • OidcProvider ——通用 OpenID 连接:发现,远程JWKS,并全 OIDC 核心内容 ID- token 验证( 被绑定的 algs, iss编号 :aud编号 :azp, (中文(简体) ), exp编号 :iat编号 :nbf 与时钟摇摆, nonce, (中文(简体) ), at_hash) (中文(简体) ). 失败者 关闭 jWKS/发现错误.
  • GoogleProvider —— 说 OidcProvider 被Google的发行商 + RS256。 。 。 .
  • FakeIdentityProvider ——确定性,无网络,用于单位+e2e测试.
  • OAuthProviderRegistry - 持有供应商+ FederatedPolicy + 共享 签名/核查配置; 解析 :provider; 构建固定 redirect_uri。 。 。 .
  • PKCE / 状态 —— 说 createPkcePair, (中文(简体) ), generateNonce,以及 signState编号 :verifyState (一个紧凑的HS256 JWT绑定随机+提供商+重定向+可选核查人/nonce).
  • FederatedLoginService —— 说 resolveUser(profile) (已知 ) 和 linkIdentity (与交叉用户后卫的交互连接完成).

安装

pnpm add @aooth/idp @aooth/user @aooth/auth

@aooth/idp 取决于混凝土 UserService (单位:千美元)@aooth/user和共享资源 Clock (单位:千美元)@aooth/auth)和使用 jose 向所有人开放 JWT/JWKS工作.

警卫

通过电子邮件进行账户匹配是账户接收敏感——默认 FederatedPolicy.emailMatch 实值 require-interactive-link (从未默默地合并). 见 境内流离失所者 §4/§7 完全的姿态.

版本与发布记录

@aooth/idp 共发布 85 个版本,首次发布于 2026/06/06;过去 12 个月发布了 85 个版本。

版本发布日期距今
0.2.6latest2026/11/07今天
0.2.52026/11/061 天前
0.2.42026/11/043 天前
0.2.32026/11/043 天前
0.2.22026/11/034 天前
0.2.12026/11/034 天前

关于 @aooth/idp 的常见问题

@aooth/idp 是什么?

框架不可知 OAuth2 / OIDC oothjs 联合登录核心(供应商注册、PKCE/状态、ID-token验证、账户解析)

如何安装 @aooth/idp?

在项目目录运行 npm install @aooth/idp,或使用 pnpm add / yarn add / bun add。

@aooth/idp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aooth/idp 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aooth/idp 可以商用吗?

@aooth/idp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aooth/idp 的下载量有多少?

根据 npm 官方下载统计,@aooth/idp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,436 次,日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aooth/idp 还在维护吗?

最新版本 0.2.6 发布于 2026/11/07(今天);至今共发布 85 个版本,其中过去 12 个月发布了 85 个;首次发布于 2026/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。