Microsoft Entra ID で SSO を設定する

Microsoft Entra ID で Lingo.dev 用のエンタープライズアプリケーションを作成し、ユーザーを割り当てて組織に接続し、SCIM 経由でメンバーをプロビジョニングする手順を説明します。

このガイドでは、SAML 2.0 を使って Microsoft Entra ID を Lingo.dev に接続します。Entra ではクラウドアプリケーション管理者以上のロールが必要です。また、Enterprise プランを利用している Lingo.dev 組織のオーナーである必要があります。Lingo.dev の SSO の仕組みについては、シングルサインオンをご覧ください。

Lingo.dev で 設定 → SSO を開いたままにしてください。ここに表示される2つの値をコピーして Entra に入力します。

エンタープライズアプリケーションを作成する #

  1. Microsoft Entra 管理センターにサインインします。
  2. Entra ID → エンタープライズアプリケーション → すべてのアプリケーションに移動し、新しいアプリケーションを選択します。
  3. 独自のアプリケーションの作成を選択します。
  4. 名前に Lingo.dev を入力し、ギャラリーに見つからないその他のアプリケーションを統合します(ギャラリー以外) を選んで、作成を選択します。

SAML を構成する #

  1. 作成したアプリケーションでシングルサインオンを開き、SAML を選択します。
  2. 基本的な SAML 構成で、編集を選択します。
  3. 識別子(エンティティ ID) で、識別子の追加を選択し、https://auth.lingo.dev/auth/v1/sso/saml/metadata(Lingo.dev のエンティティ ID)を貼り付けます。
  4. 応答 URL(アサーションコンシューマーサービス URL) で、応答 URL の追加を選択し、https://auth.lingo.dev/auth/v1/sso/saml/acs(Lingo.dev の ACS URL)を貼り付けます。
  5. サインオン URL、リレー状態、ログアウト URLは、いったん空欄のままにして、保存を選択します。サインオン URL は接続後に、Microsoft マイアプリからサインインするの手順で設定します。

属性とクレームは既定のままにします。Entra 管理センターで作成したアプリは、user.mail から取得したユーザーのメールアドレスを emailaddress クレームで送信し、メールアドレス形式の名前 ID も送信します。サインインするすべてのユーザーに、Entra でメールアドレスが設定されていることを確認してください。

Microsoft Graph API 経由で作成した場合など、既定のクレームがないアプリはメールアドレスを送信しません。その場合、「認証プロバイダーからメールアドレスが送信されませんでした。」と表示され、サインインに失敗します。属性とクレームで、ソース属性を user.mail に設定したメールクレームを追加してください。

メタデータ URL をコピーする #

SAML 証明書で、アプリのフェデレーションメタデータ URL をコピーします。

ユーザーとグループを割り当てる #

  1. アプリケーションでユーザーとグループを開き、ユーザーまたはグループの追加を選択します。
  2. ユーザーとグループで、選択されていませんを選択します。ユーザーまたはグループを選び、選択を選択します。
  3. 割り当てを選択します。
  4. プロパティを開き、割り当てが必要ですか?をはいに設定して、保存を選択します。

割り当てが必要ですか?をはいに設定すると、割り当てられたユーザーだけが Entra 経由で Lingo.dev にサインインできます。いいえにすると、ゲストアカウントを含むテナント内のすべてのユーザーがアプリにアクセスできます。ただし、Lingo.dev の組織に参加できるのは接続済みドメインのアカウントだけです。それ以外のユーザーは再びサインアウトされます。Microsoft Graph API 経由で作成したアプリでは、初期設定がいいえになっています。グループの割り当てには Microsoft Entra ID P1 または P2 が必要です。無料プランでは、ユーザーを1人ずつ割り当ててください。

Lingo.dev で接続する #

  1. 設定 → SSO を開きます。
  2. アプリのフェデレーションメタデータ URL を認証プロバイダーのメタデータ URL に貼り付けます。
  3. メールドメインに、会社のメールドメインをカンマ区切りで入力します。
  4. 接続を選択します。

ドメインが拒否された場合は、ドメインのルールをご覧ください。

サインインをテストする #

  1. ブラウザーのプライベートウィンドウを開き、Lingo.dev のサインインページにアクセスします。
  2. SSO で続行を選択し、割り当てたユーザーのメールアドレスを入力して、サインインを選択します。
  3. Microsoft でサインインします。

組織のメンバーとして Lingo.dev に戻ります。組織ページに表示されるメールアドレスを確認してください。表示されるのは Microsoft でサインインしたアカウントのアドレスで、入力したメールアドレスと同じとは限りません。ブラウザーですでに Microsoft にサインインしている場合、たとえばアプリを設定した管理者としてサインインしている場合は、パスワードの入力を求められずに、そのアカウントで続行されます。そのため、テストにはプライベートウィンドウを使う必要があります。

テストは Entra のテストボタンではなく、Lingo.dev から開始してください。サインオン URL を設定するまでは、Microsoft マイアプリの Lingo.dev タイルからサインインすることはできません。サインアウトした状態で Lingo.dev のホームページが開きます。

テナントでセキュリティの既定値を使用している場合、Microsoft は各ユーザーに初回サインイン時の認証アプリ登録を求めます。登録に Lingo.dev の待機時間(約5分)を超える時間がかかると、初回のサインインは「シングルサインオンの完了に時間がかかりすぎました。もう一度お試しください。」と表示されて失敗します。もう一度試すとサインインできます。

テストが成功したら、SSO を必須にすることができます。まず、有効にするの説明に従って、自分の SSO アカウントをオーナーにしてください。

Microsoft マイアプリからサインインする #

マイアプリの Lingo.dev タイルからサインインできるように、サインオン URL を設定します。

  1. Lingo.dev で 設定 → SSO を開き、ダッシュボードのサインインリンクをコピーします。リンクは https://lingo.dev/auth/sso?domain=example.com のような形式です。
  2. Entra で Lingo.dev アプリケーションを開き、シングルサインオンを選択します。
  3. 基本的な SAML 構成で、編集を選択します。
  4. リンクをサインオン URL に貼り付け、保存を選択します。

今は、マイアプリの Lingo.dev タイルからこのリンクが開くようになっています。Lingo.dev はメールアドレスの入力を求めずにユーザーを Microsoft に移動させ、サインインした状態で Lingo.dev に戻します。

SCIM でメンバーをプロビジョニングする #

Entra では、SCIM 経由で Lingo.dev のメンバーを管理し、グループを通じてロールを設定できます。まず、このガイドに従って SSO を設定してください。Lingo.dev の SCIM の仕組みについては、SCIM でメンバーをプロビジョニングするをご覧ください。

  1. Lingo.dev で、SCIM キーを生成します。
  2. Entra で Lingo.dev のエンタープライズアプリケーションを開き、プロビジョニングを選択します。
  3. プロビジョニングモードを自動に設定します。
  4. 管理者資格情報で、Lingo.dev の SCIM ベース URL(https://api.lingo.dev/v2/scim)をテナント URL に貼り付けます。SCIM キーをシークレットトークンに貼り付けます。
  5. 接続のテストを選択してから、保存を選択します。
  6. 属性マッピングは既定のままにします。Lingo.dev は userPrincipalName から userName を、mail から勤務先のメールアドレスを取得します。
  7. 設定で、スコープを割り当てられたユーザーとグループのみを同期するに設定します。
  8. プロビジョニングの開始を選択します。

招待はユーザーの mail アドレスに送信されるため、割り当てるすべてのユーザーに接続済みドメインのアドレスが必要です。userPrincipalName と mail は異なっていても問題ありません。

割り当てたユーザーごとに、Lingo.dev で保留中の招待が作成されます。各ユーザーは、初めて SSO でサインインしたときにメンバーになります。

Entra は約40分ごとにプロビジョニングを実行するため、変更や削除は次のサイクルで Lingo.dev に反映されます。1人のユーザーを今すぐ反映するには、オンデマンドでプロビジョニングするを使用してください。

ユーザーの割り当てを解除すると、Entra は削除ではなく無効化の通知を送信し、Lingo.dev はそのユーザーを組織のメンバーから外します。ユーザーを削除するをご覧ください。

Entra グループでロールを設定する #

  1. Entra グループの名前が、Translator などの Lingo.dev のロール名と一致していることを確認します。
  2. ユーザーとグループで、そのグループをアプリケーションに割り当てます。

Entra はグループを同名のロールに対応付け、グループのメンバーをプロビジョニングして、そのロールを付与します。グループから削除したユーザーは、そのロールを失います。そのグループがユーザーの唯一の割り当てだった場合は、グループから削除すると Lingo.dev のメンバーからも外れます。

トラブルシューティング #

問題対処方法
Microsoft に AADSTS700016:「識別子 '…' を持つアプリケーションがディレクトリに見つかりませんでした」と表示される。識別子(エンティティ ID) が https://auth.lingo.dev/auth/v1/sso/saml/metadata と完全に一致していません。基本的な SAML 構成で修正してください。
Microsoft に AADSTS50011:「応答 URL がアプリケーションに構成されている応答 URL と一致しません」と表示される。応答 URL(アサーションコンシューマーサービス URL) を https://auth.lingo.dev/auth/v1/sso/saml/acs と完全に一致するように設定してください。
Microsoft に AADSTS50105 が表示され、ユーザーがアプリケーションに割り当てられていないと示される。ユーザーとグループで、ユーザー本人またはそのユーザーが所属するグループを割り当ててください。
割り当てられていないユーザーがサインインできた、または入力したものとは異なるメールアドレスが Lingo.dev に表示される。割り当てが必要ですか?がいいえになっているか、ブラウザーですでに別のアカウントで Microsoft にサインインしていたことが原因です。プロパティで割り当てが必要ですか?をはいに設定し、プライベートウィンドウでテストしてください。
メールアドレスが、組織でシングルサインオンに使用しているドメインのものではないと Lingo.dev に表示される。接続済みドメイン以外のアカウントで Microsoft にサインインしています。多くの場合、ゲストアカウントや、テナントを作成した管理者のアカウントです。勤務先のアカウントでサインインするか、設定 → SSO でそのドメインを追加してください。
Lingo.dev に「認証プロバイダーからメールアドレスが送信されませんでした」と表示される。アプリがメールクレームを送信していないか、Entra でユーザーにメールアドレスが設定されていません。属性とクレームでメールクレーム(user.mail)を追加し、ユーザーのメールアドレスを設定してください。
Lingo.dev に「シングルサインオンの完了に時間がかかりすぎました。もう一度お試しください。」と表示される。Microsoft へのサインインに約5分を超える時間がかかりました。認証アプリの登録中によく発生します。Lingo.dev からもう一度お試しください。次の試行ではサインインできます。
Lingo.dev に「サインインしましたが、組織に追加できませんでした。」と表示される。SSO でもう一度サインインしてください。失敗が続く場合は、オーナーに 設定 → SSO で接続開始日時が表示されているか確認してもらってください。
Lingo.dev に「シングルサインオンが完了しませんでした」と表示される。識別子(エンティティ ID) と応答 URL を Lingo.dev の値と照合し、もう一度お試しください。
接続のテストまたはプロビジョニングが 401 Unauthorized で失敗する。SCIM キーが更新されたか、失効しています。現在のキーをシークレットトークンに貼り付けるか、Lingo.dev で新しいキーを生成してください。
割り当てたユーザーが 設定 → チームの招待タブに表示されない。次のプロビジョニングサイクルを待つか、オンデマンドでプロビジョニングするを使用してください。ユーザーの mail が接続済みドメインのアドレスであることを確認してください。

その他のメッセージについては、トラブルシューティングをご覧ください。