Skip to main content
この記事は機械翻訳されています。

概要

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で設定を開始する

  1. 名前のメニューから設定を選択します。ユーザーセクションで認証を選択します。
  2. SSOで追加を選択し、SAML、ADFSまたはPingFederateを選びます。
  3. 接続名を入力し、続行を選択します。
  4. **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を追加する場合や、識別子の取得元、形式、マッピングを変更する場合は、事前にLegoraサポートに連絡してください。メールアドレスが同じでも、識別子が変わると既存のアカウントへのアクセスに影響する可能性があります。移行計画について合意するまで、現在の設定を維持してください。
新しいSAML接続ごとにidという属性を追加し、サインインしたユーザーの一意で変化しないディレクトリ識別子にマッピングしてください。NameID、別の識別子属性、メールアドレスから生成される代替値に依存せず、idを明示的に設定してください。 新しいアプリケーションでは、プロバイダーの手順に従ってこれらの属性を追加してください。
アプリケーション固有の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で設定を完了する

  1. 作成したアプリケーションのMetadata URLを入力するか、IDプロバイダーのEntity ID、Sign-In Endpoint URL、**Signing Certificate (PEM)**を入力します。
  2. 設定を完了を選択します。
  3. 新しい接続では、以下の管理された範囲での実際のサインイン検証まで、ステータスと自動プロビジョニングをオフにしておきます。

2人のテストユーザーで検証する

同じユーザーで2回サインインし、識別子が変わらないことを確認します。次に別のユーザーでサインインし、識別子が異なることを確認します。1回のサインインが成功しても、誤って共有された識別子が使われている可能性があります。 接続をテストはSAML属性の表示やユーザーの比較を行いません。 IDプロバイダーの管理者に、プロバイダーの応答ビューアーまたは組織が承認したSAMLトレースツールを使い、各テストサインインで送信されたSAML応答を確認してもらってください。値を確認できない場合は、接続を有効にする前にLegoraサポートにお問い合わせください。 新しい接続では、以下の各テストで明示的なidの値を確認してください。値がない、または空の場合は、接続をテストが成功しても、接続を有効にする前にマッピングを修正してください。既存の接続では、現在の識別子マッピングを変更せずに検証してください。
  1. IDプロバイダーのアプリケーションに、異なる2人のテストユーザーを割り当てます。2人ともLegora組織の既存メンバーで、それぞれ専用のディレクトリレコードと業務用メールが必要です。新しいアプリケーションでは、検証が完了するまでアクセスをこの2人に限定します。
  2. 接続をテストで1人目としてサインインします。
  3. IDプロバイダーの応答ビューアー、または組織が承認したSAMLトレースツールで、そのサインインの応答を開きます。idとその他の識別子フィールドを確認します。これには、Subject内のNameIDと標準のnameidentifier属性が含まれます。
  4. 同じユーザーで新たにサインインし、識別子が変わらないことを確認します。
  5. 別のブラウザープロファイルまたはプライベートセッションで2人目としてサインインします。識別子が1人目と異なり、それぞれのメールと名前が正しいことを確認します。
  6. 新しい接続では、以下の管理された範囲でのサインイン検証に向けてステータスをオンにします。自動プロビジョニングはオフにしておきます。
  7. 広範な展開や自動プロビジョニングの前に、2人が実際にLegoraへサインインする検証を管理された範囲で行います。それぞれ自分のアカウントと想定した組織にアクセスすることを確認し、1人目の再サインインも確認します。設定ポップアップだけでは、このアカウントの確認は行われません。
  8. 2人ともこれらの確認を完了したら、計画に沿ってIDプロバイダーのアプリケーションへのアクセスを拡大します。意図した割り当てとメールドメインを確認してから自動プロビジョニングをオンにします。
識別子が変わる、2人の識別子が同じ、想定外のアカウントが表示される場合は、展開を止めてsupport@legora.comにお問い合わせください。トークン、秘密鍵、生のアサーションはメールやサポートチケットに含めないでください。

既存の接続を移行する

Legoraサポートと現在の識別子と変更予定の識別子を比較し、アカウントの移行が必要か確認してください。設定を変更する前に、段階的な適用、再サインインするユーザーが既存のアカウントにアクセスできることの確認、元の設定に戻す計画について合意してください。 グローバル認証への移行 新しい接続の設定値で別のアプリケーションを準備します。調整した切り替えの検証が終わるまで、稼働中のアプリケーションと共有または接続固有のコールバックを維持してください。全体の手順はグローバル認証の移行ガイドを参照してください。

トラブルシューティング

接続に表示された値を、IDプロバイダーの設定および属性マッピングと比較してください。

Reply URLまたはAudienceが拒否される

接続のIdentifierとACS URLを正確にコピーしてください。メタデータを取得できても、両方の値が一致するとは限りません。

プロフィールがない、または誤っている

上記のSAML属性名とユーザーごとの値を確認してください。本人に業務用メールアドレスがあり、設定したメール属性で送信されていることを確認してください。メタデータ設定の完了だけでは、ユーザーの属性は検証されません。

想定外のアカウントや識別子の変更

展開を止め、マッピングを変える前に、すべての識別子の取得元をサポートと確認してください。 解決しない場合はsupport@legora.comにお問い合わせください。