12 サイトと内部サイトの設定
12.1 目標
サイトと内部サイトの設定ページにおける一般的なオプションを理解し、ブラウザエミュレーション、プロキシ、タイムゾーン、WebRTC、URL暗号化、ウォーターマーク、機密コンテンツ非表示、URLブロッキング、ページコントロール非表示/削除、スクリプト設定をいつ有効にするかを知る。
この章は管理者向けです。設定の入り口は通常、サイト一覧または内部サイト一覧にあります:ターゲットサイトを見つけ、設定ボタンをクリックします。
サイト管理 > サイト一覧 > 設定
サイト管理 > 内部サイト一覧 > 設定
サイト設定と内部サイト設定は類似したコア機能を提供します。内部サイト設定は通常、ERP、CRM、受注システム、データバックエンド、その他のエンタープライズイントラネットシステムで使用されます。サイト設定は通常、SaaSサイト、外部ビジネスサイト、統合制御が必要なWebエントリで使用されます。
この章はアクセス動作とセキュリティポリシー設定を扱い、サイト追加の基本操作は扱いません。基本的な内部サイトフローについては第6章、権限割り当てについては第7章を参照してください。
12.2 設定オブジェクトの違い
Sa2webで混同しやすい設定オブジェクトは3つの主要カテゴリに分類されます:
| 設定オブジェクト | エントリ | 範囲 |
|---|---|---|
| ブラウザインスタンス設定 | ブラウザ管理 > ブラウザ一覧 > 設定 | ブラウザインスタンスのカーネル、ブランド、システム、起動パラメータ、キャッシュ、ハードウェア関連動作に影響 |
| サイト設定 | サイト管理 > サイト一覧 > 設定 | ユーザーがSaaSまたは外部サイトにアクセスする際のアクセス動作に影響 |
| 内部サイト設定 | サイト管理 > 内部サイト一覧 > 設定 | ユーザーが内部システムにアクセスする際のアクセス動作に影響 |
理解しやすい考え方:
- ブラウザインスタンス設定は、どのブラウザ環境がページを実行するかを決定。
- サイトと内部サイト設定は、そのサイトへのアクセスをどう制御するかを決定。
- グループ権限は、どのユーザーがこれらのエントリを見て使用できるかを決定。
12.3 ブラウザインスタンス設定
ブラウザインスタンス設定は主にブラウザ一覧の設定ページから来ます。特定のURLのためではなく、特定のリモートブラウザインスタンスに適用されます。
| 設定 | 目的 | 推奨事項 |
|---|---|---|
| カーネルバージョン | 実際に動作するChromiumカーネルを選択 | 組み込みの検証済みバージョンを推奨 |
| オペレーティングシステム | ブラウザ環境が提示するシステムタイプを設定 | ターゲットサイトのリスク制御戦略と一貫性を保つ |
| ブランド | Chrome、Edge、Opera、Vivaldiなどのブラウザブランド | 通常はChromeまたはビジネスで要求されるブランドを選択 |
| ブランドバージョン | 対応するブランドバージョンを選択 | カーネルバージョンとターゲットサイト互換性に合わせる |
| モバイルモデル | モバイルデバイスをエミュレート | ターゲットサイトがモバイルレイアウトを必要とする場合のみ有効化 |
| タイムゾーン | ブラウザ環境のタイムゾーンを設定 | ビジネスアカウントの地域に合わせる |
高度な設定では起動パラメータとChromeランタイム設定も調整可能。
12.3.1 起動パラメータ
起動パラメータはブラウザ起動時に使用されるパラメータセットに書き込まれます。一般的なデフォルトには以下が含まれます:
| パラメータ | 目的 |
|---|---|
disable-gpu |
GPUを無効化、サーバー上での互換性フォールバックとして有用 |
no-sandbox |
コンテナ環境での一般的なChromiumランタイムパラメータ |
ignore-certificate-errors |
証明書エラーを無視、テストや自己署名証明書環境に適している |
lang |
ブラウザ言語を指定、例:en-US |
autoplay-policy |
メディア自動再生ポリシーを制御 |
起動パラメータはブラウザの安定性とセキュリティ境界に影響します。ターゲットサイトまたはランタイム環境が明確に必要とする場合を除き、デフォルトパラメータを安易に削除したり、未知のパラメータを追加したりしないでください。
12.3.2 Chromeランタイム設定
| 設定 | 目的 |
|---|---|
| 一時ディレクトリ | ブラウザランタイム一時ファイルの場所 |
| キャッシュディレクトリ | ブラウザキャッシュファイルの場所 |
| 最大画像サイズ | 画像キャプチャまたは伝送の最大サイズを制御 |
| ハードウェア番号 | ブラウザ環境を区別するためのハードウェア識別子;数字のみ |
| ハードウェアアクセラレーション | ハードウェアアクセラレーションが有効かどうか |
| 起動時にユーザーデータをクリア | ブラウザ起動時に毎回ブラウザユーザーデータをクリア |
ターゲットサイトがログイン状態やローカルキャッシュに強く依存する場合、起動時にユーザーデータをクリア を軽々しく有効化しないでください。ワンタイムセッションとクリーンな環境を重視する場合は有効化できます。
12.4 基本設定
サイトと内部サイト設定ページの基本設定は、アクセス時のブラウザ表示、セキュリティウォーターマーク、ユーザーに見える情報を制御します。
| 設定 | 目的 | 一般的なシナリオ |
|---|---|---|
| エミュレータを有効化 | ブラウザブランドまたはモバイルデバイスエミュレーションを有効化 | ターゲットサイトがブラウザまたはデバイスタイプによって異なるページを表示 |
| ブラウザブランドをエミュレート | Chrome、Edge、Opera、Vivaldiをエミュレート | サイト互換性やビジネス要件で固定ブラウザブランドが必要 |
| モバイルデバイスモデル | 電話モデルをエミュレート | モバイル管理ポータル、H5ページ、モバイル限定機能 |
| アカウント名を非表示 | フロントエンドでのアカウント名露出を防止 | マルチアカウント共有、契約業者アクセス、カスタマーサポート支援操作 |
| URL暗号化 | 実際のオリジンURLを直接表示しない | 内部システム、サプライヤーポータル、機密性の高いSaaSや外部サイト |
| 可視ウォーターマーク | ページ上の可視ウォーターマーク | 訪問者へのリマインダーとトレーサビリティ |
| 不可視ウォーターマーク | 隠れたウォーターマーク | スクリーンショット拡散後のトレーサビリティ |
| コピー無効化 | ページコンテンツのコピーを制限 | 顧客情報、受注データ、契約内容 |
| 印刷無効化 | 印刷を制限 | 紙やPDFへの一括エクスポート防止 |
| 編集無効化 | 編集操作を制限 | 読み取り専用レビューと監査アクセス |
最小必要原則に従ってセキュリティ設定を有効化してください。例えば、実際のアドレス露出を防ぎたいだけなら、まずURL暗号化を有効化。スクリーンショット共有も懸念ならウォーターマーク追加。コンテンツ自体が機密ならコピー、印刷、編集無効化を検討。
12.5 プロキシ設定
プロキシ設定はターゲットサイトアクセス時のトラフィックの出口を決定します。
プロキシを有効化後、以下から選択可能:
| プロキシモード | 説明 |
|---|---|
direct |
直接接続 |
auto_detect |
プロキシ自動検出 |
pac_script |
PACスクリプト使用 |
fixed_servers |
固定プロキシサーバー使用 |
system |
システムプロキシ使用 |
固定プロキシサーバー形式は通常:
http://host:port
https://host:port
socks5://host:port
以下も設定可能:
| 設定 | 説明 |
|---|---|
| PACスクリプトURL | pac_script モードで使用 |
| プロキシバイパスリスト | 例:<local>,<loopback>,192.168.0.0/16,172.16.0.0/12,10.0.0.0/8 |
| プロキシユーザー名 | プロキシが認証を必要とする場合に入力 |
| プロキシパスワード | プロキシが認証を必要とする場合に入力 |
内部サイトは通常パブリックインターネットプロキシを必要としません。ブラウザノードからイントラネットシステムへのルート到達性により依存します。外部SaaSサイトは特定のエグレスIPが必要な場合、固定プロキシが必要になることがあります。
12.6 タイムゾーン設定
タイムゾーンはターゲットサイトが見るブラウザ時間環境に影響し、一部のサイトでは時間表示とデフォルトビジネスデータ範囲にも影響する可能性があります。
推奨事項:
- プロキシを使用しない場合、企業所在地のタイムゾーンを使用。
- プロキシを使用する場合、プロキシIP地域のタイムゾーンを使用。
12.7 WebRTC設定
サイト設定には2種類のWebRTC関連オプションが含まれます:
| 設定 | 目的 |
|---|---|
| ページ上のWebRTC通信を無効化 | ページが直接WebRTC通信を使用するのをブロック |
| WebRTCアドレスホワイトリスト | WebRTC無効時の特定アドレス例外を許可 |
| WebRTCを有効化 | Sa2web表示または通信関連機能を制御する高度な設定 |
ターゲットサイトが音声/ビデオ、リアルタイム通信、ブラウザWebRTC機能を必要としない場合、ページWebRTCを無効化すると実際のネットワーク環境の露出を減らせます。ターゲットサイト自体がWebRTCに依存する場合(ビデオ会議、オンラインカスタマーサービス、リアルタイム音声/ビデオバックエンドなど)、WebRTCを無効化しないでください。代わりに、分離ネットワークを持つブラウザインスタンス内でターゲットサイトを使用してください。
12.8 機密コンテンツとURL制御
サイトと内部サイト設定は3つの直接制御機能を提供します。
| 設定 | 目的 | 例 |
|---|---|---|
| 機密語句を非表示 | ページ上に表示される機密テキストを非表示 | 顧客電話番号、トークン、サプライヤー名 |
| URLブロックリスト | 一致するURLへのアクセスをブロック | エクスポートAPI、危険な管理パス |
| サードパーティサイト | アクセス中にリダイレクトされる可能性のあるサードパーティアドレスを許可/関連付け | ログインページ、SSO、決済、チケットドメイン |
機密語句非表示は複数行追加をサポート、1行に1機密語句。URLブロッキングはエクスポート、ダウンロード、一括削除、システム設定などの高リスクパスから開始すべきです。
機密語句非表示とコントロール非表示はページレイヤーの制御であり、バックエンド権限を置き換えるものではありません。高リスク操作はターゲットシステム自体で無効化または承認ゲートを設けるべきです。
12.9 高度なアクセス制御
高度な設定はウィンドウ、ダウンロード、ペースト動作、画面伝送、URL変更イベントを制御します。
| 設定 | デフォルト傾向 | 説明 |
|---|---|---|
| 新しいウィンドウプロンプト | 有効 | ターゲットサイトが新しいウィンドウを開くときユーザーにプロンプト |
| 新しいウィンドウタイムアウト | 20000 ms |
新しいウィンドウ作成または応答の待機時間 |
| 最大ウィンドウ数 | 3 |
同時に開かれるウィンドウ数を制限 |
| ダウンロード制限 | 有効 | リモートページからのファイルダウンロードを制御 |
| 最大アップロードサイズ | 2147483648 バイト |
アップロードファイルサイズを制御 |
| 最大ペーストテキスト長 | 2097152 |
1回の操作でのペーストテキストサイズを制御 |
| 最大ペーストファイル長 | 20971520 |
ペーストファイルサイズを制御 |
| Canvas伝送方式 | richcolor |
画面伝送モードを制御 |
| Canvas間隔 | 0 ms |
非WebRTC伝送モードのリフレッシュ間隔 |
| 最大Canvas幅/高さ | 伝送モードに依存 | 画面伝送サイズを制限 |
| URL変更イベント | 有効 | スクリプトやポリシーのためにページURL変更を監視 |
機密性の高い内部システムでは、まずダウンロードを制限し最大ウィンドウ数を制御し、その後ビジネスニーズに基づいてアップロードとペーストサイズを緩和。グラフィック重視のシステムではCanvas伝送方式と画質のテストに注力。
12.10 リクエストとレスポンスヘッダー
リクエストヘッダーとレスポンスヘッダー設定は、スクリプトで読み取りまたは処理が必要なヘッダー名を指定します。
一般的な用途:
- リクエストヘッダーでテナント、環境、アカウントを特定。
- レスポンスヘッダーでインターフェース戻り値タイプを決定。
- ページスクリプトやインターフェーススクリプトにコンテキスト提供。
- 異なるゲートウェイ、SSOシステム、CDNの背後にあるターゲットサイト動作をデバッグ。
ここにはヘッダー名のみを記入し、完全なリクエスト/レスポンス内容は記入しません。
12.11 ページ削除とページ非表示コントロール
ページコントロールルールは2種類に分類されます:
| 種類 | 効果 |
|---|---|
| ページ削除コントロール | 一致するURLとXPath/CSSセレクタに従ってページから要素を削除 |
| ページ非表示コントロール | 一致するURLとXPath/CSSセレクタに従って要素を非表示 |
各ルールには以下が含まれます:
| フィールド | 説明 |
|---|---|
| 一致URL | * はすべてのページを意味。一致URLルールは セクション 12.14 参照 |
| セレクタ | XPath/CSSセレクタ。複数追加可能。セレクタルールは セクション 12.15 参照 |
一般的な用途:
- エクスポート、ダウンロード、削除、システム設定 などのボタンを削除。
- 価格、コスト、顧客プライバシーフィールドを非表示。
- 特定URLページの高リスクエリアを非表示。
- 契約業者、一時従業員、コラボレーションユーザー向けに簡易インターフェース提供。
セレクタはターゲットサイト変更後に無効になる可能性があります。ターゲットシステムアップグレードごとにこれらのルールを再テストしてください。
12.12 スクリプト設定
スクリプト設定はページ動作、複雑なログイン、インターフェースレスポンス、ページ拡張の処理に適しています。
各スクリプトには以下が含まれます:
| フィールド | 説明 |
|---|---|
| スクリプト名 | 管理者がスクリプトを識別するのに役立つ |
| 一致URL | スクリプトが効果を発揮するURL範囲。セクション 12.14 参照 |
| ページスクリプト | ページ環境で実行。DOM操作、ボタン処理、フォーム支援、ページ拡張に適している |
| SSEスクリプト | サーバー送信イベントストリームを処理 |
| セレクタ | ページスクリプトはセレクタを組み合わせて要素を正確に特定可能。セクション 12.15 参照 |
| JavaScriptコード | 実行するスクリプト内容。スクリプト作成は チャプター 13 参照 |
本番グループに認可する前に、テストサイトまたはテストアカウントでスクリプトをテストしてください。スクリプトエラーはページを使用不能にする可能性があるため、各スクリプトは明確な名前と最も狭い実用的な一致範囲を持つべきです。
12.13 推奨設定組み合わせ
さまざまなシナリオで以下の組み合わせから開始:
| シナリオ | 推奨設定 |
|---|---|
| 内部ERP/CRMへの読み取り専用アクセス | URL暗号化、可視ウォーターマーク、ダウンロード制限、コピー無効化、機密語句非表示 |
| 契約業者の顧客バックエンドアクセス | アカウント名非表示、URL暗号化、可視ウォーターマーク、不可視ウォーターマーク、ページ削除コントロール、録画とリプレイ |
| SaaSマルチアカウント使用 | 固定プロキシ、タイムゾーン、ブラウザブランド、モバイルデバイスモデル、アカウント名非表示 |
| 高リスク管理バックエンド | URLブロックリスト、ページ削除コントロール、ダウンロード制限、スクリプト監査 |
| AI / MCPアクセス | URL暗号化、機密語句非表示、高リスクURLブロック、ページ非表示コントロール、最小グループ認可 |
12.14 一致URLルール
値が * の場合、すべてのURLが一致。その他のルール:
regex:で始まる場合、以降の内容を正規表現としてURL一致に使用。例:regex:https\:\/\/www.sa2web.com\/.+extract:で始まる場合、URLを完全一致で一致。例:extract:https://www.sa2web.comscript:で始まる場合、JavaScript式を使用してURL一致。スクリプトにurlという変数があり、スクリプト結果がtrueの場合に一致。例:script:url.endsWith('pricing')- 上記の条件がいずれも適用されない場合、URLをプレフィックスで一致。例:
https://www.sa2web.com/my
12.15 XPath/CSSセレクタ
このチュートリアルで言及されるXPath/CSSセレクタは、渡すパラメータを減らすために設計された統一セレクタ形式です。通常のセレクタを以下のルールで拡張:
形式:
(xpath:)?<xpath/css selector><:p<number>>?
xpath: で始まる場合はXPathルール。それ以外はCSSセレクタ。オプションの :p<number> 部分はターゲット要素からその数の祖先レベル分上方向に検索することを意味。
例:
// xpathセレクタ
xpath://body[contains(text(),sa2web)]:p1
// cssセレクタ
.article
.article:p1
12.16 設定フロー推奨
- ターゲットサイトが正常に開くことを確認。
- プロキシ、タイムゾーン、ブラウザエミュレーションなどのアクセス環境設定を構成。
- URL暗号化、ウォーターマーク、アカウント名非表示などの表示ポリシーを有効化。
- 機密語句、URLブロッキング、ページコントロール、スクリプトを追加。
- テストユーザーまたはテストAgentでフロントエンド経由で検証。
- 確認後、本番グループを認可。