# インストールと構成

### 前提条件

Netacea を使用した統合を正常に行うには、以下をご確認ください：

1. Fastly バージョン 1.2.217 以降。このバージョンから統合用の Netacea Edge モジュールが追加されています。
2. [Netacea portal](https://docs.netacea.com/jp/netacea-puraguin/accessing-your-integration-settings) で関連する API キーとログ配信エンドポイントへのアクセス。

また、お客様は Magento にサポートチケットを開き、Fastly に対して環境内で POST を有効にするようリクエストする必要があります。お客様の Fastly アカウントで、デフォルトでは有効になっていない 2 つの pragma が有効になっていることを確認する必要があります。

必要な Pragma：

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

Pragma を有効にするには、Fastly/Magento サポートにサポートチケットを提出してください。これらの Pragma は手動で追加することはできません。

### 実装手順

* Fastly/Magento Web インターフェースにログインします。
* Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions に移動して、[前提条件](#implementation-prerequisites)セクションで説明した Pragma が有効になっていることを確認します。

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

* 最新の VCL バージョンを表示し、VCL の先頭で Pragma を確認します。

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

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

### 空の Dictionary を作成する

Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries に移動し、「Add Dictionary」をクリックします。

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

「netacea\_edge\_config」という名前で Dictionary を作成します。空のままで構いません。

{% hint style="info" %}
これは Netacea の指示に基づいて [Advanced Configuration](https://docs.netacea.com/jp/netacea-puraguin/fastly-magento/installation-and-configuration/advanced-configuration) を使用する場合にのみ入力されます。
{% endhint %}

### Netacea Edge モジュールをインストールする

Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules に移動し、Module Manager の「Manage」をクリックします。

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

* 「Netacea Bot Detection integration」Edge モジュールにチェックを入れ、「Save」をクリックします。

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

### モジュールにカスタマーキーを適用する

* Active Modules に移動し、「Netacea Bot Detection integration」のアクション歯車アイコンをクリックします。

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

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

**必須フィールドを入力する**

<table><thead><tr><th width="157">フィールド</th><th>値</th></tr></thead><tbody><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>Netacea API Key</td><td><a href="../accessing-your-integration-settings">Netacea portal</a> で提供</td></tr><tr><td>Netacea Secret</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>Netacea cookie name</td><td><p>緩和 Cookie に適した名前。</p><p><strong>セキュリティ強化のため、この名前に Netacea や Mitigation を含めないでください。</strong></p></td></tr><tr><td>Netacea captcha cookie name</td><td><p>Captcha トラッキング Cookie に適した名前。</p><p><strong>セキュリティ強化のため、この名前に Netacea や Mitigation を含めないでください。</strong></p></td></tr><tr><td>Netacea ignore list - URL Paths</td><td><code>/static/,/media/</code></td></tr></tbody></table>

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

<table><thead><tr><th width="278">フィールド</th><th>値</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 Captcha Page Assets</td><td><code>true</code> に設定すると、Netacea CDN への参照なしで Captcha が提供されます。それ以外の場合は、Captcha HTML に Netacea CDN への完全な URL が埋め込まれます。<br>サイト全体で HTML を使用するには、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr><tr><td>Captcha URL Path</td><td>常に Captcha HTML を提供するエンドポイントを作成できます。モバイルアプリ向けの captcha チャレンジを実装する際に便利です。<br>/ATAverify パスウェイを使用するには、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr><tr><td>Captcha Page Marker Header</td><td>レスポンスが Captcha ページかどうかを示すカスタムヘッダー。<code>name={{header name}}&#x26;value={{header value}}</code> の形式である必要があります。</td></tr><tr><td>Captcha Page Marker Header</td><td><p>captcha が提供されたことを示すヘッダーをユーザーのリクエストに適用します。</p><p>デフォルトで <strong>空白のまま</strong> にしてください。</p><p>値の例 <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Enable Captcha Content Negotiation</td><td>Captcha ページの形式を処理します。<code>true</code> に設定すると、統合が Captcha ページを JSON 形式で返すことができます。<br>サイト全体で HTML を使用するには、デフォルトで <strong>空白のまま</strong> にしてください。</td></tr></tbody></table>

### 完了

以下の手順が完了していることを確認してください：

* [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module) のインストール
* 提供された S3 バケットへの [log streaming](https://docs.netacea.com/jp/netacea-puraguin/monitoring-configuration#log-streaming-implementation-steps) の設定
* エラー警告が表示されていないことを確認

「Save Config」をクリックしてデプロイする準備が整いました。

{% hint style="info" %}
キャッシュのフラッシュが必要になる場合があります。System -> Cache Management に移動し、「Flush Magento Cache」をクリックしてください。
{% endhint %}

これで、Fastly/Magento 環境にボット管理がデプロイされます。以下の方法でデプロイがアクティブであることをテストできます：

* Web サイトで Netacea Cookie の存在を確認する
* レポートダッシュボードでトラフィックと緩和状況を確認する
* Netacea に内部メトリクスのレビューをリクエストする