ユーザーとロール
セットアップ
家族の一人ひとりに、必要な権限だけを持つ専用のアカウントを用意します。オーナーと管理者は Settings > Users and roles(設定 > ユーザーとロール)で作業します。
ユーザーを招待する
ユーザーを招待する へのリンク- Settings > Users and roles を開きます。
- Member(メンバー)を選びます。オーナーは Admin(管理者)も選べます。
- 権限を確認します。そのロールの既定の権限には、すでにチェックが入っています。
- リンクをだれに渡すのか覚えておきたい場合は、自分用のメモを追加します。
- リンクの有効期間を選びます。1 日から 30 日で、既定値は 7 日です。
- Make an invite link(招待リンクを作成)を選択し、その場でコピーします。リンクの全体が表示されるのは 1 回だけです。リンクは 1 回だけ使えます。
招待された人はリンクを開き、ほかと重ならない名前と、現在の最短の長さを満たすパスワードを決めます。そのままサインインした状態になります。
年齢制限を付けた子ども用のアカウントは、キッズアカウントを参照してください。
ロールと権限
ロールと権限 へのリンク| ロール | 意味 |
|---|---|
| オーナー | 最初のアカウント。すべての操作ができます。この画面では、だれも変更したりオフにしたりできません |
| 管理者 | 自分の権限の範囲で、メンバーとライブラリを管理します |
| メンバー | 通常はタイトルをリクエストし、自分のリクエストを確認します |
| 権限 | できること | 新しい管理者 | 新しいメンバー |
|---|---|---|---|
| Request titles(タイトルをリクエスト) | リクエストを出す | はい | はい |
| Requests approved without waiting(リクエストを待たずに承認) | リクエストが承認を待たずに通る | はい | いいえ |
| Approve or turn down requests(リクエストを承認または却下) | ほかの人のリクエストを判断する | はい | いいえ |
| Run the Library(ライブラリを運用) | 検索、整理など、ライブラリの作業を管理する | はい | いいえ |
| Change settings(設定を変更) | 通常の設定を開いて変更する | いいえ | いいえ |
だれが何を付与できるか:
- 管理者を招待したり、だれかを管理者にしたりできるのは、オーナーだけです。
- 管理者はメンバーの招待と変更ができ、付与できるのは自分が持っている権限だけです。
- 自分自身のロールや権限は、だれも変更できません。
ユーザーを変更する
ユーザーを変更する へのリンク- Settings > Users and roles を開き、ユーザーを選びます。
- ロールまたは権限を変更します。ロールを変えると、保存する前にそのロールの既定の権限にチェックが入ります。
- 任意: 映画、番組、音楽のリクエストについて、週あたりの上限をそれぞれ 0 から 1000 で設定します。空欄にすると Settings > Request rules(設定 > リクエストのルール)の既定値が使われます。0 は上限なしです。承認できる人に上限はありません。
- Save(保存)を選択します。
Turn off(オフにする)を使うと、その人はすべての場所でサインアウトされ、API キーが削除され、オンに戻すまでサインインできなくなります。アカウントは残ります。
これらの変更には、パスワードでのサインインが必要です。ローカルネットワークのショートカットで入った場合は、先にパスワードでサインインします。
2 要素サインインを設定する
2 要素サインインを設定する へのリンク各自が自分のアカウントで設定します。
- My account(マイアカウント)を開き、Two-factor(2 要素)を見つけて Set up(設定する)を選択します。
- 表示されたリンクまたはキーを使って、認証アプリにアカウントを追加します。
- アプリに表示された 6 桁のコードを入力します。
- 10 個のバックアップコードを安全な場所に保存します。表示されるのはこのときだけで、それぞれ 1 回だけ使えます。
新しいバックアップコードを作るときや、2 要素をオフにするときは、アプリの現在のコードか、未使用のバックアップコードを入力します。新しいコードを作ると、古いコードは使えなくなります。
オプション
オプション へのリンク管理者に 2 要素を必須にする
管理者に 2 要素を必須にする へのリンクオーナーが Settings > Sign-in and security(設定 > サインインとセキュリティ)でオンにします。オンにすると、2 要素を設定していない管理者は、設定を済ませるまで My account しか開けません。メンバーには影響しません。
プロフィール画像
プロフィール画像 へのリンクだれでも My account > Profile picture(マイアカウント > プロフィール画像)で設定できます。JPEG、PNG、WebP に対応し、5 MB までです。HolyArrs は中央の正方形を 256 × 256 ピクセルに切り抜きます。Remove(削除)を選ぶと、色付きのイニシャルに戻ります。
うまくいかないとき
うまくいかないとき へのリンク症状: 招待リンクが使えません。 原因: 使用済み、期限切れ、または取り下げ済みです。あるいは、リンクを作った人が、有効なオーナーまたは管理者ではなくなっています。 対処: 新しいリンクを作ります。Invite links(招待リンク)の一覧に、各リンクの状態が表示されます。オーナーは未使用のリンクをどれでも取り下げられ、管理者は自分が作ったものだけを取り下げられます。
症状: 管理者が権限にチェックを入れられません。 原因: 管理者が付与できるのは、自分が持っている権限だけです。 対処: オーナーに頼みます。
症状: 認証アプリとバックアップコードをなくした人がいます。
原因: サインインに使えるコードが残っていません。
対処: 管理者とメンバーの 2 要素はオーナーがリセットし、メンバーの 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 キーには write スコープが必要です。
関連ページ
関連ページ へのリンクHolyArrs は無料です。時間の節約になったら、GitHub でスターを付ける、スポンサーになる、コーヒーをおごるのいずれかで応援してください。