如何将SQL Server数据库的用户列表同步至WSO2 Identity Server？

常规落地路径 #

从SQL Server数据库迁移全量用户到WSO2 IS，主要分为两类可落地的实现方式：

• 基于WSO2 IS内置身份源连接器的直连同步：将存储用户的SQL Server库配置为WSO2 IS的外部用户域，通过内置的字段映射规则匹配两边的用户属性（用户名、邮箱、姓名等），对齐密码哈希算法后，可通过内置同步任务拉取全量存量用户，后续也可支持定期增量拉取，不需要额外开发中间服务。
• 轻量ETL脚本同步：针对仅需一次性迁移的场景，可直接编写脚本从SQL Server查询全量用户数据，做属性格式转换后，通过接口写入WSO2 IS，省去长期维护连接器的成本。

全量同步API支持情况 #

WSO2 Identity Server 原生提供支持一次性完成全量用户导入的API能力，不需要逐用户循环调用单用户创建接口：

• 核心可用接口为SCIM 2.0协议下的批量操作端点，单条请求最多可携带1000条用户创建指令，调用时需携带具备用户创建权限的管理员访问令牌，请求体按照SCIM 2.0的用户schema组织每条用户的必填属性（用户名、初始密码）与可选属性（邮箱、手机号、所属组等），即可完成批量写入。
• 批量调用时可自行在客户端侧做分页拆分，只要不触发单请求的数量上限，即可一次性导完所有存量用户，不存在API层面的全量同步限制。

批量用户上传的指定文件格式 #

WSO2 IS自带的本地批量导入工具，对上传文件的格式有明确约定：

• 仅支持上传 UTF-8编码的CSV格式文件，文件首行必须为属性列头，列名需与WSO2 IS内置的用户属性标识完全匹配，常见有效列头包括 userName、password、email、givenName、familyName，如需指定用户所属分组，可增加groups列，同一用户对应的多个分组用分号分隔。
• 格式合规性要求：CSV文件不能携带BOM头，字段值中出现的逗号、双引号需按照CSV转义规则处理，否则会导致解析失败。

内容的提问来源于stack exchange，提问作者shakila sameera