この記事は機械翻訳されています。
概要
SAML 2.0 IDプロバイダーを接続すると、メンバーは業務用アカウントでLegoraにサインインできます。この手順は、SAML、ADFS、PingFederateと、SAMLを使用するEntraエンタープライズアプリケーションに適用されます。プロバイダーの選択肢にあるEntra IDはOpenID Connectを使用します。前提条件
組織でLegoraのグローバル認証を使用し、操作するロールに認証セキュリティの管理権限が必要です。IDプロバイダーの管理者権限も必要です。認証の管理を参照してください。
仕組み
Legoraは新しいSAML接続ごとにサービスプロバイダーの値を確保します。その値をIDプロバイダーに登録し、アプリケーションのメタデータをLegoraに取り込みます。Legoraが、ACS(Assertion Consumer Service)URLでアサーションを受信します。 サービスプロバイダーのEntity ID (Identifier)はLegora接続を識別します。IDプロバイダーのEntity IDは発行者を識別します。新しい接続では、各ユーザーに対して、変化しない一意の値を持つid属性を送信してください。
接続の設定
最初にLegoraで接続ごとの値を取得します。新しい接続を準備する間は、既存の接続とユーザー識別子のマッピングを維持してください。Legoraで設定を開始する
- 名前のメニューから設定を選択します。ユーザーセクションで認証を選択します。
- SSOで追加を選択し、SAML、ADFSまたはPingFederateを選びます。
- 接続名を入力し、続行を選択します。
- **Entity ID (Identifier)とACS URL (Reply URL)**をコピーします。設定は後から再開できます。
IDプロバイダーを設定する
SAMLアプリケーションを作成し、Legoraに表示された値をそのまま入力します。Identifier、Entity IDまたはAudience URIには**Entity ID (Identifier)を、ACS、Single Sign-OnまたはReply URLにはACS URL (Reply URL)**を使用します。 接続に表示された値を省略せずにコピーしてください。末尾のスラッシュを追加したり削除したりしないでください。OktaではIdentifierのフィールド名は**Audience URI (SP Entity ID)**です。 Legoraサポートからサービスプロバイダーのメタデータリンクが提供された場合は、Entity IDとACS URLの両方が表示値と一致することを確認してください。IDプロバイダーのメタデータURLは、Legoraに取り込むアプリケーションの設定を示します。ユーザー識別子と属性をマッピングする
サインインしたユーザーのディレクトリレコードから、次のSAML属性を設定してください。
新しいSAML接続ごとに
idという属性を追加し、サインインしたユーザーの一意で変化しないディレクトリ識別子にマッピングしてください。NameID、別の識別子属性、メールアドレスから生成される代替値に依存せず、idを明示的に設定してください。
新しいアプリケーションでは、プロバイダーの手順に従ってこれらの属性を追加してください。
- Microsoft Entra ID
- Okta
- PingFederate
アプリケーション固有のSAMLクレームの追加を参照してください。表の属性名を使用し、Namespaceは空欄にします。
user.mailに値があることを確認してください。NameIDは、SAML応答のSubjectに含まれるユーザー識別子です。上の表の属性とは別のもので、明示的なid属性またはnameidentifier属性がNameIDより優先される場合があります。
NameIDの取得元と、送信されるidまたはnameidentifier属性を確認してください。いずれもサインインした個人を一貫して識別する必要があります。固定文字列、テナントID、アプリケーションID、共有アドレス、サインインのたびに生成される一時的な値は使用しないでください。表示名も重複や変更があるため不適切です。
プロバイダーと接続がNameIDの形式に対応していることを確認してください。メールベースの識別子には、アドレスの変更と再利用への対応が必要です。
標準属性のエイリアス
標準属性のエイリアス
既存のマッピングでは、次の接頭辞を付けた標準エイリアスを使用できます。
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/Legoraで設定を完了する
- 作成したアプリケーションのMetadata URLを入力するか、IDプロバイダーのEntity ID、Sign-In Endpoint URL、**Signing Certificate (PEM)**を入力します。
- 設定を完了を選択します。
- 新しい接続では、以下の管理された範囲での実際のサインイン検証まで、ステータスと自動プロビジョニングをオフにしておきます。
2人のテストユーザーで検証する
同じユーザーで2回サインインし、識別子が変わらないことを確認します。次に別のユーザーでサインインし、識別子が異なることを確認します。1回のサインインが成功しても、誤って共有された識別子が使われている可能性があります。 接続をテストはSAML属性の表示やユーザーの比較を行いません。 IDプロバイダーの管理者に、プロバイダーの応答ビューアーまたは組織が承認したSAMLトレースツールを使い、各テストサインインで送信されたSAML応答を確認してもらってください。値を確認できない場合は、接続を有効にする前にLegoraサポートにお問い合わせください。 新しい接続では、以下の各テストで明示的なidの値を確認してください。値がない、または空の場合は、接続をテストが成功しても、接続を有効にする前にマッピングを修正してください。既存の接続では、現在の識別子マッピングを変更せずに検証してください。
- IDプロバイダーのアプリケーションに、異なる2人のテストユーザーを割り当てます。2人ともLegora組織の既存メンバーで、それぞれ専用のディレクトリレコードと業務用メールが必要です。新しいアプリケーションでは、検証が完了するまでアクセスをこの2人に限定します。
- 接続をテストで1人目としてサインインします。
- IDプロバイダーの応答ビューアー、または組織が承認したSAMLトレースツールで、そのサインインの応答を開きます。
idとその他の識別子フィールドを確認します。これには、Subject内のNameIDと標準のnameidentifier属性が含まれます。 - 同じユーザーで新たにサインインし、識別子が変わらないことを確認します。
- 別のブラウザープロファイルまたはプライベートセッションで2人目としてサインインします。識別子が1人目と異なり、それぞれのメールと名前が正しいことを確認します。
- 新しい接続では、以下の管理された範囲でのサインイン検証に向けてステータスをオンにします。自動プロビジョニングはオフにしておきます。
- 広範な展開や自動プロビジョニングの前に、2人が実際にLegoraへサインインする検証を管理された範囲で行います。それぞれ自分のアカウントと想定した組織にアクセスすることを確認し、1人目の再サインインも確認します。設定ポップアップだけでは、このアカウントの確認は行われません。
- 2人ともこれらの確認を完了したら、計画に沿ってIDプロバイダーのアプリケーションへのアクセスを拡大します。意図した割り当てとメールドメインを確認してから自動プロビジョニングをオンにします。