身份验证
登录、令牌刷新、密码重置、SSO 完成——以及通过 API 密钥进行的 API 访问。
此分组涵盖用户登录:使用电子邮件地址或用户名及密码登录、通过刷新令牌续期会话、重置遗忘的密码,以及完成单一登录(SAML/OIDC)。这些端点会返回一个访问令牌(JWT),该令牌通过 `Authorization: Bearer <token>` 请求头发送,以及一个刷新令牌,每次使用后都会被替换为新的令牌。
对于您自有程序对数据的机器访问,请使用 `https://zentor-app.de/api/v1` 下 REST API 的 API 密钥,而非用户登录。Zentor 会按请求开通 API 访问;之后管理员可在仪表盘的“API 密钥”下创建具有既定权限(scope)的密钥。密钥通过 `Authorization: Bearer <API 密钥>` 请求头或 `X-API-Key` 请求头发送。scope、错误代码以及安全保管密钥的建议,请参见 API 参考概览。
登录端点受到保护,可防止反复失败的尝试:在多次输入错误后,服务器会延迟进一步的尝试,并以 429 `RATE_LIMIT_EXCEEDED` 临时阻止。