> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Auth0 で利用できる Microsoft Azure AD の接続タイプを比較し、テナントモデルとユーザー属性に合うものを選択します。

# Azure AD の接続タイプを選択する

Auth0 インスタンスは、3 つの方法で Microsoft Azure Active Directory に接続できます。ご利用の状況に最適な方法を判断するために、各オプションを確認してください。

Auth0 では、まずネイティブの Microsoft Azure AD 接続から始めることを推奨しています。さらにカスタマイズが必要な場合は、<Tooltip tip="Security Assertion Markup Language (SAML): パスワードなしで 2 者間が認証情報をやり取りできる標準化されたプロトコル。" cta="用語集を表示" href="/docs/ja-jp/glossary?term=SAML">SAML</Tooltip> 接続の設定を確認してください。また、組織で <Tooltip tip="OAuth 2.0: 認可プロトコルとワークフローを定義する認可フレームワーク。" cta="用語集を表示" href="/docs/ja-jp/glossary?term=OAuth">OAuth</Tooltip> のコードフローに追加の制限がある場合は、Enterprise OIDC の設定を確認してください。

以下の表は、これらの接続タイプの主な違いを示しています。ご自身の組織に最適な接続タイプを判断するために、これらの機能を確認してください。

| 接続タイプ                                         | 「ネイティブ」Azure AD | Enterprise OIDC                     | SAML         |
| --------------------------------------------- | --------------- | ----------------------------------- | ------------ |
| **プロトコル**                                     | OAuth 認可コードフロー  | OAuth インプリシットフロー または OAuth 認可コードフロー | SAML         |
| **Azure AD からオプションのクレームを受け取れますか？**            | いいえ             | はい                                  | はい           |
| **フェデレーテッドログアウトのサポート (「シングルログアウト」または SLO) **  | はい              | いいえ                                 | はい           |
| **AD グループを受け取れるか**                            | はい、表示名          | はい、オブジェクト ID                        | はい、オブジェクト ID |
| **拡張プロファイルを受け取れるか**                           | はい              | いいえ                                 | いいえ          |

<div id="microsoft-azure-ad">
  ## Microsoft Azure AD
</div>

最初の接続タイプは、[Auth0 Dashboard > Authentication > Enterprise](https://manage.auth0.com/dashboard/#/connections/enterprise) にある **Microsoft Azure AD** 接続です。

この接続タイプでは、OAuth 認可コードフローを使用します。Microsoft Azure AD 接続は `id_token` からクレームを受け取り、Microsoft Graph API を直接クエリします。設定されている場合、このクエリではグループと追加のプロファイル情報を検索します。Microsoft Azure AD は、`id_token` に含まれるカスタムクレームをすべて無視します。

<div id="connection-features-and-considerations">
  ### 接続の機能と考慮事項
</div>

この接続タイプは標準のワークフローであるため、拡張 AD 機能との互換性が明示されています。Azure AD 接続では、Microsoft Graph API のプロファイル属性が Auth0 のユーザープロファイルに直接マッピングされます。

以下の表は、接続タイプごとの Azure AD Graph 属性を比較したものです。

| Graph 属性            | Auth0 プロファイル属性       | データ型   | OIDC または SAML における対応するオプションのクレーム |
| ------------------- | -------------------- | ------ | -------------------------------- |
| `businessPhones`    | `phone`              | array  | N/A                              |
| `givenName`         | `given_name`         | string | `given_name`                     |
| `jobTitle`          | `job_title`          | string | N/A                              |
| `mobilePhone`       | `mobile`             | string | N/A                              |
| `preferredLanguage` | `preferred_language` | string | `xms_pl`                         |
| `surname`           | `family_name`        | string | `family_name`                    |
| `userPrincipalName` | `upn`                | string | `upn`                            |

次の拡張プロファイル属性を受け取るには、[Microsoft Graph API にクエリする権限を有効にする](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/azure-active-directory/v2#add-permissions)必要があります。

* `businessPhones`
* `jobTitle`
* `mobilePhone`

<div id="group-configuration">
  ### グループ設定
</div>

[Microsoft Graph API をクエリする権限を有効にすると](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/azure-active-directory/v2#add-permissions)、Auth0 はユーザーのグループを自動的に取得し、それらを Auth0 の `groups` 属性にマッピングします。Auth0 はこれらのグループの「表示名」をマッピングするため、Microsoft Graph API から直接マッピングされるこれらのグループについては、カスタム claim を設定する必要はありません。

<div id="saml">
  ## SAML
</div>

SAML 接続タイプでは SAML プロトコルを使用し、属性マッピングと標準的な SAML 機能をすべてサポートしています。

<div id="connection-features-and-considerations">
  ### 接続の機能と考慮事項
</div>

SAML 接続タイプは、オプションのクレームと[フェデレーテッドログアウト](https://docs.microsoft.com/en-us/azure/active-directory/develop/single-sign-out-saml-protocol)をサポートしているため、利用可能な接続タイプの中で最も柔軟です。これら両方の機能が必要な場合、SAML はその両方を同時にサポートできる唯一の接続タイプです。

<div id="group-configuration">
  ### グループ設定
</div>

Auth0 が SAML 接続タイプでグループ情報を受け取れるようにするには、SAML レスポンスにオプション属性が含まれるよう Azure AD を構成する必要があります。すると、Auth0 はそのグループをユーザーの Auth0 プロファイル内の `group_ids` 属性にマッピングします。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  SAML 接続タイプと OIDC 接続タイプでは、グループ名には表示名ではなく、オブジェクト識別子が使用されます。オンプレミスの AD からグループをインポートしている場合は、表示名を SAML レスポンスに含められることがあります。グループ クレームの詳細については、[Microsoft のドキュメント](https://docs.microsoft.com/en-us/azure/active-directory/hybrid/how-to-connect-fed-group-claims)を参照してください。
</Callout>

<div id="enterprise-oidc">
  ## Enterprise OIDC
</div>

Enterprise Open ID Connect タイプでは、OAuth Implicit または認可コードワークフローを使用できます。この接続では、`id_token` 内のカスタムクレームが Auth0 のユーザープロファイルにマッピングされます。認証フローの詳細については、[認証と認可のフローに関するドキュメント](/docs/ja-jp/get-started/authentication-and-authorization-flow)を参照してください。

<div id="connection-features-and-considerations">
  ### 接続の機能と考慮事項
</div>

規制やプライバシーに関する取り決めにより、ログインフローで<Tooltip tip="Client Secret: クライアント（アプリケーション）が認可サーバーに対して認証を行うために使用するSecret。クライアントと認可サーバーだけが知るべきものであり、推測されないよう十分なランダム性が必要です。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=client+secrets">クライアントシークレット</Tooltip>を提供できない場合は、OIDC 接続が提供する Implicit Flow が適した方法となることがあります。カスタムクレームが必要でも、追加の SAML 機能を設定したくない場合は、OIDC 接続によって複雑さを軽減できます。

<div id="group-configuration">
  ### グループ設定
</div>

Auth0 が OIDC 接続タイプでグループ情報を受け取れるようにするには、リクエストの `id_token` に `groups` を追加するオプションのクレームを Azure AD で設定する必要があります。Auth0 はその後、これらのグループをユーザーの Auth0 プロファイル内の `group_ids` 属性にマッピングします。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  SAML と OIDC の接続タイプでは、グループの表示名ではなくオブジェクト識別子が使用されます。オンプレミスの AD からグループをインポートしている場合は、SAML レスポンスに表示名を含められることがあります。グループ クレームの詳細については、[Microsoft のドキュメント](https://docs.microsoft.com/en-us/azure/active-directory/hybrid/how-to-connect-fed-group-claims)を参照してください。
</Callout>

<div id="learn-more">
  ## 詳細はこちら
</div>

* [アプリを Microsoft Azure Active Directory に接続する](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/azure-active-directory/v2)