사용자와 역할

집 안의 각 사람에게 필요한 권한만 가진 개인 계정을 주세요. 소유자와 관리자는 Settings > Users and roles(설정 > 사용자와 역할)에서 작업합니다.

사람 초대하기

1. Settings > Users and roles를 여세요.
2. Member(멤버)를 고르세요. 소유자는 Admin(관리자)도 고를 수 있습니다.
3. 권한을 확인하세요. 역할의 기본값은 이미 체크되어 있습니다.
4. 누구에게 줄 링크인지 기억해 두고 싶으면 비공개 메모를 추가하세요.
5. 링크의 유효 기간을 고르세요. 1일에서 30일까지이고 기본값은 7일입니다.
6. Make an invite link(초대 링크 만들기)를 선택하고 바로 복사하세요. 전체 링크는 한 번만 표시되고, 한 번만 쓸 수 있습니다.

초대받은 사람은 링크를 열고, 겹치지 않는 이름과 현재 최소 길이를 채우는 비밀번호를 정합니다. 그러면 바로 로그인됩니다.

연령 한도가 필요한 아이는 어린이 계정을 보세요.

역할과 권한

역할	의미
소유자	첫 번째 계정. 모든 것을 할 수 있습니다. 이 화면에서는 누구도 바꾸거나 끌 수 없습니다
관리자	가진 권한 안에서 멤버와 라이브러리를 관리합니다
멤버	보통 작품을 요청하고 자기 요청을 봅니다

권한	할 수 있는 일	새 관리자	새 멤버
Request titles (작품 요청)	요청하기	예	예
Requests approved without waiting (기다리지 않고 요청 승인)	요청이 승인을 건너뜁니다	예	아니요
Approve or turn down requests (요청 승인 또는 거절)	다른 사람의 요청을 결정합니다	예	아니요
Run the Library (라이브러리 운영)	검색, 정리, 라이브러리 작업 관리	예	아니요
Change settings (설정 변경)	일반 설정을 열고 바꿉니다	아니요	아니요

누가 무엇을 줄 수 있는지:

• 관리자를 초대하거나 누군가를 관리자로 만드는 것은 소유자만 할 수 있습니다.
• 관리자는 멤버를 초대하고 바꿀 수 있으며, 자신이 가진 권한만 줄 수 있습니다.
• 누구도 자기 역할이나 권한은 바꿀 수 없습니다.

사람 정보 바꾸기

1. Settings > Users and roles를 열고 사람을 고르세요.
2. 역할이나 권한을 바꾸세요. 역할을 바꾸면 저장하기 전에 그 역할의 기본값이 체크됩니다.
3. 선택 사항: 영화, 시리즈, 음악의 주간 요청 한도를 각각 0에서 1000 사이로 정하세요. 비워 두면 Settings > Request rules(설정 > 요청 규칙)의 기본값을 쓰고, 0은 한도 없음입니다. 승인 권한이 있는 사람에게는 한도가 없습니다.
4. Save(저장)를 선택하세요.

Turn off(끄기)는 그 사람을 모든 곳에서 로그아웃시키고, API 키를 지우고, 다시 켤 때까지 로그인을 막습니다. 계정은 남습니다.

이 변경은 비밀번호로 로그인한 상태여야 합니다. 로컬 네트워크 로그인 건너뛰기로 들어왔다면 먼저 비밀번호로 로그인하세요.

2단계 인증 설정하기

각자 자기 계정에서 직접 합니다.

1. My account(내 계정)를 열고 Two-factor(2단계 인증)를 찾아 Set up(설정)을 선택하세요.
2. 표시된 링크나 키로 인증 앱에 계정을 추가하세요.
3. 앱에 나온 6자리 코드를 입력하세요.
4. 백업 코드 10개를 안전한 곳에 저장하세요. 지금만 볼 수 있고, 코드마다 한 번만 쓸 수 있습니다.

백업 코드를 새로 만들거나 2단계 인증을 끄려면 현재 앱 코드나 쓰지 않은 백업 코드를 입력하세요. 새 코드가 이전 코드를 대체합니다.

선택 사항

관리자에게 2단계 인증 요구하기

소유자가 Settings > Sign-in and security(설정 > 로그인 및 보안)에서 켭니다. 그러면 2단계 인증이 없는 관리자는 설정을 마칠 때까지 My account만 열 수 있습니다. 멤버는 영향을 받지 않습니다.

프로필 사진

누구나 My account > Profile picture(내 계정 > 프로필 사진)에서 정할 수 있습니다. JPEG, PNG 또는 WebP, 최대 5 MB입니다. HolyArrs는 가운데 정사각형을 256 x 256 픽셀로 잘라 냅니다. Remove(제거)는 색이 들어간 이니셜로 되돌립니다.

문제가 생기면

증상: 초대 링크가 동작하지 않습니다. 원인: 이미 썼거나, 만료됐거나, 취소됐거나, 만든 사람이 더 이상 활성 소유자나 관리자가 아닙니다. 해결: 새로 만드세요. Invite links(초대 링크) 목록에 각 링크의 상태가 나옵니다. 소유자는 열려 있는 링크를 모두 취소할 수 있고, 관리자는 자기 것만 취소할 수 있습니다.

증상: 관리자가 권한에 체크할 수 없습니다. 원인: 관리자는 자신이 가진 권한만 줄 수 있습니다. 해결: 소유자에게 부탁하세요.

증상: 누군가 인증 앱과 백업 코드를 잃어버렸습니다. 원인: 로그인에 쓸 코드가 남아 있지 않습니다. 해결: 소유자가 관리자나 멤버의 2단계 인증을 재설정합니다. 관리자는 멤버의 것을 재설정합니다. 그 사람은 모든 곳에서 로그아웃되고, 비밀번호로 로그인한 뒤 다시 설정합니다. 소유자의 경우 비밀번호를 잊었을 때를 보세요. reset-owner는 소유자의 2단계 인증도 끕니다.

전문가용

사진 API

경로	하는 일
PUT /api/v1/account/avatar	본문으로 이미지를 보냅니다. {"avatar": "<address>"}로 응답합니다. 5 MB를 넘으면 413, JPEG, PNG, WebP가 아니면 415
DELETE /api/v1/account/avatar	내 사진을 지웁니다
GET /api/v1/users/{id}/avatar	한 사람의 사진, 없으면 404

GET /api/v1/auth/me와 GET /api/v1/users에는 avatar 또는 null이 들어 있습니다. 변경에는 평소의 CSRF 헤더가 필요하고, API 키는 쓰기 범위가 필요합니다.

관련 문서

• 로그인과 비밀번호
• 어린이 계정
• 세션과 비밀번호