Microsoftでのシングルサインオン
残高が必要 HTTPトンネル
このページの内容 6セクション
訪問者が、HTTPトンネルを開く前に、Microsoft Entra IDの職場または学校アカウント、あるいは個人のMicrosoftアカウントでログインするようにします。Microsoft Entraでアプリケーションを登録し、Localtonetにプロバイダーとして追加してから、トンネルでオンにします。
始める前に #
- HTTPトンネルと、アカウントの残高。シングルサインオンの概要をご覧ください。
- アプリケーションを登録できるロールで、Microsoft Entra admin centerにアクセスできること。Microsoftは、最低限のロールとしてApplication Developerを挙げています。
- 誰がログインできるかの決定:自分の組織だけか、任意の組織か、個人アカウントも含めるか。これによって、Localtonetに入力する2つのアドレスが決まります。アカウントの種類とエンドポイントをご覧ください。
手順 #
-
Microsoft Entraでアプリケーションを登録する #
Microsoftの公式ガイドは、Register an app in Microsoft Entra ID、Add a redirect URI、Add app credentialsです。要点は次のとおりです。
- Microsoft Entra admin centerで、Entra ID › App registrationsに移動し、New registrationを選択します。
- Nameを入力します。訪問者がログインするときに表示されます。
- Supported account typesで、アプリケーションを使用できるユーザーを選び、Registerを選択します。
- Overviewページで、Application (client) IDをコピーします。シングルテナントのアプリケーションでは、Directory (tenant) IDもコピーします。
- Manageの下でAuthenticationを開き、Add Redirect URIを選択して、Webプラットフォームを選び、下のリダイレクトURIを入力してConfigureを選択します。
- Certificates & secrets › Client secretsを開き、New client secretを選択します。説明を追加し、有効期限を選んでAddを選択します。シークレットのValueはすぐにコピーしてください。ページを離れると、Microsoftは二度と表示しません。
リダイレクトURI(プラットフォーム:Web)http://auth.localtonet.com/auth/callbackクライアントシークレットには有効期限があります。Microsoftは、その有効期間を24か月までに制限しています。期限が切れると、新しいシークレットを作成してLocaltonetのプロバイダーに保存するまで、ログインできなくなります。
-
Localtonetにプロバイダーを追加する #
マイトンネル › HTTPを開き、ページ上部のSSOを選択します。SSOプロバイダーダイアログで、プロバイダーを追加を選択します。
項目 値 プロバイダー名 任意の名前(例: Company Microsoft)。トンネル設定に表示されます。プロバイダーの種類 Microsoft。保存済みのプロバイダーの種類を変更するとクライアントIDが空になるため、クライアントIDとクライアントシークレットを再入力してください。 有効 オン クライアントID Microsoft EntraのApplication (client) IDです。 クライアントシークレット シークレットのValueです(Secret IDではありません)。保存後は表示されません。 エンドポイントとコールバックを開きます。次の値は自動で入力されています。
項目 入力済みの値 変更が必要か 認可エンドポイント https://login.microsoftonline.com/common/oauth2/v2.0/authorize次のセクションの表に従って、 commonを置き換えます。トークンエンドポイント https://login.microsoftonline.com/common/oauth2/v2.0/tokencommonを、上と同じ値に置き換えます。ユーザー情報エンドポイント https://graph.microsoft.com/oidc/userinfo不要です。テナントを含みません。 コールバックパス /auth/callback/microsoft不要です。 必要に応じてメールアクセスルールを入力し、プロバイダーを保存を選択します。
-
トンネルでオンにする #
あなたのトンネルで、トンネルの設定を選択し、SSOプロバイダーの横の管理を選択します。シングルサインオンダイアログで、ログインを必須にすると、Microsoftプロバイダーのスイッチをオンにします。保存を選択します。
ログインできるユーザーの一覧とログインパスは任意です。これらについては、概要で説明しています。
-
動作を確認する #
プライベートブラウザーウィンドウでトンネルのURLを開きます。LocaltonetにSign in to continueが表示され、プロバイダー用のボタンが表示されます。Microsoftでログインすると、トンネルに戻り、サービスが読み込まれます。
アカウントの種類とエンドポイント #
Microsoftのアドレスのうちlogin.microsoftonline.com/に続く部分が、ログインできるユーザーを決めます。この部分は、アプリケーションのSupported account typesに合っている必要があります。認可エンドポイントとトークンエンドポイントには、常に同じ値を指定します。ユーザー情報エンドポイントは変わりません。
| Microsoft EntraのSupported account types | commonの代わりに使用する値 | ログインできるユーザー |
|---|---|---|
| Single tenant only | ご自身のDirectory (tenant) ID | 自分のテナントのユーザーとゲスト。 |
| Multiple Entra ID tenants | organizations | 任意の組織の職場または学校アカウント。 |
| Any Entra ID Tenant + Personal Microsoft accounts | commonのまま | 職場または学校アカウントと、個人のMicrosoftアカウント。 |
| Personal accounts only | consumers | 個人のMicrosoftアカウント。 |
シングルテナントのアプリケーションの例です。<TENANT_ID>を、ご自身のDirectory (tenant) IDに置き換えてください。
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoシングルテナントのアプリケーションは、commonでは動作しません。Microsoftはエラー AADSTS50194を返します。両方のエンドポイントにテナントIDを入力するか、アプリケーションをマルチテナントのアカウントの種類に変更してください。
マルチテナントまたは個人アカウントの種類では、組織外の人もMicrosoftでログインできます。許可したい人だけを通すには、プロバイダーの許可するメールドメイン、またはトンネルのログインできるユーザーを使用します。
LocaltonetがMicrosoftから読み取る情報 #
Microsoftのユーザー情報エンドポイントは、アカウントにメールアドレスが関連付けられている場合にのみメールアドレスを返します。そのため、メールアドレスのないアカウントは、メールに基づくルールを通過できない場合があります。
トラブルシューティング #
AADSTS50011:返信URLが一致しません
リクエストのリダイレクトURIが、アプリケーションに登録されていません。メッセージには、送信されたアドレスが表示されます。このアドレスは、アプリの登録のAuthenticationページでWebプラットフォームに登録したリダイレクトURIと、大文字と小文字も含めて完全に一致している必要があります。http://auth.localtonet.com/auth/callbackをそのまま登録してください。
AADSTS50194:アプリケーションがマルチテナントアプリケーションとして構成されていません
アプリケーションはシングルテナントですが、エンドポイントにcommonが残っています。認可エンドポイントとトークンエンドポイントのcommonをDirectory (tenant) IDに置き換え、プロバイダーを保存を選択します。
AADSTS700016:ディレクトリにアプリケーションが見つかりません
クライアントIDが誤っているか、エンドポイントが、アプリケーションが存在しないテナントを指しています。Application (client) IDと、エンドポイント内のテナントIDを確認してください。
AADSTS7000215またはAADSTS7000222:クライアントシークレットが無効、または期限切れです
Certificates & secretsで新しいクライアントシークレットを作成し、そのValueをLocaltonetのクライアントシークレットに貼り付けて、プロバイダーを保存を選択します。
Microsoftが管理者の承認を求める
テナントでは、ユーザー自身がアプリケーションに同意することが許可されていません。テナントの管理者が、Microsoft Entra admin centerでアプリケーションへの同意を付与する必要があります。
Microsoftでのログインに成功した後に「403 - Access Denied」が表示される
Localtonetのルールがアカウントを拒否しました。プロバイダーのメールアクセスルールと、トンネルのログインできるユーザーを確認し、アカウントにそもそもメールアドレスがあるかどうかも確認してください。ルールを修正したら、1分待ってから再読み込みしてください。