@emulators/okta

中文文档
0.13.1发布于 2026/11/09Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2114

Okta身份提供商与OAuth 2.0 / OIDC相仿,用户管理,组,应用,以及授权服务器.

中文使用文档
文档目录9 节
  1. 安装
  2. 终点
  3. OAuth / OIDC 数据
  4. 用户
  5. 组
  6. 应用程序
  7. 授权服务器
  8. 种子配置
  9. 链接

@emulers/okta (英语)

Okta身份提供商与OAuth 2.0 / OIDC相仿,用户管理,组,应用,以及授权服务器.

部分 模拟 ——为CI和无网络沙盒提供本地出入口替换服务.

安装

npm install @emulators/okta

终点

OAuth / OIDC 数据

默认 org 服务器和自定义授权服务器路径( S)/oauth2/:authServerId/...:

  • GET /.well-known/openid-configuration ——OIDC发现(默认)
  • GET /oauth2/:authServerId/.well-known/openid-configuration ——每服务器发现
  • GET /oauth2/v1/keys ——JSON网络密钥集(JWKS)
  • GET /oauth2/v1/authorize ——授权终点
  • POST /oauth2/v1/token - 符号终点
  • GET /oauth2/v1/userinfo ——用户信息
  • POST /oauth2/v1/revoke - 撤销证书
  • POST /oauth2/v1/introspect ——象征性回顾
  • GET /oauth2/v1/logout - 结束会话

用户

  • GET /api/v1/users 列表用户
  • POST /api/v1/users ——创建用户
  • GET /api/v1/users/me ——当前用户(发自令牌)
  • GET /api/v1/users/:userId ——获得用户
  • PUT /api/v1/users/:userId - 替换用户
  • POST /api/v1/users/:userId ——部分更新
  • DELETE /api/v1/users/:userId — 删除用户
  • GET /api/v1/users/:userId/groups ——列表用户组
  • POST /api/v1/users/:userId/lifecycle/activate 启动
  • POST /api/v1/users/:userId/lifecycle/deactivate - 失效
  • POST /api/v1/users/:userId/lifecycle/suspend ——暂停
  • POST /api/v1/users/:userId/lifecycle/unsuspend ——未中止
  • POST /api/v1/users/:userId/lifecycle/reactivate - 重新启动

组

  • GET /api/v1/groups - 名单组
  • POST /api/v1/groups ——创建组
  • GET /api/v1/groups/:groupId - 集合起来
  • PUT /api/v1/groups/:groupId ——更新组
  • DELETE /api/v1/groups/:groupId 删除组
  • GET /api/v1/groups/:groupId/users - 名单小组成员
  • PUT /api/v1/groups/:groupId/users/:userId ——将用户添加到组中
  • DELETE /api/v1/groups/:groupId/users/:userId ——从组中删除用户

应用程序

  • GET /api/v1/apps ——列表应用程序
  • POST /api/v1/apps ——创建应用
  • GET /api/v1/apps/:appId - 获取应用
  • PUT /api/v1/apps/:appId ——更新应用
  • DELETE /api/v1/apps/:appId 删除应用
  • GET /api/v1/apps/:appId/users ——列表指定用户
  • PUT /api/v1/apps/:appId/users/:userId - 指定用户
  • DELETE /api/v1/apps/:appId/users/:userId ——未指定用户
  • POST /api/v1/apps/:appId/lifecycle/activate - 激活应用程序
  • POST /api/v1/apps/:appId/lifecycle/deactivate - 已失效的应用程序

授权服务器

  • GET /api/v1/authorizationServers 清单
  • POST /api/v1/authorizationServers ——创建
  • GET /api/v1/authorizationServers/:authServerId - 获取
  • PUT /api/v1/authorizationServers/:authServerId - 最新情况
  • DELETE /api/v1/authorizationServers/:authServerId - 删除
  • POST /api/v1/authorizationServers/:authServerId/lifecycle/activate 启动
  • POST /api/v1/authorizationServers/:authServerId/lifecycle/deactivate - 失效

种子配置

okta:
  users:
    - login: [email protected]
      email: [email protected]
      firstName: Test
      lastName: User
  groups:
    - name: Everyone
      description: All users
  apps:
    - name: My App
      label: My App
  authorization_servers:
    - name: default
      audiences: ["api://default"]

版本与发布记录

@emulators/okta 共发布 18 个版本,首次发布于 2026/04/03;过去 12 个月发布了 18 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.13.1latest2026/11/095 天前
0.13.02026/10/2915 天前
0.12.32026/10/2322 天前
0.12.22026/10/141 个月前
0.12.12026/10/021 个月前
0.12.02026/09/241 个月前

关于 @emulators/okta 的常见问题

@emulators/okta 是什么?

Okta身份提供商与OAuth 2.0 / OIDC相仿,用户管理,组,应用,以及授权服务器.

如何安装 @emulators/okta?

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

@emulators/okta 支持 TypeScript 吗?

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

@emulators/okta 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@emulators/okta 可以商用吗?

@emulators/okta 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@emulators/okta 的下载量有多少?

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

@emulators/okta 还在维护吗?

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