# プロパティ構成

### 前提条件

Netaceaを使用した連携を正常に行うには、以下を確認してください：

1. NetaceaからのAPIキーおよびシークレットキーへのアクセス権を取得していること。
2. Akamaiが[Netacea Fail Open](https://docs.netacea.com/jp/netacea-puraguin/akamai/installation-and-configuration/..#configuring-netacea-fail-open)を設定済みであること。
3. [プロキシプロパティ設定](https://docs.netacea.com/jp/netacea-puraguin/akamai/installation-and-configuration/proxy-property-configuration)を完了していること。
4. [Edge Workerインストール ](https://docs.netacea.com/jp/netacea-puraguin/akamai/installation-and-configuration/edgeworker-installation)を完了していること。

## プロパティ設定

Netaceaが保護するすべてのプロパティで完了する必要がある設定がいくつかあります。これらの設定は変数とルールで構成されています。

#### プロパティ変数

まず、プロパティのルートで変数を設定します。これらは以下の表に記載されています：

<table><thead><tr><th width="291">変数名</th><th width="135">初期値</th><th width="219">説明</th><th>セキュリティ設定</th></tr></thead><tbody><tr><td>NETACEA_API_KEY</td><td>空白</td><td>Netacea APIキー。値はルールによって設定されます。</td><td>非表示</td></tr><tr><td>NETACEA_SECRET_KEY</td><td>空白</td><td>Netaceaシークレットキー。値はルールによって設定されます。</td><td>非表示</td></tr><tr><td>CLIENT_IP</td><td>空白</td><td>実クライアントIP</td><td>表示</td></tr><tr><td>NETACEA_MITIGATION_TYPE</td><td>INGEST、MITIGATE、またはINJECT</td><td><p>INGEST - 連携は取り込みのみ。<br><br>MITIGATE - 連携は取り込みと緩和を実行。<br></p><p>INJECT - 連携は取り込みを行い、アクションを実行する代わりに緩和ヘッダー値を返却。</p></td><td>表示</td></tr><tr><td>NETACEA_MITIGATION_URL</td><td><a href="proxy-property-configuration">プロキシプロパティ</a>ホスト名</td><td>Netaceaへトラフィックをプロキシするための変数。<strong>https://</strong>のプレフィックスを含む必要があります。</td><td>表示</td></tr><tr><td>NETACEA_DS2_CUSTOM_FIELD</td><td>空白</td><td>カスタムセッション情報を含む変数</td><td>非表示</td></tr><tr><td>FAILOVER_SECRET</td><td>&#x3C;Netacea提供のフェイルオーバーシークレット></td><td>EdgeWorkerがオープンフェイルするように、EdgeWorker障害時に使用するNetacea提供の文字列</td><td>機密</td></tr><tr><td>FAILOVER_HEADER_VALUE</td><td>空白</td><td>x-ew-failoverヘッダーの値</td><td>機密</td></tr><tr><td>ORIG_HOST</td><td>%(AK_HOST)</td><td>Netaceaフェイルオーバーに使用されるホスト</td><td>表示</td></tr><tr><td>NETACEA_INGEST_TYPE</td><td>ORIGIN</td><td>取り込みタイプを定義し、AkamaiがHTTPにデフォルト設定しないようにします</td><td>表示</td></tr><tr><td>NETACEA_COOKIE_NAME</td><td>&#x3C;任意のCookie名></td><td>Netacea緩和Cookieの名前を定義します。<mark style="color:red;">*</mark></td><td>表示</td></tr><tr><td>NETACEA_CAPT_COOKIE_NAME</td><td>&#x3C;任意のCookie名></td><td>Netacea CAPTCHAのCookie名を定義します。<mark style="color:red;">*</mark></td><td>表示</td></tr><tr><td>NETACEA_ENCRYPTION_KEY</td><td>&#x3C;Netacea提供のCookie暗号化キー></td><td>空白でない場合、Cookie暗号化を有効にします。<mark style="color:red;">*</mark></td><td>非表示</td></tr><tr><td>NETACEA_CAPT_REL_ASSETS</td><td>TRUE</td><td>NetaceaサーバーからCAPTCHAアセットを取得します。</td><td>表示</td></tr></tbody></table>

{% hint style="info" %} <mark style="color:red;">\*</mark>これらの変数は、Netaceaのデフォルトのクッキー名と値を一般公開から隠すことでセキュリティを強化するために使用されます。Cookie名はNetaceaと無関係な値に設定してください。
{% endhint %}

これらの設定が完了したら、プロパティ内のルール設定に進みます。

### プロパティルール

プロパティをデプロイする前に、いくつかのルールを設定する必要があります。各ルールと必要な関連設定は以下のとおりです。

### **新規ルール（空白ルールテンプレート）：Netacea**

これはNetaceaルールをグループ化するためのルールネストとして機能します。

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-d3ae9a204cf31f6566e84837b5160e005c4d3391%2Fimage%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### **新規ルール（空白ルールテンプレート）：Set Failover Variable**

Netaceaネストルール内に、以下を追加します。

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-343feeb7f38cea109a78624232479f24a6b07bc9%2Fimage%20(67).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
フェイルオーバー値のヘッダーを比較するには、ヘッダーから読み取り、変数として保存する必要があります。その後、シークレット値の漏洩を防ぐためにヘッダーは削除されます。
{% endhint %}

### 条件と動作の追加

| 条件                |
| ----------------- |
| すべてに一致            |
| **If**            |
| リクエストヘッダー         |
| **x-ew-failover** |
| 存在する              |

| 動作 |
| -- |
|    |

### **新規ルール（空白ルールテンプレート）：Set Mitigation for \<hostname>**

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-77bde586fc8a75ea314beeb78de0975a721e7912%2Fimage%20(38).png?alt=media" alt=""><figcaption></figcaption></figure>

### 条件と動作の追加

| **緩和ルール**    |
| ------------ |
| *コメントを追加...* |

| 条件                                    |
| ------------------------------------- |
| すべてに一致                                |
| **If**                                |
| ホスト名                                  |
| 次のいずれか                                |
| **\<hostname>**                       |
| **And**                               |
| 変数                                    |
| **PMUSER\_FAILOVER\_HEADER\_VALUE**   |
| 次と異なる                                 |
| **{{user.PMUSER\_FAILOVER\_SECRET}}** |
| **And\***                             |
| リクエストプロトコル\*                          |
| HTTPS\*                               |

{% hint style="info" %}
\*HTTPをHTTPSに転送するプロパティの場合のみ
{% endhint %}

| 動作 |
| -- |
|    |

{% hint style="info" %}
固有のNetacea APIキーとシークレットキーに関連付けられているこのプロパティ内の各ドメイン（ホスト名）に対して、上記のルールを再作成してください。
{% endhint %}

### **新規ルール（空白ルールテンプレート）：Netacea Fail Open**

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-86e72e7dcdbd74a16b3bb9c5e5cd8d77111fc684%2Fimage%20(39).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
このFail Openルールには、Advanced XML動作の使用が必要です。

このAdvanced Custom XMLブロックを追加するには、Akamaiアカウント担当者に連絡し、Akamai Professional Servicesにカスタム動作の作成を依頼してください。これにより、アカウント内のプロパティ設定に追加できるようになります。
{% endhint %}

| 条件                  |
| ------------------- |
| すべてに一致              |
| **If**              |
| メタデータステージ           |
| 次と一致                |
| **client-response** |
| **And**             |
| EdgeWorkers実行ステータス  |
| **Failure**         |

| 動作 |
| -- |
|    |

{% hint style="info" %} <mark style="color:red;">\*</mark>フェイルオーバーAdvanced動作は、[Netacea Fail Open XML](https://docs.netacea.com/jp/netacea-puraguin/akamai/installation-and-configuration/..#configuring-netacea-fail-open-xml)が追加されるまで使用できません。
{% endhint %}

カスタム動作が追加されると、以下のように**Advanced**として表示されます。

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-c96edfc8857ba4d9908cfccb6dc3fbe3efa4bece%2Fimage%20(1)%20(8).png?alt=media" alt=""><figcaption></figcaption></figure>

### **新規ルール：Conditional Origin Group**

このルールは、[DataStream](https://docs.netacea.com/jp/netacea-puraguin/akamai/monitoring-configuration)ルールとともに、Netaceaネストルールの外側、他のプロパティルールの後に配置されます。

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-1dbe876eb709a94532d2c9253870a758c321bd6a%2Fimage%20(3)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

### 条件と動作の追加

| **Conditional Origin Group** |
| ---------------------------- |
| \_コメント                       |