personify/personify-scim-server
personify
基于Spring Boot的开源Java SCIM服务器实现，支持可插拔持久层和自定义授权过滤器，适用于身份暴露、系统间SCIM桥接，已与ForgeRock IDM等系统测试兼容。
下载次数: 0状态：社区镜像维护者：personify仓库类型：镜像最近更新：2 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
personify-scim-server
镜像概述和主要用途
personify-scim-server是一个轻量级、高性能的开源Spring Boot Java SCIM服务器实现，具备可插拔持久层和自定义授权过滤器。主要用于通过SCIM协议暴露企业身份，可作为配置引擎的目标点、认证/授权提供源，或作为不同系统/应用间的SCIM桥接工具。
核心功能和特性
已实现功能
- 完整的CRUD操作：创建、获取、更新、删除、搜索、部分更新（支持属性包含与排除）
- 批量操作：支持循环引用处理、最大操作数和最大负载大小限制
- 分页与排序功能
- 过滤功能：符合RFC 7644第3.4.2.2节规范（支持运算符、排序、分组）
- SCIM服务发现
- 模式验证与唯一性约束验证
- 认证机制：基本认证和OAuth bearer token（带角色控制）
- 与ForgeRock IDM SCIM连接器兼容的bearer token端点
- /ME端点支持
- 获取用户时返回所属组信息
待实现功能
- 批量处理器中的更新/部分更新/删除操作
- 多租户支持
- 自定义模式扩展（需进一步开发）
使用场景和适用范围
- 企业身份通过SCIM协议对外暴露
- 作为配置引擎的目标系统
- 作为认证或授权提供源
- 不同系统/应用间的SCIM协议桥接
- 开发、演示或生产环境中的身份管理服务
使用方法和配置说明
测试工具
- Postman集合：下载链接
- Insomnia集合：下载链接
连接详情
| 属性 | 值 |
|---|---|
| SCIM端点 | http://localhost:8080/scim/v2 |
| 基本认证 credentials | scim-user:changeit |
| OAuth credentials | scim-application-admin:changeit |
| OAuth token端点 | http://localhost:9090/scim/v2/token |
部署方式
1. 二进制文件部署
从下载页面获取二进制文件后运行：
bashjava -jar -Dserver.port=8080 personify-scim-server-2.0.1.RELEASE.jar
可通过命令行参数修改端口（如端口冲突时），也可配置SSL（参考Spring Boot文档及application.properties示例）。
2. 源码构建部署
环境要求：Java JDK 1.8+ 和 Maven
bash# 克隆项目 git clone https://bitbucket.org/wouter29/personify-scim-server.git # 构建 mvn clean install -Dgpg.skip # 运行 mvn spring-boot:run
3. Docker镜像部署
bash# 基本运行 docker run -p 8080:8080 personify/personify-scim-server # 指定版本 docker run -p 8080:8080 personify/personify-scim-server:2.0.1.RELEASE
4. Kubernetes部署
bash# 应用部署配置 kubectl apply -f kube-create-app.yaml # 暴露服务 kubectl expose deployment personify-scim-server --port=8080 --name=personify-scim-server
（需额外配置ingress路由暴露服务）
5. OpenShift部署
bashoc create -f create-app.yaml
环境变量配置
可通过环境变量覆盖application.properties中的配置，例如指定存储实现和数据库：
bashdocker run -p 8080:8080 \ -e scim.storage.implementation=... \ -e scim.storage.mongo.database=users \ personify/personify-scim-server:2.0.1.RELEASE
存储实现配置
提供多种存储实现，可通过配置选择：
- 内存存储：基础快速访问，支持文件持久化，适用于开发、演示和测试
- Mongo存储：可扩展，适用于开发和生产环境
- LDAP存储（实验性）：与ForgeRock Directory Server 6.5兼容，实现SCIM到LDAP的桥接
- PostgreSQL存储：稳定，自动创建表和索引
- MySQL存储：稳定，自动创建表和索引
- OrientDB存储：兼容OrientDB数据库
- CouchBase存储：支持索引，性能良好
- Personify Vault：提供工作流、配置和角色管理功能（需访问personify.be）
自定义模式配置
- 下载标准模式文件
- 修改或添加属性
- 通过命令行指定自定义模式文件路径：
bashjava -jar -Dserver.port=8080 personify-scim-server-2.0.1.RELEASE.jar -Dscim.schema.location=/tmp/disc_schema_custom.json
性能测试
单实例负载测试结果（基于AMD Ryzen 5 3400g 8核CPU，应用内存消耗约250MB，4线程，每线程5000请求）：
| 请求类型 | 内存存储 | MongoDB | LDAP | Postgres | MySQL | OrientDB | CouchBase |
|---|---|---|---|---|---|---|---|
| 创建用户 (req/s) | 882 | 790 | 497 | 630 | 644 | 718 | 745 |
| 创建组 (req/s) | 984 | 864 | 497 | 630 | 644 | 718 | 850 |
| 获取用户 (req/s) | 1537 | 1378 | 1056 | 1248 | 1367 | 1248 | 1210 |
| 获取用户+组 (req/s) | 389 | 333 | 1056 | 1248 | 1367 | 1248 | 592 |
| 搜索 (req/s) | 1525 | 1103 | ? | 1103 | 1141 | 993 | 393 |
| 查询所有ID (ms) | 109 | 123 | 495 | ||||
| 删除用户 (req/s) | 870 | 1194 | 756 | 1079 | 1068 | 472 | 1208 |
| 删除组 (req/s) | 1658 | 1212 | 756 | 1079 | 1068 | 472 | 1223 |
问题反馈与贡献
发现问题或有功能增强需求，请提交issue。欢迎贡献代码，共同完善SCIM生态。
致谢
- jingzhou wang：报告多个问题并编写初始Mongo存储实现
- steven jerman：实现部分更新功能和OKTA兼容性
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 personify-scim-server 镜像标签
docker pull docker.xuanyuan.run/personify/personify-scim-server:<标签>
DockerHub 原生拉取命令
docker pull personify/personify-scim-server:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"