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

# SAML 2.0 外部 ID プロバイダーとしての Active Directory

> お使いの ABBYY Vantage テナントで Active Directory Federation Services (AD FS) を SAML 2.0 の外部 ID プロバイダーとして構成する。

<div id="prerequisites">
  ## 前提条件
</div>

* ID を構成する前に、Vantage のテナント識別子を用意してください。テナント識別子を取得するには、ABBYY Vantage で **Configuration** をクリックします。識別子は **General** タブに表示されます。
* 認証応答を受け取るための Redirect URI を作成します。URI は次のとおりです:
  `https://<your-vantage-url>/auth2/Saml2/Acs`

<div id="setup">
  ## セットアップ
</div>

セットアップ手順は次のとおりです：

* [クレームの説明を追加](#adding-a-claim-description)
* [Relying party trust の構成](#configuring-a-relying-party-trust)
* [受信クレームを変換するルールの追加](#adding-rules-to-transform-an-incoming-claim)

<div id="adding-a-claim-description">
  ### クレームの説明を追加する
</div>

<Steps>
  <Step title="管理コンソールを開く">
    AD FS 管理コンソールを開きます。
  </Step>

  <Step title="Add Claim Description を開く">
    **Service > Claim Descriptions** を選択し、**Add Claim Description** をクリックします。
  </Step>

  <Step title="クレームの説明を入力する">
    次の項目を指定します:

    * **Display name** — たとえば `Persistent Identifier`。
    * **Claim type** — `urn:oasis:names:tc:SAML:2.0:nameid-format:persistent`。
    * **Publish this claim description in federation metadata as a claim type that this federation service can accept** を選択します。
    * **Publish this claim description in federation metadata as a claim type that this federation service can send** を選択します。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_1.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=ac11e65fe576aa3a7cd27a277b3d3772" alt="表示名と Persistent Identifier のクレームの種類の field を含む AD FS の Add Claim Description ダイアログ" style={{ width:"71%" }} width="638" height="610" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_1.png" />
    </Frame>
  </Step>

  <Step title="確認">
    **OK** をクリックします。
  </Step>
</Steps>

これで、異なるシステム間でユーザー属性のマッピング方法を制御できるようになります。

<div id="configuring-a-relying-party-trust">
  ### Relying party trust の構成
</div>

AD FS の Relying party trust を作成するには、次の手順に従います。

<Steps>
  <Step title="Relying Party Trust を追加する">
    コンソール ツリーで、**AD FS** の下にある **Trust Relationships > Relying Party Trusts > Add Relying Party Trust** を選択します。
  </Step>

  <Step title="ウィザードを開始する">
    **Welcome** ページで **Claims aware** を選択し、**Start** をクリックします。
  </Step>

  <Step title="データ ソースを選択する">
    **Select Data Source** ページで **Enter data about the relying party manually** を選択し、**Next** をクリックします。
  </Step>

  <Step title="表示名を指定する">
    **Specify Display Name** ページで、**Display Name** に任意の名前を入力し、**Next** をクリックします。
  </Step>

  <Step title="プロファイルを選択する">
    **Choose Profile** ページで **AD FS 2.0 profile** を選択し、**Next** をクリックします。
  </Step>

  <Step title="証明書を構成する">
    **Configure Certificate** ページで **Next** をクリックします。
  </Step>

  <Step title="URL を構成する">
    **Configure URL** ページで **Enable support for the SAML 2.0 WebSSO protocol** を選択します。**Relying party SAML 2.0 SSO service URL** に `https://<your-vantage-url>/auth2/Saml2/Acs` を入力し、**Next** をクリックします。
  </Step>

  <Step title="ID を構成する">
    * **Relying party trust identifier** に `api://platform.abbyy.cloud/tenantId` を入力します。ここで `tenantId` は、ハイフンなしの GUID 形式のテナント識別子です (例: `117489fc1aea41658369d4d18d6557ga`) 。この値は、認証用の Application ID URI として使用されます。この値をコピーしてください。後で Vantage で外部 ID プロバイダーを構成するときに必要になります。**Add** をクリックします。
    * **Expose an API** タブで、Application ID URI に上で入力したものと同じ値を設定します (例: `api://cccc3333-dddd-4444-eeee-5555ffff6666`) 。**Add** をクリックし、続けて **Next** をクリックします。
  </Step>

  <Step title="Issuance Authorization Rules を選択する">
    すべてのユーザーに Vantage へのアクセスを許可するには、**Permit all users to access this relying party** を選択します。特定のグループのみにアクセスを制限するには、**Permit specific group** を選択し、そのグループを指定します。**Next** をクリックします。
  </Step>

  <Step title="trust を追加する">
    **Ready to Add Trust** ページで設定を確認します。**Next** をクリックし、次に **Close** をクリックします。
  </Step>
</Steps>

ID プロバイダーと ABBYY Vantage の間の信頼関係が確立されます。

<div id="adding-rules-to-transform-an-incoming-claim">
  ### 受信クレームを変換するルールの追加
</div>

受信クレームを変換するルールを適用するには、次の手順に従います。

<Steps>
  <Step title="Relying Party Trusts を開く">
    **Relying Party Trusts** をクリックします。
  </Step>

  <Step title="Claim Issuance Policy を編集する">
    選択した relying party trust を右クリックし、**Edit Claim Issuance Policy** をクリックします。
  </Step>

  <Step title="ルールを追加する">
    **Edit Claim Issuance Policy for \<name>** ウィンドウで、**Add Rule** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_2.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=ce66660c440732b209b9cefd1ed8fdab" alt="SAML クレームルール用の Add Rule ボタンがある AD FS の Edit Claim Issuance Policy ダイアログ" style={{ width:"60%" }} width="486" height="543" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_2.png" />
    </Frame>
  </Step>

  <Step title="ルールテンプレートを選択する">
    **Transform an Incoming Claim** クレームルールテンプレートを選択し、**Next** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_3.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=323c987dcbc44d4183160f9e50f18939" alt="Transform an Incoming Claim テンプレートが選択されている AD FS の Add Transform Claim Rule ウィザード" style={{ width:"72%" }} width="716" height="582" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_3.png" />
    </Frame>
  </Step>

  <Step title="クレームルールを構成する">
    **Configure Claim Rule** ステップを選択し、次のように指定します。

    * **Claim rule name** — `TransformWindows account name`.
    * **Incoming claim type** — **Windows account name**。
    * **Outgoing claim type** — **Name ID**。
    * **Outgoing name ID format** — **Persistent Identifier**。
    * **Pass through all claim values** を選択します。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_5.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=8ffeb41e66f7c368433f79475e2057a0" alt="受信クレームとして Windows account name、送信形式として Persistent Identifier が設定された AD FS の Configure Claim Rule ステップ" style={{ width:"74%" }} width="716" height="582" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_5.png" />
    </Frame>
  </Step>

  <Step title="最初のルールを完了する">
    **Finish** をクリックします。
  </Step>

  <Step title="Send LDAP Attributes ルールを追加する">
    発行されるトークンにメールおよび名前のクレームが含まれるように、別のルールを追加します。**Select Rule Template** ページで、**Claim rule template** の **Send LDAP Attributes as Claims** を選択し、**Next** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_4.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=ddda2279d705a482c6f69f92507cdafb" alt="Send LDAP Attributes as Claims テンプレートが選択されている AD FS の Add Transform Claim Rule ウィザード" style={{ width:"71%" }} width="718" height="583" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_4.png" />
    </Frame>
  </Step>

  <Step title="LDAP ルールを構成する">
    **Configure Claim Rule** ページで、**Claim rule name** の下にある属性ストアとして **Active Directory** を選択し、**Finish** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_6.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=4cf4fa5ecbe25939dc952cc498470754" alt="Active Directory 属性ストアと、メールおよび名前の LDAP 属性マッピングが設定された AD FS の Configure Claim Rule" style={{ width:"73%" }} width="718" height="583" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_6.png" />
    </Frame>
  </Step>

  <Step title="ルールを確認する">
    追加したルールが **Edit Claim Rules** ダイアログに表示されます。

    <Frame>
      <img src="https://mintcdn.com/abbyy/jZX7kaKQgdxaDiIT/images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_7.png?fit=max&auto=format&n=jZX7kaKQgdxaDiIT&q=85&s=41259ea91239a8c1cfba5e1e140b2e87" alt="Persistent Identifier ルールと Send LDAP Attributes as Claims ルールの両方が表示されている AD FS の Edit Claim Rules ダイアログ" style={{ width:"60%" }} width="487" height="546" data-path="images/vantage/tenant-admin/sysadmin_identityprovider_activedirectory_saml_7.png" />
    </Frame>
  </Step>
</Steps>

<div id="next-steps">
  ## 次のステップ
</div>

AD FS の構成が完了したら、それを Vantage テナントに接続します。その際、次の形式のフェデレーション メタデータ ドキュメントの URL が必要です。`https://<adfs-server-address>/federationmetadata/2007-06/federationmetadata.xml`。たとえば、`https://adfs.platform.local/federationmetadata/2007-06/federationmetadata.xml` のようになります。

Vantage 側の設定については、「[テナントの外部 ID プロバイダーの設定](/ja/vantage/documentation/tenant-admin/tenant-management/configuring-tenant)」を参照してください。

<div id="related-topics">
  ## 関連トピック
</div>

* [SAML 2.0 外部 ID プロバイダーの設定](/ja/vantage/documentation/tenant-admin/tenant-management/saml-2-0)
* [SAML 2.0 外部 ID プロバイダーとしての Azure AD](/ja/vantage/documentation/tenant-admin/tenant-management/saml-2-0-azure-active-directory)
* [テナントの外部 ID プロバイダーの設定](/ja/vantage/documentation/tenant-admin/tenant-management/configuring-tenant)
* [外部認証のテスト](/ja/vantage/documentation/tenant-admin/tenant-management/testing-external-auth)