API 参考

安全事件

Endpoint POST /api/v1/events with a security object

安全事件是带有 security 对象的普通事件。Blipit 按操作者和地址分组，并应用“告警”下的阈值。“登录尝试”指南有完整示例；本页是字段参考。

1security 对象

kind：login_failed、login_succeeded、login_blocked、password_reset_requested 或 privilege_granted。actor：尝试的登录名或邮箱（必填）。actor_id：已知时的解析后用户 id。ip：客户端地址。user_agent。database：多数据库主机上的实例标识。outcome：自由文本，如 bad_password 或 unknown_user。target：对于 privilege_granted，被授予的对象。

json

{
  "kind": "login_failed",
  "actor": "admin",
  "ip": "203.0.113.42",
  "user_agent": "Mozilla/5.0",
  "outcome": "bad_password"
}

2规则

每次尝试使用新的 event_id。绝不包含密码。从校验凭据的服务器用私密密钥发送。

3响应

202 {id} 已接收。403 {reason: 'security_needs_secret_key'} 表示用公钥发送。403 {reason: 'security_monitoring_not_in_plan'} 表示套餐不含安全监控；请暂停一段时间。

须知

安全事件始终保留完整载荷，且不受暂停告警影响。
勾选“监控交互式登录”后，Odoo 会自动发送这些事件。

遇到问题？发邮件至 support@blipit.io。每个项目的密钥和确切的 DSN 在 app.blipit.io 的“API 密钥”下。