会话和密码

设置

让一台设备退出登录

打开 My account > Signed-in devices（我的账户 > 已登录的设备）。每一行显示设备名称（比如“Firefox on Windows”）、登录时间和上次使用时间。你正在用的这台标着 This device（本设备）。
在某一行上点击 Sign out（退出登录）。你应该会看到这一行消失；那台设备下一次点击时会跳到登录页。
或者点击 Sign out all other devices（让其他所有设备退出登录），只保留这一台。

这两个操作都需要用密码登录，或者用带 admin 权限范围的 API 密钥。局域网免登录不够。

忘记密码

成员和管理员： 找所有者。

所有者： 在 HolyArrs 运行着的时候，在它所在的机器上运行：

docker exec -i holyarrs /holyarrs reset-owner

在第一行输入名字，下一行输入新密码，然后按 Ctrl+D。不用 Docker 的话，运行 holyarrs reset-owner。之后你应该就能用新密码登录了。

登录页的 Forgot the password?（忘记密码？）下面也有同样的步骤。

选项

登录状态能保持多久

事件	结果
7 天没有使用	设备退出登录
登录满 30 天	设备退出登录，不管有没有在用
你修改了密码	其他所有设备退出登录

设备和 API 密钥的上次使用时间最多可能滞后 1 小时。

其他人的设备

打开 Settings > Users and roles（设置 > 用户和角色），再点这个人旁边的 Devices（设备）。在某台设备上点击 Sign out，或者点击 Sign (name) out everywhere（让（名字）在所有设备上退出登录）。所有者可以对任何人这样做；管理员只能对成员这样做。停用某个人也会让他们在所有设备上退出登录。

如果不成功

现象： Sign out all other devices 被拒绝。 原因： 你是通过 API 密钥或局域网免登录进来的。 解决办法： 在浏览器里用密码登录，再试一次。

进阶

会话 API

路由	谁能用	作用
`GET /api/v1/auth/sessions`	任何已登录的人	你的设备：`id`、`device`、`created_at`、`last_used_at`、`expires_at`、`current`
`DELETE /api/v1/auth/sessions`	任何已登录的人	结束其他所有设备的会话。返回 `{"ended": n}`；用 API 密钥或局域网免登录时返回 400
`DELETE /api/v1/auth/sessions/{sid}`	任何已登录的人	结束一台设备的会话
`GET /api/v1/users/{id}/sessions`	所有者、管理员	某个人的设备
`POST /api/v1/users/{id}/sessions/end-all`	所有者、管理员	让某个人在所有设备上退出登录
`DELETE /api/v1/users/{id}/sessions/{sid}`	所有者、管理员	结束他们的一台设备的会话

id 是一个随机的公开值，不能用来登录任何人的账户。API 密钥需要 admin 权限范围。