シングルサインオン
テナントごとに、OpenID Connect に対応した IdP(アイデンティティプロバイダー) を 1 つ接続できます。Microsoft Entra ID、Okta、Keycloak などが使えます。接続すると、そのテナントの従業員は A2Flow 専用のパスワードではなく、会社のアカウントでログインします。初回のログインで A2Flow のアカウントが作られ、IdP のグループによって、その人がどのユーザーグループに属すか、つまりどのロールを持つかが決まります。
シングルサインオンを有効にしても、パスワードでのログインは引き続き使えます。上位管理者のアカウントはどのテナントにも属さないので、常にパスワードでログインします。
仕組み
はじめる前に
- テナントの管理者ロールが必要です。
- 運用者がデプロイ時に、デプロイのベース URL を設定している必要があります。サーバーの設定を参照してください。設定されていない間は、管理者設定の リダイレクト URI の代わりに警告が表示され、シングルサインオンは使えません。
- A2Flow から IdP に、パブリックなアドレスで接続できる必要があります。プライベートネットワーク上の IdP は、運用担当者がそのホストを許可して初めて使えます。設定リファレンスのシングルサインオンを参照してください。
自前の IdP なしでシングルサインオンを試すには、Docker Compose の構成に含まれる Keycloak を起動します。Keycloak でシングルサインオンを試すを参照してください。
設定する
- IdP で、A2Flow 用のアプリケーションを新しく登録します。クライアントシークレットを持つ Web アプリケーションとして登録します。発行者 URL、クライアント ID、クライアントシークレットを控えます。
- A2Flow で管理サイドバーの管理者設定を開き、シングルサインオンセクションを探します。リダイレクト URIの横のコピーを押し、そのアドレスを IdP のアプリケーションのリダイレクト URI として登録します。利用者がテナント専用のアドレスで A2Flow を開く場合は、リダイレクト URI (テナントのアドレス) も登録します。
- IdP で、アプリケーションの ID トークンに、各人が属するグループの一覧(グループクレーム)を含めるよう設定します。これを忘れるとロールが外れてしまいます。詳しくは知っておくことを参照してください。
- 下の表を見ながらセクションの項目を入力し、シングルサインオンを有効にするにチェックを入れます。
- 保存します。保存時には、発行者 URL が許可されたアドレス(
https、または運用担当者が許可したホスト)であることを確認し、シングルサインオンを有効にするにチェックを入れている場合は、発行者 URL、クライアント ID、クライアントシークレットが入力されていることも確認します。IdP には接続しないので、実際の確認は次の手順で行います。 - IdP のグループに従わせたいユーザーグループごとに、ユーザーグループからそのグループを開き、IdP グループを入力します。詳しくはグループとロールを参照してください。
- 試します。ログイン画面を開き、テナント名を入力して SSO でログインを押します。
| 項目 | 説明 |
|---|---|
| シングルサインオンを有効にする | スイッチです。オンにするには、発行者 URL、クライアント ID、クライアントシークレットが必要です。 |
| 発行者 URL | IdP の OpenID Connect 発行者です。たとえば https://idp.example.com。 |
| クライアント ID | IdP でのアプリケーションのクライアント ID。 |
| クライアントシークレット | 書き込み専用で、表示されることはありません。保存後は「保存済み — 維持するには空欄のままにしてください」と表示されます。 |
| グループクレーム | 各人のグループを列挙する ID トークンのクレーム名です。IdP が別の名前を使っていない限り groups です。 |
| この IdP のメールアドレスを信頼する | 初期状態はオフです。IdP がメールアドレスを確認済みとしていなくても、A2Flow がメールアドレスで既存のアカウントを紐付けられるようにします。Microsoft Entra ID ではオンにする必要があります。 |
| リダイレクト URI | 読み取り専用です。IdP に登録するアドレスで、どのテナントでも同じものを使います。 |
| リダイレクト URI (テナントのアドレス) | 読み取り専用です。テナント専用のアドレスで始めたログインの戻り先です(テナントのアドレスでログインするを参照)。利用者がそのアドレスで A2Flow を開く場合は、こちらも登録します。デプロイのアドレスが IP アドレスの場合は表示されません。 |
ログインする
ログイン画面のテナントにテナント名を入力し、SSO でログインを押します。テナントが空の間、ボタンは押せません。IdP に移動するので、そこでログインすると、A2Flow にログインした状態で戻ってきます。ユーザー名とパスワードでのログインも、これまでどおり使えます。
A2Flow からログアウトしても IdP からはログアウトされません。そのため、もう一度 SSO でログインを押すと、そのままログインできてしまうことがあります。
テナントのアドレスでログインする
各テナントは、専用のアドレスでも開けます。テナントのアドレスは、いつものアドレスの前にテナント名を付けたもので、例えば acme.a2flow.example.com です。運用者がそのための DNS と証明書を用意している必要があります。このときログイン画面にテナント欄はありません。
| テナントの設定 | 起きること |
|---|---|
| シングルサインオンが有効 | ログイン画面を経由せず、IdP へ直接移動します。 |
| シングルサインオンが無効 | 画面はユーザー名とパスワードだけを求めます。 |
ログアウトすると、ログアウトしたことを伝えるページが表示されます。もう一度ログインを押すとログイン画面に戻ります。シングルサインオンが有効な場合は IdP へ移動し、IdP 側のログインが残っていればそのままログインされます。
シングルサインオンに失敗した後は、IdP へは自動で移動しません。代わりにSSO でログインが表示され、パスワードでログインを押すとユーザー名とパスワードの欄が現れます。パスワードを持つアカウントはこれを使います。いつものアドレスでテナントにテナント名を入力して、パスワードでログインすることもできます。
IdP へ移動せずにパスワードでログインしたいとき(IdP のアカウントを持たないアカウントなど)は、ログイン画面のアドレスに ?local を付けて開きます。例えば https://acme.a2flow.example.com/login?local です。画面は最初からユーザー名とパスワードの欄を表示した状態で開きます。
ログインエラーのメッセージ
ログインに失敗すると、ログイン画面に戻り、次のいずれかのメッセージが表示されます。
| メッセージ | 意味と対処 |
|---|---|
| このテナントではシングルサインオンを利用できません。 | テナント名が違うか、テナントが無効か、シングルサインオンが未設定またはオフです。どれなのかは、あえて表示しません。どのテナントが存在するかを、このメッセージから探れないようにするためです。名前を確認し、それでもだめならテナントの管理者に尋ねてください。 |
| シングルサインオンに失敗しました。もう一度お試しください。 | IdP とのやり取りが完了しなかったか、IdP からメールアドレスが届かなかった(または使えないアドレスだった)か、テナント内の 2 つのアカウントが同じメールアドレスを持っているか、そのメールアドレスのアカウントがすでに別の IdP の ID に紐付いているか、IdP のメールアドレスが信頼できない状態で同じアドレスの A2Flow アカウントがすでにあります。最後の場合は、テナントの管理者にこの IdP のメールアドレスを信頼するをオンにするか、2 つのアカウントのどちらかのメールアドレスを変更するよう依頼してください。それ以外の場合はもう一度試し、それでも失敗する場合は、テナントの管理者に設定と IdP に登録したアプリケーションの確認を依頼してください。 |
| アカウントが無効です。 | A2Flow のアカウントかテナント全体が無効になっているか、アカウントが削除されています。管理者が有効にチェックを入れると、アカウントを再び使えるようになります。 |
| お使いの IdP アカウントは A2Flow へのログインが許可されていません。 | A2Flow のアカウントがまだなく、ユーザーグループの対応付け先になっている IdP グループにも属していません。または、所属グループが非常に多いため、IdP がグループの一覧を省いています。IdP の管理者に、対応付けられたグループへ追加するよう依頼してください。 |
アカウントとの対応付け
A2Flow はログインのたびに、次の順でアカウントを探します。
- この IdP の ID にすでに紐付いているアカウントがあれば、それを使います。
- 同じメールアドレスの既存アカウントがあれば、1 度だけ紐付けます。メールアドレスは大文字小文字を区別せずに比べます。紐付けるのは、IdP がそのアドレスを確認済みとしている場合、またはこの IdP のメールアドレスを信頼するがオンの場合だけです。紐付けられていないアカウントがちょうど 1 つ一致する必要があり、2 つ以上一致するとログインに失敗します。
- どちらもなければ新しいアカウントを作ります。 ただし作るのは、ユーザーグループの対応付け先になっている IdP グループに 1 つ以上属している人だけです。それ以外の人は拒否されます。 新しいアカウントは、テナント内のアカウントがすでに持っているメールアドレスに対しては作られず、IdP のメールアドレスが使えるアドレスでない場合も作られません。いずれもログインに失敗します。
新しいアカウントのユーザー名は、IdP の preferred username から、なければメールアドレスの @ より前の部分から作ります。英数字、.、_、- 以外の文字は取り除かれ、残りが少なすぎる場合は user になり、すでに使われている名前には -2、-3 のように番号を付けます。名と姓は IdP のものです。アカウントには直接のロールもパスワードもなく、ロールはグループから得ます。管理者があとからパスワードを設定して、予備の手段にすることもできます。
既存のアカウントの名前とメールアドレスが、IdP の値で上書きされることはありません。
グループとロール
ユーザーグループの IdP グループには、そのグループについて IdP のグループクレームが列挙する値を入れます。Microsoft Entra ID が送るのはグループの名前ではなくオブジェクト ID なので、その ID を入力します。一致は完全一致で、大文字と小文字を区別します。
SSO でログインするたびに、IdP グループを持つユーザーグループそれぞれについて、次のようになります。
- クレームにその値が含まれていれば、その人はグループに加わります。
- 含まれていなければ、グループから外れます。
IdP グループのないユーザーグループと、アカウントに直接与えられたロールには、何も起きません。IdP でグループを変更した内容は、その人の次の SSO ログイン時に反映され、すぐには反映されません。
IdP グループを持つグループのメンバーは IdP が管理するので、手作業では編集できません。グループのページではメンバーの一覧が読み取り専用になり、「IdP が管理しています」と表示されます。そのようなグループを、ユーザーのグループに追加したり、そこから外したりすることもできません。すでにメンバーがいるグループにIdP グループを入力した場合、メンバーは各人の次の SSO ログインまでそのまま残ります。
知っておくこと
| 状況 | 結果 |
|---|---|
| IdP がグループクレームを送らない、またはグループクレームの名前が合っていない | ログインした全員が、対応付けられたすべてのグループから外れ、そのグループが与えていたロールを失います。シングルサインオンを有効にする前に、IdP 側のクレームを確認してください。 |
| Microsoft Entra ID | グループの名前ではなくオブジェクト ID を送ります。所属グループが非常に多い人については、一覧を省きます。その場合、A2Flow はその人の現在の所属を保ち、新しいアカウントは作れません。 |
| 発行者 URL またはクライアント IDを変更した | アプリケーションが変わると IdP は別の ID を発行するので、テナント内のすべてのアカウントが IdP の ID との紐付けを解かれます。次のログイン時にメールアドレスで再び紐付けられますが、信頼できるアドレス(IdP が確認済みとしているか、この IdP のメールアドレスを信頼するがオン)が必要です。そうでない場合は、元のアカウントがそのアドレスをまだ持っているためログインに失敗します。 |
| IdP から誰かを削除した | その人は SSO でログインできなくなりますが、A2Flow はそのアカウントを無効にしません。パスワードでのログインも止めるには、アカウントの有効を外してください。 |
| アカウントに SSO バッジが付いている | シングルサインオンでログインしたことがあるアカウントです。バッジはユーザーの一覧とアカウントの詳細ページに表示されます。 |
| 利用者がテナント専用のアドレスで A2Flow を開く | そこで始めたシングルサインオンは、リダイレクト URI (テナントのアドレス) を通ってそのアドレスに戻ります。このアドレスを IdP に登録するまで、IdP はログインを拒否します。 |