MateFlow 为管理员提供了多种方式,将社区与技术栈的其余部分连接起来。所有功能都集中在一处:打开 Admin → 设置 → 集成,其中包含 集成(已连接的应用)、Webhook、API 访问、文档 和 活动 日志等标签页。单点登录在 Admin → 设置 → SSO 中单独配置。
已连接的应用
“集成”标签页列出了你只需点击几下即可连接的第三方服务。支持的应用包括 Zapier、Slack、Discord、Google Calendar 和 Mailchimp,以及一个自定义选项。点击 连接,提供所需的凭据,连接便会被安全存储。你可以随时在同一张卡片上断开连接。
Webhook
Webhook 会将社区中的事件推送到你所控制的任意 URL,使外部系统能够实时作出响应。若要创建 Webhook,请前往 Webhook 标签页,点击 添加 Webhook,然后设置:
- 名称和目标 URL
- 要订阅的一个或多个事件
- 一个签名密钥,以便你的端点能够验证每个请求确实来自 MateFlow
- 一个启用开关,用于在不删除该 hook 的情况下暂停投递
MateFlow 发出的事件涵盖成员、内容和付款:
| 类别 | 事件 |
|---|---|
| 成员 | member.joined, member.role_changed, member.suspended, member.reinstated |
| 内容 | post.created, post.deleted, comment.created, comment.deleted |
| 付款 | payment.received, payment.failed, subscription.created, subscription.renewed, subscription.canceled, refund.issued |
使用 测试 发送一个示例负载,并查看 活动 标签页中的投递日志(状态、响应码和成功率)来排查失败。Webhook 属于套餐功能,你的套餐决定了可创建的数量。
API 访问
API 访问 标签页可让你生成权限受限的 API 密钥,用于通过程序访问位于 https://api.mateflow.com 的公开 API。创建密钥时,你为其命名、选择权限(例如 site.read、content.read、content.write 和 media.write),并可选择将其限制为特定的 IP 地址。完整密钥在创建时仅显示一次,因此请立即复制。你可以在同一列表中吊销任意密钥。文档 标签页提供了端点参考。
单点登录(SSO)
在更高等级的套餐中,你可以要求成员通过你的身份提供商登录。MateFlow 支持 SAML 2.0 和 OIDC。在 Admin → 设置 → SSO 中,你粘贴或解析 IdP 元数据,将服务提供商的 Entity ID 和 ACS URL 复制回你的 IdP,并选择一个登录策略(SSO 加密码、SSO 加所有方式,或仅 SSO)。即时预配会在首次登录时创建账户,允许的域限定访问范围,恢复管理员可防止被锁定,审计标签页则跟踪 SSO 登录。在对所有人启用之前,请使用 测试连接。