세션과 비밀번호

설정

기기 로그아웃시키기

My account > Signed-in devices(내 계정 > 로그인된 기기)를 여세요. 행마다 “Firefox on Windows” 같은 기기 이름, 로그인한 시각, 마지막으로 쓴 시각이 나옵니다. 지금 쓰는 기기에는 This device(이 기기)라고 표시됩니다.
행에서 Sign out(로그아웃)을 선택하세요. 행이 사라지고, 그 기기는 다음 클릭 때 로그인 화면으로 갑니다.
또는 Sign out all other devices(다른 기기 모두 로그아웃)를 선택해 이 기기만 남기세요.

둘 다 비밀번호로 로그인한 상태이거나 관리자 범위의 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 키에는 관리자 범위가 필요합니다.