---
schema_version: "1"
id: 2b248a16730a6aaf846249e3337e2a589f7b8ca4b8604383271b1b2c2e792103
title: IP 許可リストポリシー
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-gateway/policies-included-ip-allowlist.md
canonical_url: https://docs.mulesoft.com/jp/mule-gateway/policies-included-ip-allowlist
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 5453bef06b1a455707b8285f4db9d9f67333644b23862d9dc5a75ea09e718e9c
description: MuleSoft Documentation Site
latest: true
---
# 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 アドレスのリストまたは範囲からのアクセス要求を許可する</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>使用可能な最小 Mule バージョン</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">v4.1.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 のリストまたは IP 範囲と一致した場合に、指定された IP アドレスのリストまたは範囲に保護対象のリソースへのアクセスを許可します。

ビジネスのニーズに応じて、Mule 4 では DataWeave 2.0 式、Mule 3 では MEL 式を指定します。これらの式により、IP がポリシーの制約 IP リストに含まれているかどうかを確認するためにポリシーで使用されるソース IP を定義します。

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

### [](#mule-ゲートウェイ)Mule ゲートウェイ

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 または MEL 式。</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 式または MEL 式を解決することで決定される発生元 IP アドレス ( [x-Forwarded-For](https://en.wikipedia.org/wiki/X-Forwarded-For)​ ヘッダーなど)。
- その他のすべての発生元。

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

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

- 特定の IP アドレスを定義するには、そのアドレスのみを \[Allowlist (許可リスト)\] 項目に指定します (例: `192.168.1.1`​)。
- アドレスのサブセットを定義するには、サブセットマスクを指定します。たとえば、​`192.168.3.1/30`​ など (これには、統合範囲 ​`192.168.3.01`​ ～ ​`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`​ (非公開 IP) を許可リスト登録して、HTTP プロキシを介して接続しているクライアントのアドレスが ​`92.40.1.255`​ (公開 IP) である場合、クライアントの要求は、プロキシを使用した公開アドレスで表示されます。

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

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

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