@haneinfo/identity-core

中文文档
4.7.1发布于 2026/11/17UNLICENSEDTypeScriptCommonJS近 30 天下载 5309

Haneinfo应用软件的提供者中立用户和服务账户身份:用户模式,用户CRUD和haneinfo.identity-store能力.

中文使用文档
文档目录5 节
  1. 读者拾取器身份搜索
  2. 挂起活动显示名称
  3. 认证名称查询
  4. 与飞行前匹配的电子邮件
  5. 默认角色和 CSV roles 栏

身份核心

Haneinfo插件的提供者中立身份存储和用户管理.

身份StoreService执行可选身份StorePort.searchA活性ByName. 在 PostgreSQL 中活动/名称/被排除在外的用户/密钥集上游并运行了 20-row 封顶;只选择了 id 和 无效名称. 可以提供电话交易。 该方法不提供实例访问,也不披露新的公共用户搜索端点:协作执行授权. 更新身份核心,并开展合作,以便提及发现.

挂起活动显示名称

身份存储可选执行 findActiveNamesByIds(ids, transaction?),仅返回 { id, name } 用于在一个预测查询中积极匹配用户,去除ID并跳过空输入。 未知、已删除和不活跃的用户被省略。 消费者对省略的名字和年长的提供者使用无效,没有这种可选的方法;他们必须在查取前授权他们的对象,不得倒回到每行找到ById的电话. 这没有添加普通用户 HTTP 端点或 schema 字段.

认证名称查询

得到/身份/用户/查看?q=使用互动AuthGuard而不使用AdminGuard. 它修剪 q 并需要 2–200个字符,否则为INVALID INPUT/400. 它返回最多20个活动用户的数组, 每一个准确的 { id, name }, 带有无效名称, 由名称命令然后 ID 。 百分比、下划线和 反斜线是字面搜索字符。 没有电子邮件/作用披露、光标或批量导出, 没有新的 MCP 工具。 现有的身份存储密钥集搜索保持其 id 命令; 只有此 控制器请求具体执行的可选名称排序 .

与飞行前匹配的电子邮件

在此版本启用前, 运行 psql -X -v ON_ERROR_STOP=1 -f node_modules/@haneinfo/identity-core/scripts/check-email-duplicates.sql 以目标数据库为对象,只读账户。 配置标准 PostgreSQL 客户端设置的连接 。 SELECT将现有的不敏感大小写复制到标准输出;它不写入文件,合并账户,或修改数据. 在启用认证前手动解析复制 。 将输出保护为个人数据, 不将其重定向为日志或文件 .

新用户使用小写邮件存储 。 查找忽略了大小写,拒绝模棱两可的匹配,包括在导入时. 现存行不重写. 现有的对案件有敏感认识的独特制约不能阻止外部写作员同时插入混合写作重复;所有写作员都必须遵循这一政策,操作员应当根据需要重复飞行前的操作.

默认角色和 CSV roles 栏

行为改变 : 创建不明确的用户 roleIds (手语: UsersService.create,OIDC JIT通过 IdentityStoreService.create,然后将 CSV 导入为空 roles 单元格)不再指定 USER (单位:千美元)SYSTEM_USER_ROLE默认情况下。 想要默认角色的应用程序必须声明 defaultRoleNames 内 @haneinfo/rbac (单位:千美元)configRef: "rbac"); 保留先前的行为,设置 defaultRoleNames: ["USER"]。 。 。 .

CSV 导入UsersImportService)支持可选 roles 列(别名: role, (中文(简体) ), roles, (中文(简体) ), 角色),其中多个角色机器名称由 ;。当创建新用户时:

  • 非空值通过 RbacPolicyPort.resolveImportRoleIds (关闭与 ROLES_UNSUPPORTED 如果缺失,或 ROLE_NOT_ASSIGNABLE 如果任何角色是 ADMIN 或不详).
  • 空单元格返回 App 已宣布 defaultRoleIds()。 。 。 .
  • 现有用户bind 或者说 skip),角色从未被修改,非空单元格被标记为 ROLES_IGNORED_FOR_EXISTING_USER。 。 。 .

版本与发布记录

@haneinfo/identity-core 共发布 38 个版本,首次发布于 2026/10/02;过去 12 个月发布了 38 个版本。

版本发布日期距今
4.7.1latest2026/11/17今天
4.7.02026/11/161 天前
4.6.192026/11/0412 天前
4.6.182026/11/0214 天前
4.6.172026/11/0115 天前
4.6.162026/10/3017 天前

关于 @haneinfo/identity-core 的常见问题

@haneinfo/identity-core 是什么?

Haneinfo应用软件的提供者中立用户和服务账户身份:用户模式,用户CRUD和haneinfo.identity-store能力.

如何安装 @haneinfo/identity-core?

在项目目录运行 npm install @haneinfo/identity-core,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.4.0)、@nestjs/core(^11.0.0 || ^12.0.0)、@nestjs/common(^11.0.0 || ^12.0.0)、@prisma/client(^6.19.0 || ^7.10.1)、@haneinfo/common(^0.6.1 || ^0.7.0)、@haneinfo/plugin-host-nest(^2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haneinfo/identity-core 支持 TypeScript 吗?

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

@haneinfo/identity-core 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@haneinfo/identity-core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haneinfo/identity-core 可以商用吗?

@haneinfo/identity-core 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@haneinfo/identity-core 的下载量有多少?

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

@haneinfo/identity-core 还在维护吗?

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