> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-ja/shisuru/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Microsoft Entra ID（旧 Azure AD）を ID プロバイダーとして使用し、ユーザーが OAuth（OIDC）または SAML 経由で Microsoft の認証情報を使って Dispel にサインインするようにします。

## 概要

Microsoft Entra ID — 旧称 Azure AD の Microsoft のクラウド ID プラットフォーム — を、組織の ID プロバイダーとして接続します。接続すると、ユーザーはシングル サインオンを通じて Microsoft の資格情報で Dispel にサインインします。Entra は次のプロトコルで接続できます **OAuth（OIDC）** または **SAML**.

このページでは Entra 固有の設定を扱います。すべてのプロバイダーに共通する動作 — ユーザーのサインイン方法、グループ マッピング、MFA、切断 — については、 [ID プロバイダー](/documentation/documentation-ja/shisuru/identity-providers.md).

{% hint style="info" %}
**どこにあるか。** 組織管理者としてサインインし、 **設定 → 統合** （または専用の **設定 → 認証** ページ）。Microsoft Entra ID は **Identity & Authentication（IdP / SSO）** セクションに表示されます。 **接続** そのカードをクリックして開始します。
{% endhint %}

## 始める前に

* IdP 側を次の場所で構成します： **Microsoft Entra 管理センター** （または Azure portal）で設定するため、そこへの管理者アクセスが必要です。
* プロトコルを決定します — **OAuth（OIDC）** または **SAML**。詳細は [プロトコルの選択](/documentation/documentation-ja/shisuru/identity-providers.md#choosing-a-protocol).
* Entra 経由でサインインするユーザーがすでに **組織に招待されていることを確認してください** Dispel で。SSO はユーザーを認証しますが、それだけではアクセスは作成されません。

{% hint style="warning" %}
**一度に接続できるプロバイダーは 1 つです。** 組織がすでに別の ID プロバイダーに接続されている場合は、Entra を接続する前に切断してください。
{% endhint %}

## OAuth（OIDC）で接続

#### Microsoft Entra ID で

1. Microsoft Entra 管理センターで、次へ移動します： **アプリ登録 → 新規登録** を選択し、Dispel 用のアプリを作成します。
2. 次を追加します： **Web** Dispel アドレスに続けて次を指定したリダイレクト URI： `/oauth/login-callback` — たとえば `https://app.dispel.com/oauth/login-callback`。不明な場合は、環境の正確なアドレスを Dispel 担当者に確認してください。
3. 次の項目の下で **証明書とシークレット**、を作成します。 **クライアント シークレット** を作成し、その値をコピーします。
4. 次を控えてください： **アプリケーション（クライアント）ID** およびテナントの OAuth/OIDC エンドポイント。

#### Dispel で

1. 「 **接続** Microsoft Entra ID カードで **認証プロトコルを選択 → OAuth**.
2. 次のフィールドに入力します：

| 項目                | Entra からの値                                  |
| ----------------- | ------------------------------------------- |
| **クライアント URL**    | テナントの OAuth/OIDC エンドポイント（トークンが発行される場所）。     |
| **クライアント ID**     | 次の項目： **アプリケーション（クライアント）ID** アプリ登録から取得したもの。 |
| **クライアント シークレット** | 作成したクライアント シークレットの値。                        |
| **組織識別子**         | ユーザーが選択する一意の識別子。ユーザーはサインイン画面でこれを入力します。      |

3. 「 **設定を保存**.

## SAML で接続

#### Microsoft Entra ID で

1. Microsoft Entra 管理センターで、次へ移動します： **エンタープライズ アプリケーション → 新しいアプリケーション → 独自のアプリケーションを作成する**、次に開きます **シングル サインオン → SAML**.
2. 次の項目で **基本的な SAML 構成**、Dispel の SAML フォーム上部に表示される値を貼り付けます：
   * **識別子（Entity ID）** ← Dispel の **Service Provider（SP）Entity ID**.
   * **応答 URL（Assertion Consumer Service URL）** ← Dispel の **Assertion Consumer Service URL**.
3. Entra の SAML 設定から次を取得します：
   * **ログイン URL** → Dispel の **SSO URL**.
   * **Microsoft Entra 識別子** → Dispel の **Identity Provider Entity ID**.
   * 次をダウンロードします： **証明書（Base64）** → Dispel の **Base64 署名証明書**.

#### Dispel で

1. 「 **接続** Microsoft Entra ID カードで **認証プロトコルを選択 → SAML**.
2. 次をコピーします： **Service Provider（SP）Entity ID** と **Assertion Consumer Service URL** フォーム上部に表示されているもの（ **ID をコピー** / **URL をコピー**を使用し）を Entra に、上記のとおり入力します。
3. 次のフィールドに入力します：

| 項目                              | Entra からの値                                  |
| ------------------------------- | ------------------------------------------- |
| **SSO URL**                     | Entra の **ログイン URL**.                       |
| **Identity Provider Entity ID** | 次の項目： **Microsoft Entra 識別子**.              |
| **Base64 署名証明書**                | ダウンロードした Base64 証明書。貼り付けるか、 **証明書をアップロード**. |
| **組織識別子**                       | ユーザーが選択する一意の識別子。ユーザーはサインイン画面でこれを入力します。      |

4. 「 **設定を保存**.
5. 「 **接続をテスト**。Dispel はサインインのために Entra にリダイレクトし、受信したメール アドレスと名前を表示します。テストが失敗する場合は、値が Entra のアプリと一致していること、およびテスト ユーザーが組織に招待されていることを確認してください。

## 接続後

* **ユーザーはサインインします** Dispel のサインイン画面で組織識別子を入力し、Microsoft で認証します。詳細は [ユーザーのサインイン方法](/documentation/documentation-ja/shisuru/identity-providers.md#how-users-sign-in).
* **Entra のグループを Dispel のグループにマップする** ことでメンバーシップを同期状態に保ちます — 詳細は [OIDC グループ マッピング](/documentation/documentation-ja/shisuru-2/integrations/oidc-group-mapping.md).
* **MFA** Entra で適用されるものはサインイン時に適用されます。Dispel のメールによるワンタイム コードは SSO ユーザーには適用されません。詳細は [SSO と多要素認証](/documentation/documentation-ja/shisuru/identity-providers.md#sso-and-multi-factor-authentication).
* **プロトコルまたはプロバイダーを切り替えるには**、まず切断してください。詳細は [プロバイダーの切り替えまたは切断](/documentation/documentation-ja/shisuru/identity-providers.md#switching-or-disconnecting-a-provider).

## よくある質問

<details>

<summary>これは「Azure AD」と同じですか？</summary>

はい。Microsoft は Azure Active Directory を Microsoft Entra ID に名称変更しました。Entra コンソールの一部にまだ「Azure AD」ラベルが表示されていても、設定は同じです。

</details>

<details>

<summary>Entra ではどのプロトコルを使うべきですか？</summary>

どちらでも動作します。Entra のアプリ構成に合う方を使用してください — OAuth なら OIDC のアプリ登録、SAML なら SAML シングル サインオンを備えたエンタープライズ アプリケーションです。

</details>

<details>

<summary>SAML のテスト接続に失敗しました。何を確認すればよいですか？</summary>

SSO URL、Entity ID、証明書が Entra の SAML アプリと完全に一致していること、Dispel の SP Entity ID と ACS URL を Entra の基本的な SAML 構成に貼り付けたこと、そしてテスト ユーザーが Entra に存在し、Dispel 組織に招待されていることを確認してください。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-ja/shisuru/identity-providers/microsoft-entra-id.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.