Chapter 5

アカウントとテナント

連携するアプリケーションが扱う2種類のアカウントと、テナントの分離について。

アカウントの種類

連携時に扱うアカウントは2種類です。API のレスポンスに含まれるuser.role は、このいずれかの値になります。

role	呼び方	位置づけ
`USER_PRIMARY`	オーナー	あなた自身のアカウント。自己登録するとこのロールになります。ユーザーの作成・管理と API キーの発行ができます
`USER_SECONDARY`	ユーザー	オーナーが作成するアカウント。あなたのサービスのエンドユーザーにあたります

オーナー1つと、それが作成したユーザーの集まりが1つの「テナント」です。テナントをまたいだ操作はできません。

オーナーが操作できるのは、自分が作成したユーザーだけです。他のオーナーが作成したユーザーは、一覧に表示されず、ID を直接指定しても取得・更新・削除のいずれもできません。API キーを使った場合も同じです。

この境界はデータベースへの問い合わせの時点で適用されるため、アプリケーション側で絞り込みを実装する必要はありません。

ユーザー（USER_SECONDARY）は管理画面にログインできません。表示名や電話番号といった項目は、オーナーが管理します。アカウントの削除も、作成したオーナーが行います。

オーナーは管理画面からメールアドレスを指定して招待できます。招待された方は、そのアドレスの Google アカウントでサインインして参加します。パスワードの設定は不要です。

段階	内容
1. 発行	オーナーがアドレスを指定。招待リンクがその場で表示される
2. 受け渡し	メール送信が有効なら自動送信。無効ならリンクを直接渡す
3. 参加	招待された本人が Google でサインインし、参加を確定する

サインインしたアカウントのアドレスが招待先と一致しない場合、参加は拒否されます。また、すでに自分のメンバーを持つアカウントは他のテナントに参加できません。招待リンクの有効期限は7日です。

オーナーは管理画面の「テナント管理」から、自分のテナントに所属するユーザーへ適用する規則を設定できます。初期状態ではすべて既定値で、設定するまで動作は変わりません。

ポリシーはシステム既定より厳しくする方向にのみ設定できます。たとえばパスワードの最小文字数を8文字未満にすることはできません。既存ユーザーのパスワードは、次回変更時から新しい要件が適用されます。

API キーは発行したアカウントの権限を引き継ぎます。オーナーが発行したキーは、そのテナントの範囲でのみ動作します。ただし、キー自身の発行・失効と、発行者のパスワード変更・アカウント削除はキーからは実行できません。

サービス運営側には、障害対応やお問い合わせ対応のための管理アカウントが別途あります。運営がアカウントに対して行った操作は、対象・日時・実行者とともにすべて記録され、削除できません。