メインコンテンツまでスキップ

代理ログイン

代理ログインは、権限を持つユーザーがほかのユーザーとして振る舞う仕組みです。その人に何が見えているのかを再現したり、その人の代わりに何かを実行したりするために使います。代理ログイン中のリクエストはすべて代理ログイン先のユーザーに帰属し、代理ログインのセッションはすべて記録されます。開始するには管理者(または上位管理者)ロールが必要です。

誰が誰として代理ログインできるか​

操作者 \ 対象上位管理者ロールを持つ管理者ロールを持つそれ以外のユーザー
上位管理者❌✅ プラットフォーム全体✅ プラットフォーム全体
管理者❌❌✅ 自テナントのみ
それ以外のロール❌❌❌ — 操作自体が出ません

この表の形にこそ意味があります。代理ログインを使って、操作者がまだ持っていない権限を得ることはできません。通常の管理者は同格の管理者として代理ログインできませんし、上位管理者が管理者として代理ログインしても何も増えません。管理者が通るゲートはすでにすべて素通りしているからです。

対象側は実効ロールで判定します。ユーザーグループから継承した管理者ロールも、直接付与されたものとまったく同じように持ち主を守ります。そうでなければ、グループが上の表を迂回する抜け道になってしまいます。

ロールとは関係なく拒否される対象がほかに 4 つあります。自分自身、初期投入されるシステムユーザー、無効化されたユーザー、論理削除されたユーザーです。また管理者から見て他テナントの対象は、403 ではなく HTTP 404 で返ります。テナントをまたいだ参照が、そのユーザーの実在を裏づけることはありません。

開始と終了​

開始はユーザー一覧の代理ログイン操作からです。確認すると、そのユーザーとしてようこそページに着きます。実行中はヘッダーに「<user> として操作中」のチップが出て、代理ログインを終了ボタンで終了できます。

同時に開ける代理ログインは 1 つだけです。新しく始めると、開いていたものは閉じます。終了はいつ呼んでも安全で、何も開いていなくてもエラーにはなりません。

実効的な身元​

代理ログインはセッションの差し替えではなく、リクエストヘッダーによる上書きです。実際のセッションクッキーは変わりません。ブラウザは選んだユーザーの ID を各リクエストに付けるだけで、バックエンドはそこから実効的な身元を解決します。ここから 2 つのことが導かれます。

  • 実際の操作者のセッションは下でそのまま生きているので、終了するときに再度ログインする必要はありません。
  • リクエストが触れるものはすべて、読み取りも書き込みも、監査用の createdBy と updatedBy フィールドも、代理ログイン先のユーザーに帰属します。そのユーザー自身がログインしている場合とまったく同じです。ロールのチェックも代理ログイン先の実効ロールに対して行われます。上位管理者が依頼者として振る舞えば、依頼者のゲートで判定され、依頼者が見る UI が見えます。

開始と終了のエンドポイントだけは意図的な例外で、実効的な身元ではなく実際の操作者のロールで判定します。そうしないと、あえて権限のないユーザーとして代理ログインした管理者が、自分の「終了」の呼び出しでロールチェックに落ちて、そこから抜け出せなくなります。

代理ログインが無効になるとき​

適格かどうかは、開始時だけでなく毎リクエスト再検証されます。上の表はロールに依存していて、ロールは動くからです。代理ログインが成立しなくなったとき、リクエストは失敗しません。静かに実際の操作者に戻り、古い記録を閉じます。対象が無効化・削除された場合、対象が昇格した場合(管理者ロールを付与するグループに入れられた場合を含みます)、操作者が管理者ロール(直接の付与でも、付与するグループからの脱退でも)や上位管理者ロールを失った場合、操作者が対象と同じテナントでなくなった場合、別の場所で終了された場合が、これにあたります。

代わりにリクエストを失敗させると、役に立たないどころか害になります。選択はブラウザのローカルストレージにあるので、エラーにしてしまうと、古い値 1 つで正当な管理者がアプリケーション全体から締め出されかねません。

監査証跡​

代理ログインのセッションは、誰が誰にいつ、という形で impersonation_events テーブルに永続的に記録されます(設定リファレンスを参照)。createdBy と updatedBy に入るのは代理ログイン先のユーザーなので、「その書き込みの後ろにいたのは実際には誰か」に答えられるのはこの証跡だけです。だからこれは省略可能な機能ではありません。

管理者はこの証跡を監査ログの代理ログインタブで読めます。自テナントのアカウントが関わったセッションが、上位管理者が開始したものも含めてすべて並びます。