01
提交接入资料
填写企业名称、业务系统、计划接入的账号范围与联系人，提交后由对接工程师确认可行性并给出排期建议。
四步推进
接入四步，每一步都有明确交付物
每一步结束都会留下可核对的记录，避免联调阶段反复确认同一个问题。工程师在关键节点前主动同步进度。
02
环境与参数核对
收到应用标识、回调地址等参数后，核对访问域名、证书与测试环境，双方确认对接清单与联调时间窗。
03
联调与账号映射
在测试环境完成登录跳转、账号字段映射与权限分组配置，逐条验证登录成功、失败与超时三种分支。
04
灰度上线与验收
先放行小范围部门，观察登录日志与异常提醒，确认稳定后全量切换，并归档验收口径与回滚方案。
两种方式
标准自助接入与专属对接，按团队的实际情况选
两种方式的线上能力完全一致，区别在于谁来完成字段梳理、谁承担联调排期。可以先看差异，再决定提交哪一类需求。
适合两周内要上线的团队
- 按公开的接口说明与示例完成参数配置，不依赖人工介入
- 应用标识与回调地址可在线申请，有效期内随时更换测试环境
- 测试环境全天可用，登录日志与请求标识自助查询
- 遇到报错提交工单时附上请求标识，可快速定位失败节点
适合多系统并存或存在定制页面的团队
- 工程师一对一确认账号字段映射与权限分组方案
- 支持历史账号批量导入与组织架构同步，导入结果可逐条回查
- 可约定灰度节奏、回滚方案与验收口径，写入对接纪要
- 保留既有登录页样式，只接管验证环节与登录态返回
接入前准备
把四份材料准备好，联调当天就能跑通
资料越完整，参数下发与联调之间的等待越短。以下内容在提交需求时一并说明即可，无需提前开好权限。
- 管理员账号 一个可接收验证邮件的管理员账号，用于确认应用归属与后续参数变更。
- 域名与回调地址 计划接入系统的公网域名与回调地址，需与备案信息保持一致，避免联调时被拦截。
- 账号字段说明 需要映射的字段清单，例如工号、部门、手机号、邮箱，注明哪些字段作为唯一标识。
- 权限分组草案 首批试用的部门名单与权限范围，便于灰度阶段按部门逐步放行。
提交资料 当天
参数下发 1 个工作日
测试联调 1-3 个工作日
灰度上线 按部门推进
0 分钟
工作时段首次响应，需求表单提交后由对接工程师接手
0 个工作日
标准接口完成应用标识与回调地址下发
0 类映射
账号、组织架构与权限分组同步，变更可追溯
0×12 小时
技术支持在线，联调期间可直接对接工程师
适用场景
这几种接入情形，我们已经跑过很多次
不同团队的账号基础差别很大，先对齐场景再定方案，能省掉不少来回修改的时间。
多系统并存的总部与分支
一次登录跨越多个内部系统，权限随组织调整同步生效，分支机构的账号变动不必逐个系统修改。
需要批量开户的团队
历史账号一次性导入，重复工号与缺失字段会单独列出，导入结果可逐条回查后再正式启用。
有定制登录页的品牌方
保留自有页头与视觉样式，只接管验证环节与登录态返回，前端样式改动量保持在最小范围。
常见疑问
接入过程中被问得最多的几个问题
如果这里没有覆盖到你的情况，可以在页面底部提交需求，工程师会直接回复具体做法。
标准接口从提交资料到测试环境跑通，通常为两到三个工作日：资料确认与参数下发一个工作日，联调与账号映射一到三个工作日。涉及历史账号批量导入或多系统并存的，会由工程师给出单独的排期表。
多数系统只需增加登录入口与回调处理，不改变原有业务逻辑，原有账号数据也无需迁移。联调全部在测试环境完成，正式放量前会先选择小范围部门灰度，出现异常可按约定的方式回滚。
每次登录都会生成请求标识，在登录日志中按标识检索即可看到失败节点与原因码。常见原因是回调地址与备案域名不一致、应用标识过期或服务器时间偏差过大；工单中附上标识与发生时间，定位会更快。
可以。权限分组与组织架构支持在管理后台随时调整，变更会在下一次登录或同步周期内生效，调整记录写入操作日志，便于后续核对与审计。
企业名称、联系人与系统信息仅用于接入评估、参数下发与联调排期，按最小必要范围收集，不向第三方提供。联调结束后如不再需要，可按隐私说明中的方式申请删除。
接入需求
把接入需求交给对接工程师
填写企业名称、联系方式与计划接入的系统数量，工程师会先确认可行性，再给出参数下发与联调排期。
- 工作时段十分钟内首次响应，非工作时段次日跟进
- 先确认字段映射与权限范围，再安排测试环境联调
- 可申请先做小范围灰度，验证稳定后再全量切换
提交接入需求
带 * 的字段为必填项，其余可留空由工程师确认。
需求已记录，对接工程师将在工作时段十分钟内与你联系。
提交即表示同意我们按最小必要范围使用上述信息，仅用于接入评估与联调排期，不向第三方提供。详情见站内隐私说明。