# Azure AD の設定

{% hint style="warning" %}
このガイドでは、ドキュメント用の保護されたサインイン画面の設定方法を説明します。このガイドを進める前に、まず最初に次のプロセスを実施していることを確認してください： [認証されたアクセスを有効化する](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/authenticated-access/enabling-authenticated-access).
{% endhint %}

{% hint style="info" %}
Azure 統合には既知の制限があり、認証時に見出しの URL フラグメントが削除されます。ユーザーは正しいページに移動しますが、URL の見出しではなくページの先頭に移動されます。ユーザーが認証されると、この動作はセッション中に発生しなくなり、ユーザーは正しい見出しに案内されます。

これは Microsoft によって実施されたセキュリティ対策によるものです。
{% endhint %}

### 概要

Azure AD を使用して認証付きアクセスで GitBook サイトを設定する手順は次のとおりです：

{% stepper %}
{% step %}
[**Azure AD でアプリ登録を作成する**](#id-1.-create-an-app-registration-in-azure-a-d)

Microsoft Entra ID 管理ダッシュボードで Azure AD のアプリ登録を作成します。
{% endstep %}

{% step %}
[**サイトに Azure AD 統合をインストールして設定する**](#id-2.-install-and-configure-the-azure-a-d-integration)

Azure AD 統合をインストールし、必要な構成を GitBook サイトに追加します。
{% endstep %}

{% step %}
[**アダプティブコンテンツ用に Azure AD を構成する（オプション）**](#id-3.-configure-azure-a-d-for-adaptive-content-optional)

GitBook のアダプティブコンテンツと連携するように Azure AD を構成します。
{% endstep %}
{% endstepper %}

### 1. Azure AD でアプリ登録を作成する

まず Microsoft Entra ID ダッシュボードでアプリ登録を作成します。このアプリ登録により、GitBook の Azure AD 統合がトークンを要求してユーザーの身元を検証し、サイトへのアクセスを許可できます。

1. Microsoft Entra ID 管理にサインインする [ダッシュボード](https://entra.microsoft.com/).
2. へ移動してください **ID** > **アプリケーション** > **アプリの登録** 左のサイドバーから。
3. クリックしてください **+ 新規登録、** そして登録に名前を付けます。
4. の下に **サポートされているアカウントの種類、** 「**この組織のディレクトリ内のアカウントのみ（既定のディレクトリのみ - 単一テナント）」**.
5. リダイレクト URI フィールドは今は空のままにしてください—後でこの欄を入力する必要があります。
6. クリック **登録** をクリックしてアプリ登録を完了します。<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FuB6p6HxRmveHp1cfsiKa%2Fazure_ad_integration_register_app.png?alt=media&#x26;token=cbc82bc5-189e-433a-b990-042066768307" alt="An Azure screenshot showing how to register an Azure AD app"><figcaption><p>GitBook VA 統合用のアプリを登録します。</p></figcaption></figure>
7. すると新しいアプリ登録の **概要** 画面が表示されるはずです。次の項目をコピーして控えてください： **アプリケーション（クライアント）ID** および **ディレクトリ（テナント）ID**.<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FETQziXVuqGnho8GGOVBZ%2Fazure_ad_integration_app_reg_overview.png?alt=media&#x26;token=266a55e3-db75-4a4a-923c-8302f69653d5" alt="An Azure screenshot showing the app registration overview"><figcaption><p>新しく作成したアプリ登録の概要。</p></figcaption></figure>
8. クリックしてください **証明書またはシークレットを追加する**。次の **証明書とシークレット** 画面が表示されます：<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FnXJbnpnGhOI6Udjrx8bS%2Fazure_ad_integration_client_secrets.png?alt=media&#x26;token=9202689b-4657-4bea-bf74-42b51e1051e5" alt="An Azure screenshot showing where to add a certificate or secret"><figcaption><p>証明書またはシークレットを追加します。</p></figcaption></figure>
9. クリックしてください **+ 新しいクライアント シークレット**.
10. シークレットの適切な説明を入力し、 **追加**.
11. をクリックします。 **先ほど作成したシークレットの** &#x5024;***しては** フィールド（*&#x30B7;ークレット ID

### ）をコピーして控えてください。

2\. Azure AD 統合をインストールして構成する

1. Azure AD のアプリ登録を作成したら、次のステップは GitBook に Azure AD 統合をインストールし、先ほど生成した資格情報で Azure アプリとリンクすることです： [認証付きアクセスを有効にしたサイトに移動し、](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/enabling-authenticated-access#enable-authenticated-access) Azure AD を ID プロバイダーとして使用したいサイトに移動します。
2. クリックしてください **統合** サイト設定の右上にあるボタンをクリックします。<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FgBMsbydNsuqx7eqcz0JN%2Fva_site_integration_overview_screen.png?alt=media&#x26;token=ead70cf3-93cf-4aef-b77a-321afad38900" alt="A GitBook screenshot showing the site settings overview"><figcaption></figcaption></figure>
3. クリックしてください **認証されたアクセス** サイドバーのカテゴリから。
4. を選択します **Azure** 統合。
5. クリック **このサイトにインストール**.<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FCiveWUn0FWMEdS3YRU62%2FScreenshot%202025-03-24%20at%2018.10.09.png?alt=media&#x26;token=fcaedce7-40f5-40e5-acd1-040e90822be4" alt="A GitBook screenshot showing installation of the Azure AD integration"><figcaption></figcaption></figure>
6. 統合をサイトにインストールした後、統合の構成画面が表示されます：<br>

   <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FvO9pXBCZkcprDDIVFkcf%2FScreenshot%202025-03-24%20at%2018.17.02.png?alt=media&#x26;token=e082d3dd-1e6b-44b4-beaf-a5d67812e055" alt="A GitBook screenshot showing the Azure AD configuration dialog"><figcaption></figcaption></figure>
7. 次の項目を入力します **クライアント ID**, **テナント ID**、および **クライアント シークレット** 先ほど Azure AD アプリ登録を [作成した後にコピーした](#id-1.-create-an-app-registration-in-azure-a-d) 値を入力し、「保存」をクリックします。
8. ダイアログの下部に表示される **URL** をコピーしてください **ダイアログの下部に表示されています**.
9. 先ほど Microsoft Entra ID ダッシュボードで作成した Azure AD のアプリ登録に戻ります。
10. 次へ移動してください **管理** > **認証** サイドバーで。
11. クリック **+ プラットフォームを追加** をクリックし、 **Web** カードを開いたパネルで選択します。<br>

    <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FUssw9BNY66urLYH376sE%2FScreenshot%202025-03-24%20at%2018.28.58.png?alt=media&#x26;token=2c2b2b84-b7e9-4fc3-a7bd-2751dacfd579" alt="An Azure screenshot showing authentication platform settings"><figcaption></figcaption></figure>
12. 先ほどコピーした GitBook 統合の **URL** を貼り付けます **リダイレクト URI** フィールドに入力し、「構成」をクリックします<br>

    <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fi9fVjsa351I6kVzJw64X%2Fimage.png?alt=media&#x26;token=85d1d25a-bdb8-4453-b30e-54a21304f870" alt="An Azure screenshot showing where to enter the redirect URI"><figcaption></figcaption></figure>
13. GitBook の **Azure 統合** インストール画面に戻ります **。**.
14. 統合ダイアログを閉じ、サイト画面の **設定** タブをクリックします。
15. 次へ移動してください **オーディエンス** をクリックし、 **認証付きアクセス** （まだ選択されていない場合）。
16. を開きます **Azure** ドロップダウンの **認証バックエンド** セクションから選択します。
17. クリック **オーディエンスを更新**.<br>

    <figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Finc5DrItbyXUIXP4K4ic%2FScreenshot%202025-03-24%20at%2018.41.45.png?alt=media&#x26;token=e06283f6-f7d6-4556-9ef7-747b47493064" alt="A GitBook screenshot showing authenticated access settings"><figcaption></figcaption></figure>
18. サイトの概要画面に移動し、サイトがまだ公開されていない場合は **公開** をクリックしてください。

これでサイトは Azure AD を ID プロバイダーとして使用した認証付きアクセスの背後で公開されます。

動作をテストするには、\[訪問] をクリックしてください。Azure でサインインするよう求められ、これによりサイトが Azure を使用した認証付きアクセスの背後で公開されていることが確認されます。

{% hint style="info" %}
公開されたコンテンツの URL にアクセスし、Azure の資格情報でログインすると、管理者から「承認を要求する（Request approval）」必要があることを示す画面が表示される場合があります。管理者は公開コンテンツの URL にアクセスしてログインし、組織を代表して承認を付与することでこの要求を承認できます。
{% endhint %}

### 3. アダプティブコンテンツ用に Azure AD を構成する（オプション）

認証付きアクセスサイトでアダプティブコンテンツ機能を活用するには、Azure AD アプリ登録を構成して、認証トークンに追加のユーザー情報をクレームとして含めるようにします。

これらのクレームはキーと値のペアとして表され、GitBook に渡されて次のように使用できます： [コンテンツを適応させる](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/adaptive-content/adapting-your-content) ために動的に使用されます。

Azure AD は、異なる種類とレベルのクレームをサポートしており、それぞれ設定方法が異なります：

* **標準クレーム**： トークンに含まれる可能性のある一般的なクレームで、デフォルトでは常に存在するとは限りません。

{% hint style="info" %}
Azure AD はパフォーマンスのためにトークンサイズを最適化します。そのため、多くのクレームは **しては** デフォルトではトークンに含まれておらず、アプリケーションによって明示的に要求される必要があります。以下のようなクレームを含めるには、 `email（メール）` , `groups（グループ）` または `役割` が含まれるように、これらを明示的に **オプショナルクレーム**.
{% endhint %}

* **として要求する必要があります。**&#x30AA;プショナルクレーム
* **： アプリケーション向けに有効化できる追加の事前定義されたクレーム。**&#x30AB;スタムクレーム

： Azure AD のカスタムユーザー属性やカスタムクレームプロバイダー経由の外部システムから取得されるクレーム。

* [Azure AD アプリが生成するトークンにこれらのさまざまなタイプのクレームを含める方法の詳細については、次の Microsoft Entra ドキュメント ガイドを参照してください：](https://learn.microsoft.com/en-us/entra/external-id/customers/how-to-add-attributes-to-token)
* [として要求する必要があります。](https://learn.microsoft.com/en-us/entra/identity-platform/optional-claims?toc=%2Fentra%2Fexternal-id%2Ftoc.json\&bc=%2Fentra%2Fexternal-id%2Fbreadcrumb%2Ftoc.json\&tabs=appui)
* [： アプリケーション向けに有効化できる追加の事前定義されたクレーム。](https://learn.microsoft.com/en-us/entra/identity-platform/custom-claims-provider-overview)

GitBook に送信するための適切なクレームを設定および構成したら、次に進むには「[コンテンツの適応](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/adaptive-content/adapting-your-content)」に移動してサイトの設定を続けてください。
