接口接入

接口与账号体系集成,单点登录对接

部署时最常被问到的是“能不能用我们现有的账号”。答案是能:既可以在 Ant Messenger 内单独建号,也可以把现有目录服务接进来,由原系统统一验证身份。

本页说明两条接入路径的做法与取舍,以及服务本身放在哪里。

先定服务放在哪里

私有化部署:服务端与数据都放在你选择的服务器或私有云中,我们提供部署包与文档,运行与备份由你方负责。用户信息、通信内容、数据文件三类数据均不出你方环境。

云托管:服务由我们运行的托管环境提供,你方按账号开通使用,无需准备服务器。功能集合与私有化部署一致,差别在运维归属。

官方说明:两种形态可以互相迁移。迁移时以导出导入工具完成,会话与文件随账号一并搬迁。

再定账号从哪里来

路径一:本地账号

在管理侧导入成员名单,逐个或批量创建账号,密码由用户首次登录时设定。成员变动时按名单增删,适合人数不多、变动不频繁的团队。

路径二:目录服务对接

把现有的 LDAP 或 AD 接进来,由原系统校验身份,Ant Messenger 只保存映射关系。成员离职在目录侧停用后,客户端随即无法登录,不需要在两处分别操作。

路径三:单点登录

通过 OIDC 完成单点登录对接:用户在统一入口登录一次,进入 Ant Messenger 时不再重复输入。配置时需要提供客户端标识、回调地址与签名密钥,具体填写方式见官方文档。

集成时需要准备的四项

  • 组织架构映射:部门层级与成员归属如何在聊天应用中呈现。
  • 回调地址:接收事件通知的公网或内网地址,建议使用 HTTPS。
  • 凭据管理:为每个接入应用单独分配凭据,避免共用。
  • 上线顺序:先在沙箱跑通推送与回调,再切正式环境。

这四项确定之后,接入工作量基本可控;反过来,如果账号来源与回调地址没定,后续反复改配置的成本会比开发更高。

规模与安全

单群上限 10 万人,群消息经 TLS 加密传输;同一账号最多 5 台设备同时在线;云盘文件高强度加密,不限容量与时间。会话消息采用端到端加密,并支持阅后即焚与双向删除。

管理侧可统一配置设备上限、应用锁与会话留存策略,策略下发后各端按同一规则执行。

部署与集成问答

已经在用 AD,还要不要再建一套账号?

不需要。把 AD 接进来后由原系统验证身份,Ant Messenger 侧只维护映射。

单点登录失败,先查哪里?

先核对回调地址与客户端标识是否与登记一致,再看签名密钥是否过期;这两处占排查原因的大半。

私有化部署后,接口还能用吗?

能用。接口能力与服务一同部署,回调地址指向你方内网或公网入口即可。

迁移到另一种形态要停机吗?

建议安排在低峰期执行,迁移期间新消息的接收会受影响,具体窗口可与官方支持确认。

官方支持:Postmaster@mail.antmessengera.im

先把账号打通,再谈其他

部署包、SDK 与文档均从官方入口获取。

官方下载 查看安全说明