既存サイトの配下（ディレクトリ配下）にferret Oneを設定する方法

既にWebサイトをお持ちの場合は、特定ディレクトリ以下へのアクセスを、ferret Oneのサーバーに転送することができます。

ここでは、設定方法について紹介します。
ferret Oneでは、ApacheとNginxでの設定およびAmazon CloudFrontについて動作確認を行っておりますが、それ以外のサービスに関しては動作を保障しておりませんので、あらかじめご了承ください。

また、実施するためには、ご利用中のサーバーに対してご自身で設定していただく必要があり、専門知識を持った技術者の監修の下、ご自身の責任にて実施をお願い致します。
ferret One テクニカルサポートでは、本設定に関するサポートは致しかねますので、あらかじめご了承ください。
なお、運用中にトラブルが発生した場合（アクセスが不安定になる等）においても、明らかにferret Oneサーバーに問題があると認められる場合を除き、弊社は調査協力を致しかねます。

特定ディレクトリ配下設定とは

既存のサイトを動作したまま、ferret Oneで作成したページを特定ディレクトリ以下のみで表示するようにします。

特定ディレクトリ配下設定を実施する場合の注意点

ferret OneはAWSの環境下で運用しており、サーバーのIPアドレスが変動することが考えられます。このため、設定時には以下の点に特にご注意ください。
- ドメインベースでの設定を維持してください：下記の設定例はドメインベースでの設定を前提としています。これを踏まえ、設定の変更・カスタマイズを行う際もドメインベースを維持することを強く推奨します。
- キャッシュの注意：IPアドレスやドメインのキャッシュ設定がある場合は、キャッシュの期間を短めに設定するか、動的に変更が検知された際にキャッシュをクリアする仕組みを検討してください。
  
  これらの点を考慮せずに設定すると、ferret OneサーバーのIPアドレスが変わった際に、アクセスできなくなったり、想定外のサーバーにアクセスしてしまう可能性がございます。
  ※アクセスがない場合、ログも残りません。調査を行うことができませんのでご了承ください。
特定ディレクトリ配下設定の場合、SSLはお客様のサーバーを利用しますので、お客様のサーバー側でリダイレクト設定をお願いします。

上記についてご了承頂いた上で、以下の作業を進めて頂きます様お願い致します。

特定ディレクトリ配下設定手順

既存サイトをホスティングしているサーバーもしくはAmazon CloudFrontにて下記の設定を実施します。
それぞれ設定内容が異なりますので、いずれかをご覧ください。

＜Apacheの場合＞

Apache設定ファイル内に下記の記述を追記します。
SSL設定時と未設定時で記述が変わりますのでご注意ください。
※　XXX には任意のディレクトリ名をご記入ください

※　/__/ はフォームの送信処理や計測用ディレクトリとなります。PVやCV含め、ferret-one.com 側で各機能を利用するために必要なパスとなります。

  -------------ここから--------------
  ProxyPass /XXX http://host.ferret-one.com/XXX 
  ProxyPassReverse /XXX http://host.ferret-one.com/XXX 
  ProxyPass /__/ http://host.ferret-one.com/__/
  ProxyPassReverse /__/ http://host.ferret-one.com/__/
  ProxyPreserveHost On
  -------------ここまで--------------

  # SSLの場合以下のコードで対応
  -------------ここから--------------
  SSLProxyEngine on
  SSLProxyVerify none
  SSLProxyCheckPeerCN off
  SSLProxyCheckPeerName off
  ProxyPreserveHost On
  ProxyPass /XXX https://host.ferret-one.com/XXX 
  ProxyPassReverse /XXX https://host.ferret-one.com/XXX 
  ProxyPass /__/ https://host.ferret-one.com/__/
  ProxyPassReverse /__/ https://host.ferret-one.com/__/
  ProxyPreserveHost On
  -------------ここまで--------------

※注意点

ProxyPass、ProxyPassReverseディレクティブは.htaccessに設定することができません。
レンタルサーバーをご利用中の場合、.htaccess以外の設定ファイルを編集することができない可能性がございますので、サーバー会社とのご契約内容を事前にご確認ください。

mod_ssl、mod_proxyといったモジュールもインストールされている必要があります。

また、Apacheがferret One側のIPアドレスをキャッシュする場合、ProxyPassにおいて, disablereuse、retryオプションの設定します。

ProxyPass /XXX https://host.ferret-one.com/XXX retry=0 disablereuse=On

（参考サイト：https://oji-cloud.net/2020/01/10/post-3964/）

＜Nginxの場合＞

Nginx設定ファイル内に下記の記述を追記します。
SSL設定時と未設定時で記述が変わりますのでご注意ください。
※domain.comにはご利用中のドメイン名を、XXXには任意のディレクトリ名をご記入ください

※　__/ はフォームの送信処理や計測用ディレクトリとなります。PVやCV含め、ferret-one.com 側で各機能を利用するために必要なパスとなります。

  -------------ここから--------------
  #
  # A virtual host using mix of IP-, name-, and port-based configuration
  #
  server {
    listen 80;
    server_name domain.com;
    location / {
      root html;
      index index.html index.htm;
    }
    location ~ ^/(XXX|__/) {
      proxy_set_header Host $http_host;
      proxy_set_header X-Forwarded-for $remote_addr;
      add_header Access-Control-Allow-Origin *;
      add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
      proxy_pass http://host.ferret-one.com;
    }
  }
  -------------ここまで--------------

  # SSLの場合以下のコードで対応
  -------------ここから--------------
  server {
    listen 443;
    server_name domain.com;
    location / {
      root html;
      index index.html index.htm;
    }
    location ~ ^/(XXX|__/) {
      proxy_set_header Host $http_host;
      proxy_set_header X-Forwarded-for $remote_addr;
      add_header Access-Control-Allow-Origin *;
      add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
      proxy_set_header X-Forwarded-Proto https;
      proxy_set_header X-Forwarded-Ssl on;
      proxy_pass https://host.ferret-one.com;
    }
  }
  -------------ここまで--------------

また、Nginxの名前解決に関する問題の対策として、下記が必要な場合があります。