# インストールと構成

### 前提条件

Netacea を使用して正常に統合するには、以下の準備が必要です：

1. Fastly バージョン 1.2.131 以上。
2. [Netacea portal](https://docs.netacea.com/jp/netacea-puraguin/accessing-your-integration-settings) で関連する API キーとログ配信エンドポイントへのアクセス。
3. [Monitoring ](https://docs.netacea.com/jp/netacea-puraguin/fastly/monitoring-configuration)の設定が完了していること。

また、お客様は Fastly にサポートチケットを作成し、環境内で POST を有効にする必要があります。デフォルトでは有効になっていない 2 つの pragma を Fastly アカウントで有効にする必要があります。

必要な Pragma：

```
Pragma optional_param fix_unsent_body_drain true;
Pragma optional_param no_body_if_bereq_is_get_or_head true;
```

Pragma を有効にするには、[Fastly Support](https://support.fastly.com) にサポートチケットを作成してください。

### 実装手順

* Fastly Web インターフェースにログインします。
* ホームページから、該当するサービスを選択します。検索ボックスを使用して、ID、名前、またはドメインで検索できます。
* 「Edit configuration」ボタンをクリックし、アクティブバージョンをクローンするオプションを選択します。Domains ページが表示されます。

以下のすべての設定変更は、新しくクローンしたバージョンに対して行います。

{% hint style="info" %}
将来ロールバックが必要になった場合に備えて、現在のアクティブバージョンをメモしておいてください。
{% endhint %}

### ホスト

Netacea VCL が Protector API を呼び出せるようにするには、[VCL snippets](#vcl-snippets) で呼び出す Netacea の詳細を含む 2 つの新しいホストを設定する必要があります。

* Origins リンクをクリックします。Origins ページが表示されます。
* 「Create a Host」ボタンをクリックします。Host フィールドが表示されます。

以下の URL で新しいホストを設定し、「Add」をクリックします：

```
mitigations-lbr.netacea.net
```

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-b7c4ea80005bb4ee1bea3868966b361aab551e4a%2FMitSvc2.PNG?alt=media" alt=""><figcaption></figcaption></figure>

鉛筆アイコンをクリックして新しいホストを編集し、名前を以下に変更します：

```
MitSvc
```

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-ebf7b118465ac7bef8c82bb7bbd51f4b245fdcf3%2FMitSvc.PNG?alt=media" alt=""><figcaption></figcaption></figure>

Override host フィールドに、元のホストと同じ URL を入力します。

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-7275cea7605b5ffa73dd1f752c9b97abd22a6928%2FScreenshot%202025-04-02%20161507.png?alt=media" alt=""><figcaption></figcaption></figure>

同じプロセスを繰り返し、以下の URL で新しいホストを設定し、「Add」をクリックします：

```
assets.ntcacdn.net
```

鉛筆アイコンをクリックして新しいホストを編集し、名前を以下に変更します：

```
CaptchaAssets
```

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

### VCL スニペット

Netacea を動作させて保護を提供するには、カスタム VCL の形式で Fastly 環境にソリューションを追加する必要があります。

Netacea VCL は 7 つの主要なスニペット（INIT、DELIVER、RECV、ERROR、RECV\_CONFIGURE、PASS、MISS）に分かれています。それぞれを Fastly 内の VCL Snippets 設定に追加する必要があります。

{% hint style="info" %}
Netacea から VCL は別途提供されます。
{% endhint %}

**INIT：**

* Fastly 内の VCL snippets に移動します。
* 「Create snippet」ボタンをクリックします。
* スニペットに適切な名前（Netacea\_INIT など）を付けます
* タイプを「init」に設定します

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

* INIT コードを VCL に貼り付けます
* 4 行目から 24 行目に、各デプロイメント固有の定義フィールドがあります。integration\_type を適切なモードに設定してください。

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

**必須フィールド**

<table data-full-width="true"><thead><tr><th width="338">Field</th><th>Value</th></tr></thead><tbody><tr><td>integration_type</td><td>fastly</td></tr><tr><td>integration_version</td><td>&#x3C;Integration Version></td></tr><tr><td>integration_mode</td><td><p>BYPASS - Netacea 統合を完全に無効にします</p><p>INGEST - Netacea がトラフィックを収集・分析するためのパッシブモード</p><p>MITIGATE - Netacea の Intent Analytics® に基づいて緩和を行うアクティブモード</p><p>INJECT - バックエンドで Netacea 分析を受信し、実行するアクションを決定したいお客様向けのアクティブモード</p></td></tr><tr><td>api_key</td><td><a href="../accessing-your-integration-settings">Netacea portal</a> から提供されます</td></tr><tr><td>secret_key</td><td><a href="../accessing-your-integration-settings">Netacea portal</a> から提供されます</td></tr><tr><td>encryption_key</td><td><a href="../accessing-your-integration-settings">Netacea portal</a> から提供されます</td></tr><tr><td>cookie_name</td><td><p>緩和 Cookie の適切な名前。</p><p><strong>セキュリティ強化のため、この名前に Netacea や Mitigation を含めないでください。</strong></p></td></tr><tr><td>captcha_cookie_name</td><td><p>Captcha 追跡 Cookie の適切な名前。</p><p><strong>セキュリティ強化のため、この名前に Netacea や Mitigation を含めないでください。</strong></p></td></tr><tr><td>ignore_list</td><td>緩和を適用しないサブディレクトリのカンマ区切りリスト。ここには最大 5 つのサブディレクトリを設定できます。そのディレクトリ下のすべてのリソースは統合によって無視されます。<br>統合を完全にカバーしつつメディアコンテンツでトリガーしないよう、デフォルトで <code>/media/,/static/</code> を追加してください。</td></tr></tbody></table>

**オプションフィールド - Netacea チームと協議しない限り空白のままにできます**

<table data-full-width="true"><thead><tr><th width="330">Field</th><th>Value</th></tr></thead><tbody><tr><td>real_ip_header_name</td><td><p>リクエストの IP に使用するヘッダーをカスタマイズできます。</p><p>Fastly 標準の <code>client.IP</code> フィールドを使用する場合は、デフォルトで <strong>空白のまま</strong> にしてください。</p></td></tr><tr><td>use_relative_path_captcha_assets</td><td><code>true</code> に設定すると、Captcha が Netacea CDN への参照なしで配信されます。設定しない場合、Captcha HTML に Netacea CDN への完全な URL が埋め込まれます。<br>サイト全体で HTML を使用する場合は、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr><tr><td>captcha_path</td><td>常に Captcha HTML を配信するエンドポイントを作成できます。モバイルアプリ用の Captcha チャレンジを実装する際に便利です。<br>/ATAverify パスウェイを使用する場合は、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr><tr><td>captcha_header</td><td>レスポンスが Captcha ページかどうかを示すカスタムヘッダー。<code>name={{header name}}&#x26;value={{header value}}</code> の形式である必要があります。</td></tr><tr><td>enable_captcha_content_negotiation</td><td>Captcha ページの形式を処理します。<code>true</code> に設定すると、統合が JSON 形式で Captcha ページを返すことができます。<br>サイト全体で HTML を使用する場合は、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr></tbody></table>

<figure><img src="https://2885909206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKs3gGgxDF9S8O56fhTGU%2Fuploads%2Fgit-blob-525038b624bb0310dbd4fb6300b7e9aaa97de335%2Fimage%20(75).png?alt=media" alt=""><figcaption><p>有効な設定の例</p></figcaption></figure>

詳細オプションで、優先度を 45 に設定します。

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

**RECV**：

* 「Create snippet」ボタンをクリックします
* スニペットに適切な名前（Netacea\_RECV など）を付けます
* タイプを「within subroutine」および「recv (vcl\_recv)」に設定します
* RECV コードを VCL に貼り付けます
* 優先度を 45 に設定します

**DELIVER**

* 「Create snippet」ボタンをクリックします
* スニペットに適切な名前（Netacea\_DELIVER など）を付けます
* タイプを「within subroutine」および「deliver (