6 . [ embedded_sessions_only:]

サードパーティーCookieを無効にしているブラウザからJavascript APIによるインバウンドコールを行うと、新しいタブを開いてセッションを開始します。このオプションを有効にすると、サードパーティーCookieを無効にしたブラウザでのJavascript APIによるインバウンドセッションを完全に禁止することができます。初期値では設定が無効です。

7. [verbose_console:]

ブラウザのデベロッパーツールのコンソールには、製品内部から出力されるメッセージがすべて表示されるわけではなく、重要なメッセージのみが選別されて表示されます。このオプションを有効にすることで、すべてのメッセージを出力することが可能です。初期値では設定が無効です。

8. [ white_label :]

このオプションを有効にすると、セッション中に画面左下に表示される「  Surfly  」ロゴのウォーターマークを非表示にします。

９. [encrypt_httponly_cookies/cookie_transfer_enabled/cookie_transfer_proxying/cookie_transfer_urls/cookie_transfer_scopes:]

インバウンドセッションの開始時に元のWebサイトから引き継ぎ可能なCookieをセッション内に転送してコブラウジングを行います。

HttpOnly属性を持つCookieについて

HttpOnly属性が付いているCookieはJavaScriptからのアクセスを許可していないため、これらのCookieをSurflyで処理するためにはあらかじめ設定が必要になります。これを実現するのが「セッション継続ポイント」になります。セッション継続ポイントを設定することで、HttpOnly属性を含むCookieをSurflyサーバーへ転送し、セッションへの引継ぎを行います。

セッション継続ポイントの設定には、ロードバランサへのプロキシパスの追加およびダッシュボードでの設定が必要になります。

ロードバランサへのプロキシパス追加

セッション継続ポイントを設定するには、ロードバランサへプロキシパスを追加します。これにより、Surflyサーバーが指定されたプロキシパスへアクセス可能になります。複数のドメインにSurflyを実装する場合は、継続ポイントも複数必要になります。

以下に紹介する記載内容の例をconfファイルに記載することで、プロキシパスを追加できます。

記載内容例(Nginx)

1. location /surfly_cookie_transfer/ {
   
2.  proxy_pass  https://surfly.jp;
   
3.  proxy_redirect off;
   
4.  proxy_set_header X-Continuation-Origin  https://example.com;
   
5.  proxy_set_header X-Widget-Key **Widget key here**;
   
6. }

記載内容例(Haproxy)

1. frontend example-com-https
   
2.  acl surfly_session_continuation hdr(host) -i example.com path_beg /surfly_cookie_transfer/
   
3.  use_backend surfly_continuation_point_https if surfly_session_continuation
   
4.  ...your custom configuration here...
   
5. 
   
6. backend surfly_continuation_point_https
7.   https://example.com
   
8.  http-request set-header X-Widget-Key **Widget key here**
   
9.  http-request set-header Host surfly.jp
   
10.  server surfly surfly.jp:443 ssl

記載内容例(Apache)

1. SSLProxyEngine On
   
2. 
   
3. <Location "/surfly_cookie_transfer/">
   
4.  RequestHeader set X-Continuation-Origin "  https://example.com"
   
5.  RequestHeader set X-Widget-Key "**Widget key here**"
   
6.  ProxyPass "  https://surfly.jp/surfly_cookie_transfer/"
   
7. </Location>
   
8. 
   
9. ※お使いのサーバーで以下のモジュールが稼働していることをご確認ください。
   
10. mod_ssl / mod_proxy / mod_proxy_http / mod_headers

プロキシパスの追加後、Webサイトのドメイン名の最後に /surfly_cookie_transfer/ を付けたURLへアクセスします。継続ポイントが正しく設定され、Surflyサーバーへのプロキシが行えている場合はステータス画面が確認できます。ステータス画面ではセッション継続ポイントが正しく機能しているか確認ができます。設定が正しく行えていない項目は赤く表示され、右のはてなマークから詳細を見ることができます。

カスタム継続ポイントについて

上記の記載例が利用できない場合、サーバーサイド・スクリプトの編集など別の方法でセッション継続ポイントを実装することもできます。継続ポイントの設定に必要な条件は以下になります。

1. /surfly_cookie_transfer/ のパスで始まるすべてのHTTP(S)リクエストをSurflyサーバーへ転送すること
2. 以下のリクエストヘッダーを必ず含んでいること
   
1. X-Widget-Key: インテグレーション設定に記載された Widget Key の値。
   
2. X-Continuation-Origin: Webサイトのドメイン名（:ポート番号）。継続ポイントが  https://example.com/surfly_cookie_transfer/  の場合、  https://example.com  がこれに該当します。

ダッシュボードでの設定

セッション継続ポイントの設定後、ダッシュボードのオプションを設定します。

1. Surflyへ  ログイン  します。
   
2. メニューから [設定] を選択します。
   
3. タブメニューから [オプション] – [セッション機能] を選択します。
   
4. HttpOnly属性を持つCookieを暗号化する場合は [encrypt_httponly_cookies:]の設定にチェックを入れます。
5. [cookie_transfer_enabled:] の設定にチェックを入れます。
   
6. [cookie_transfer_proxying:] の設定にチェックを入れます。
   
7. [cookie_transfer_urls:] に設定したセッション継続ポイントのURLを指定します。
   例：[“  https://yourdomain.com/surfly_cookie_transfer/”]
   
   
8. [cookie_transfer_scopes:] に元のWebサイトから転送を行う（セッション継続ポイントからセッション内へ引き継ぐ）Cookieを指定します。
   例：[{“path”: “/”, “domain”: “yourdomain.com”, “name”: “cookie_name1”, “httponly”: true}, {“path”: “/”, “domain”: “yourdomain.com”, “name”: “cookie_name2”, “httponly”: false}]
   
   
9. [保存]を選択します。
   

ステータス画面を確認して以下のように表示されていれば、正しく設定が完了しています。

1. Surflyへ  ログイン  します。
   
2. タブメニューから[オプション]-[セッション機能]を開き、[s3_access_key:][s3_access_secret:][s3_endpoint_url:]に情報を入力します。
3. [s3_screenshots_bucket:] にAWS S3で作成したログ保存先のバケットを指定します。
   
4. ペン描画時にのみスクリーンショットを取得したい場合は[screenshots_on_annotation:]を有効にしてください。
   
5. 一定間隔で自動でスクリーンショットを取得したい場合は[automatic_screenshots_enabled:]を有効にしてください。スクリーンショットの取得間隔は15秒おきとなっています。取得間隔を変更したい場合は、[screenshot_interval:]の設定値を変更してください。指定間隔が短すぎるとセッションの品質が低下する場合があるのでご注意ください。
   ※[screenshots_on_annotation:]と[automatic_screenshots_enabled:]の両方のオプションを有効にして利用することも可能です。
   
6. 必要に応じて、[screenshot_image_size:]で取得するスクリーンショットの画像の横幅を変更してください。
   ※実際に取得できる画像の横幅の大きさは多少前後します。
   ※本オプションで設定できる設定は画像の横幅の最大値となります。ブラウザの横幅が設定値に満たない場合、スクリーンショット画像の横幅は小さくなります。お使いのブラウザの横幅がわからない場合には、操作パネルの「画面サイズを設定する」アイコンを選択することで、ブラウザのサイズが確認可能です。
7. [use_webrtc_for_screenshots:]を 必ず 有効にしてください。
   

23. [document_editor_enabled:]