> ## 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.

# IPホワイトリストを使用したテナントへのアクセス制限

> コンソールまたは dbo.Tenant テーブル で有効にした ABBYY FlexiCapture 12 Authentication Module の IP ホワイトリスト機能を使用して、テナントへのアクセスを制限します。

<Info>
  このセクションは、ABBYY FlexiCapture 管理者の権限を持つユーザーのみが参照できます。
</Info>

テナントのセキュリティを強化するために、IP アドレスのホワイトリストを使用できます。

ABBYY FlexiCapture 12 Authentication Module の **IP ホワイトリスト** 機能を設定すると、事前定義されたホワイトリストに含まれていない IP アドレスからのテナントへのアクセスを制限できます。この機能はデフォルトでは有効になっていません。詳細については、[IP ホワイトリスト 機能を有効にする](#activation) を参照してください。

<div id="requirements-and-supported-ip-address-formats">
  ## 要件とサポートされる IP アドレス形式
</div>

次の要件に注意してください。

* デフォルトのテナント IP アドレスのリストは、ホワイトリストとして使用できません。
* ABBYY FlexiCapture Authentication Module が必要です。

デフォルトでは、次の形式の IPv4 プロトコルのみがサポートされます。

| 形式                                          | 例                 |
| ------------------------------------------- | ----------------- |
| 特定の IP アドレス                                 | `192.168.0.48`    |
| CIDR 形式の IP アドレス範囲                          | `192.168.0.48/24` |
| Processing Server が稼働しているローカルコンピューターからのアクセス | `::1`             |

Processing Server が稼働しているコンピューターで IPv4 プロトコルと IPv6 プロトコルの両方が同時に有効になっている場合は、[ホワイトリストに IPv6 ノードのアドレスも指定する必要があります](#ipv6)。

## <a id="activation" />IP ホワイトリスト 機能の有効化

IP ホワイトリスト は、**dbo.Tenant** テーブルまたは管理および監視コンソールのいずれかで有効にできます。

<div id="enable-the-ip-whitelist-in-the-dbotenant-table">
  ### dbo.Tenant テーブルで IP ホワイトリストを有効にする
</div>

IP ホワイトリスト機能を有効にするには、**dbo.Tenant** テーブルの **Flags** field で、該当するテナントの 4 番目のビットを設定します。

以下の手順では、Microsoft SQL Server を例として使用します。

<Steps>
  <Step title="SQL Server Management Studio を開く">
    Microsoft SQL Server Management Studio を開きます。
  </Step>

  <Step title="IP ホワイトリストを有効にする">
    次のいずれかを実行します。

    * 次のコマンドを入力します。

      ```sql theme={null}
      UPDATE Tenant SET Flags = Flags | 8 WHERE Name = MyTenant
      ```

    * **dbo.Tenant** テーブルの **Flags** field で、対象のテナントの 4 番目のビットを設定します。
  </Step>

  <Step title="IP ホワイトリストを設定する">
    **dbo.TenantWhiteIp** テーブルに IP ホワイトリストを設定します。

    * **TenantId** column で、テナントの ID を指定します。
    * **IP** column で、そのテナントに対してホワイトリストに登録する IP アドレスまたは IP 範囲を指定します。

    <Note>
      テナントの ID は **dbo.Tenant** テーブルで確認できます。
    </Note>
  </Step>
</Steps>

<div id="enable-the-ip-whitelist-in-the-administration-and-monitoring-console">
  ### 管理および監視コンソールで IP ホワイトリストを有効にする
</div>

<Steps>
  <Step title="コンソールを起動する">
    対象のテナントで管理および監視コンソールを起動します。
  </Step>

  <Step title="IP ホワイトリストの設定を開く">
    **Settings** > **IP Whitelist** に移動します。
  </Step>

  <Step title="IP ホワイトリストを有効にする">
    **Enable IP whitelisting** を選択します。
  </Step>

  <Step title="許可する IP アドレスを指定する">
    **Allowed IP address blocks** フィールドで、許可する IP アドレスまたはアドレス範囲を CIDR 形式で指定します。

    <Note>
      IP アドレスを CIDR 形式で指定すると、システムが IP アドレスの範囲を自動的に計算します。
    </Note>
  </Step>

  <Step title="設定を保存する">
    **Save** をクリックします。
  </Step>
</Steps>

<Info>
  管理および監視コンソールでは、IP アドレスをホワイトリストに追加できるのはテナント内のみで、メイン環境では追加できません。IP アドレスをホワイトリストに追加するには、ABBYY FlexiCapture 管理者またはテナント管理者ロールが必要です。
</Info>

## <a id="ipv6" />IPv6 プロトコル

Processing Server を実行しているコンピューターで IPv4 と IPv6 の両方が有効になっている場合は、IPv6 が有効なマシンのアドレスも指定する必要があります。あるいは、IPv6 プロトコルを無効にすることもできます。

プロキシ接続の場合は、IP ホワイトリストにプロキシサーバーの IPv6 アドレスを指定してください。

次のスクリーンショットは、IPv6 ホワイトリストのサンプルを示しています。

<Frame>
  <img src="https://mintcdn.com/abbyy/8aWHPAJyzWmTqglX/images/flexi-capture/ipv6.png?fit=max&auto=format&n=8aWHPAJyzWmTqglX&q=85&s=23f53f7d0233abdb16651cbbeaaea8ff" alt="dbo.TenantWhiteIp テーブルのスクリーンショット。IPv6 ホワイトリストのサンプル エントリが表示され、テナントの IP 列内の IPv6 アドレスが強調表示されています。" width="439" height="104" data-path="images/flexi-capture/ipv6.png" />
</Frame>

<div id="get-the-ip-whitelist-using-the-abbyy-flexicapture-api">
  ## ABBYY FlexiCapture API を使用して IP ホワイトリストを取得する
</div>

IP ホワイトリストを取得するには、[GetWhiteIPList](/ja/flexi-capture/get-white-ip-list) メソッドを使用します:

```text theme={null}
GetWhiteIPList("ID_Tenant" or "-1")
```

かっこ内には、特定のテナントの ID、または `-1` のいずれかを指定します。`-1` を指定すると、すべてのテナントでホワイトリストに登録されているアドレスが表示されます。

次の PowerShell スクリプトは、API 呼び出し例を示しています:

```powershell theme={null}
$url = "http://localhost"
$authUri = $url + '/FlexiCapture12/Server/AuthAPI/v1/WSDL'
$authSvc = New-WebServiceProxy -Uri $authUri -UseDefaultCredential
$test = $authSvc.GetWhiteIPList(-1)
$test
```

このスクリプトを実行すると、ホワイトリストに登録されている IP アドレスが表示されます。