接口与账号体系集成,单点登录对接
部署时最常被问到的是“能不能用我们现有的账号”。答案是能:既可以在 Ant Messenger 内单独建号,也可以把现有目录服务接进来,由原系统统一验证身份。
本页说明两条接入路径的做法与取舍,以及服务本身放在哪里。
先定服务放在哪里
私有化部署:服务端与数据都放在你选择的服务器或私有云中,我们提供部署包与文档,运行与备份由你方负责。用户信息、通信内容、数据文件三类数据均不出你方环境。
云托管:服务由我们运行的托管环境提供,你方按账号开通使用,无需准备服务器。功能集合与私有化部署一致,差别在运维归属。
再定账号从哪里来
路径一:本地账号
在管理侧导入成员名单,逐个或批量创建账号,密码由用户首次登录时设定。成员变动时按名单增删,适合人数不多、变动不频繁的团队。
路径二:目录服务对接
把现有的 LDAP 或 AD 接进来,由原系统校验身份,Ant Messenger 只保存映射关系。成员离职在目录侧停用后,客户端随即无法登录,不需要在两处分别操作。
路径三:单点登录
通过 OIDC 完成单点登录对接:用户在统一入口登录一次,进入 Ant Messenger 时不再重复输入。配置时需要提供客户端标识、回调地址与签名密钥,具体填写方式见官方文档。
集成时需要准备的四项
- 组织架构映射:部门层级与成员归属如何在聊天应用中呈现。
- 回调地址:接收事件通知的公网或内网地址,建议使用 HTTPS。
- 凭据管理:为每个接入应用单独分配凭据,避免共用。
- 上线顺序:先在沙箱跑通推送与回调,再切正式环境。
这四项确定之后,接入工作量基本可控;反过来,如果账号来源与回调地址没定,后续反复改配置的成本会比开发更高。
规模与安全
单群上限 10 万人,群消息经 TLS 加密传输;同一账号最多 5 台设备同时在线;云盘文件高强度加密,不限容量与时间。会话消息采用端到端加密,并支持阅后即焚与双向删除。
管理侧可统一配置设备上限、应用锁与会话留存策略,策略下发后各端按同一规则执行。
部署与集成问答
已经在用 AD,还要不要再建一套账号?
不需要。把 AD 接进来后由原系统验证身份,Ant Messenger 侧只维护映射。
单点登录失败,先查哪里?
先核对回调地址与客户端标识是否与登记一致,再看签名密钥是否过期;这两处占排查原因的大半。
私有化部署后,接口还能用吗?
能用。接口能力与服务一同部署,回调地址指向你方内网或公网入口即可。
迁移到另一种形态要停机吗?
建议安排在低峰期执行,迁移期间新消息的接收会受影响,具体窗口可与官方支持确认。