コンテンツにスキップ

ユーザーとロール

セットアップ

家族の一人ひとりに、必要な権限だけを持つ専用のアカウントを用意します。オーナーと管理者は Settings > Users and roles(設定 > ユーザーとロール)で作業します。

  1. Settings > Users and roles を開きます。
  2. Member(メンバー)を選びます。オーナーは Admin(管理者)も選べます。
  3. 権限を確認します。そのロールの既定の権限には、すでにチェックが入っています。
  4. リンクをだれに渡すのか覚えておきたい場合は、自分用のメモを追加します。
  5. リンクの有効期間を選びます。1 日から 30 日で、既定値は 7 日です。
  6. Make an invite link(招待リンクを作成)を選択し、その場でコピーします。リンクの全体が表示されるのは 1 回だけです。リンクは 1 回だけ使えます。

招待された人はリンクを開き、ほかと重ならない名前と、現在の最短の長さを満たすパスワードを決めます。そのままサインインした状態になります。

年齢制限を付けた子ども用のアカウントは、キッズアカウントを参照してください。

ロール 意味
オーナー 最初のアカウント。すべての操作ができます。この画面では、だれも変更したりオフにしたりできません
管理者 自分の権限の範囲で、メンバーとライブラリを管理します
メンバー 通常はタイトルをリクエストし、自分のリクエストを確認します
権限 できること 新しい管理者 新しいメンバー
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 要素サインインを設定する

2 要素サインインを設定する へのリンク

各自が自分のアカウントで設定します。

  1. My account(マイアカウント)を開き、Two-factor(2 要素)を見つけて Set up(設定する)を選択します。
  2. 表示されたリンクまたはキーを使って、認証アプリにアカウントを追加します。
  3. アプリに表示された 6 桁のコードを入力します。
  4. 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 でスターを付ける、スポンサーになる、コーヒーをおごるのいずれかで応援してください。