---
schema_version: "1"
id: 793f5b70e80b35aace80963734b16d7326ced35a3d828881e98fb45dd0756ba8
title: IP ブロックリストポリシー
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/gateway/1.8/policies-included-ip-blocklist.md
canonical_url: https://docs.mulesoft.com/jp/gateway/1.8/policies-included-ip-blocklist
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7444f1524605b840c5b0efdd77bc6d9accbb32aad25e82a4bbeca2a648c03306
description: MuleSoft Documentation Site
release: "1.8"
latest: false
---
# IP ブロックリストポリシー

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>ポリシー名</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">IP ブロックリスト</p></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>概要</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">単一の IP アドレスまたは IP アドレスの範囲からの API エンドポイントへのアクセスをブロックする</p></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>カテゴリ</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">セキュリティ</p></td>
</tr>
<tr>
<td class="tableblock halign-right valign-top"><p class="tableblock"><strong>使用可能な最小 Flex Gateway バージョン</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">v1.0.0</p></td>
</tr>
<tr>
<td class="tableblock halign-right valign-middle"><p class="tableblock"><strong>返される状況コード</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">403 - IP は拒否されました</p></td>
</tr>
</tbody>
</table>

## [](#概要)概要

IP ブロックリストポリシーは、単一の IP アドレスまたは IP アドレスの範囲からの設定済み API エンドポイントへのアクセスを制御します。

IP ブロックリストポリシーは、ソース IP (ポリシーの設定時に指定します) が個別 IP のリストまたは IP 範囲と一致した場合に、保護対象のリソースへのアクセスを禁止します。ポリシーでは、IPv4 アドレスと IPv6 アドレスの両方がサポートされています。

DataWeave 2.0 の式により、IP がポリシーで定義されている制約 IP リストに含まれているかどうかを確認するときに使用するソース IP を定義します。

## [](#ポリシーのパラメーターの設定)ポリシーのパラメーターの設定

### [](#flex-gateway-のローカルモード)Flex Gateway のローカルモード

ローカルモードでは、宣言型の設定ファイルを使用して IP ブロックリストポリシーを API に適用します。以下のポリシー定義とパラメーターの表を参照してください。

\- policyRef:
    name: ip-blocklist-flex
  config:
    ips: <array> // REQUIRED
    ipExpression: <string> // OPTIONAL, default: "#\[attributes.headers\['x-forwarded-for'\]\]"

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">必須または省略可能</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>ips</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必須</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>なし</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API からブロックする IP アドレスのリスト。IP または IP 範囲は一度に 1 つずつ、必要なだけ何度も定義できます。詳細は、​<a href="#specifying_ip_address">「ポリシーでブロックリスト登録する IP アドレスの指定」</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>ipExpression</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.headers['x-forwarded-for']]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この API 要求から IP アドレスを抽出するために使用する DataWeave 2.0 式。</p>
</div></div></td>
</tr>
</tbody>
</table>

#### [](#リソースの設定例)リソースの設定例

\- policyRef:
    name: ip-blocklist-flex
  config:
    ips:
      - "192.168.1.1"
      - "192.168.3.1/30"
      - "192.168.2"
      - "192.160"

### [](#flex-gateway-の接続モード)Flex Gateway の接続モード

UI から IP ブロックリスト登録済みリストポリシーを API に適用する場合は、以下のパラメーターを設定します。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>IP 式</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この API 要求から IP アドレスを抽出するために使用する DataWeave 2.0 式。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ブロックリスト</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API からブロックする IP アドレスのリスト。IP または IP 範囲は一度に 1 つずつ、必要なだけ何度も定義できます。詳細は、​<a href="#specifying_ip_address">「ポリシーでブロックリスト登録する IP アドレスの指定」</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Method &amp; Resource conditions (メソッドとリソースの条件)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API の一部またはすべてのメソッドおよびリソースに設定を追加するオプション。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#specifying_ip_address)ポリシーでブロックリスト登録する IP アドレスの指定

次の情報に基づいてポリシーでブロックする IP アドレスを指定します。

- 要求の IP アドレス。
- 特定の DataWeave 式を解決することで決定される発生元 IP アドレス ( [x-Forwarded-For](https://en.wikipedia.org/wiki/X-Forwarded-For)​ ヘッダーなど)。
- その他のすべての発生元。

### [](#要求の-ip-アドレスに基づいてアクセスをブロックリスト登録する)要求の IP アドレスに基づいてアクセスをブロックリスト登録する

次のいずれかの方法で、要求の IP アドレスに基づいてブロックリストにアクセスします。

- 特定の IP アドレスを定義するには、そのアドレスのみを指定します (例: `192.168.1.1`​)。
- アドレスのサブセットを定義するには、サブセットマスクを指定します。たとえば、​`192.168.3.1/30`​ など (これには、統合範囲 ​`192.168.3.0`​ ～ ​`192.168.3.3`​ が含まれます)。
- IP アドレスの範囲全体を定義するには、許可する IP アドレスの関連オクテットを指定します。たとえば、「​`192.168`​>」と設定すると、​`192.168.0.0`​ ～ ​`192.168.255.255`​ の IP アドレスが含まれます。

### [](#x-forwarded-for-ヘッダーの発生元-ip-アドレスに基づいてアクセスをブロックリスト登録する)x-Forwarded-For ヘッダーの発生元 IP アドレスに基づいてアクセスをブロックリスト登録する

クライアントが HTTP プロキシまたはロードバランサーを介して API に接続している場合、要求に含まれるアドレスではなく、クライアントの特定の IP アドレス (要求の発生元 IP アドレス) をブロックリスト登録できます。

たとえば、​`192.168.2.3`​ をブロックリスト登録して、HTTP プロキシを介して接続しているクライアントのアドレスが ​`92.40.1.255`​ である場合、クライアントの要求は、プロキシを使用した公開アドレスで表示されます。

通常、アプリケーションは ​`X-Forwarded-For`​ ヘッダーを使用して、エンドポイントにリダイレクトされた要求の発生元 IP アドレスを識別します。

ポリシーで DataWeave 2.0 式を使用してサービスに ​`x-Forwarded-For`​ ヘッダー内の IP アドレスを探すように指示できます。

ポリシーパラメーターの \[IP expression (IP 式)\] 項目で IP アドレスを指定すると、Anypoint Platform は要求の ​`x-Forwarded-For`​ ヘッダーの連結値に含まれる最初の IP アドレスを参照するように指示されます。