タイル: 外部埋め込み (`externalEmbed`)
| フィールド | 値 |
|---|---|
| タイル識別子 | externalEmbed |
| ダッシュボード表示名 | External embed / Einbettung |
| カテゴリー | basic |
| サイズ | embedded |
外部埋め込みタイルは、公開済みのウェブアプリ内に予約ツールなどのサードパーティ製ページを直接表示します。インストール済みの iOS および Android アプリでは、同じ制限付き iframe を Capacitor WebView 内に表示します。
受け付ける入力
ダッシュボードでは、次のいずれかを指定できます。
- 公開 HTTPS URL
- 引用符で囲まれた
src属性を 1 つ持つ iframe を含むマークアップ
正規化された iframe URL のみが保存されます。Scoutello は、プロバイダーから提供された幅、高さ、スタイル、権限、sandbox 設定、イベントハンドラー、スクリプト、および周囲のマークアップをすべて無視します。HTTP アドレス、認証情報、カスタムポート、IP アドレス、ローカルまたは内部ホスト、Scoutello が管理するホスト、形式が正しくない iframe コードは拒否されます。Scoutello は、送信された URL を取得、名前解決、スクリーンショット撮影、その他の方法で検査することはありません。
ダッシュボードにはローカル設定プレビューが表示され、プロバイダーには意図的に接続しません。実際の結果は、公開済みのウェブアプリで確認してください。
読み込み、プライバシー、権限
iframe は自動的かつ遅延読み込みされ、表示領域に近づくと読み込まれます。そのため、訪問者がタイルを操作する前にサードパーティプロバイダーへ接続する場合があります。組み込みの訪問者向けクリック読み込み機能や同意管理フローはありません。
保存する前に、組織はプロバイダーが信頼できること、および必要なプライバシー通知や同意処理が対応済みであることを確認する必要があります。この確認は作成者による判断を記録するものであり、訪問者の同意ではありません。
モバイルとデスクトップの高さは 240~1,600 ピクセルに設定できます。デフォルトは、モバイルが 640 ピクセル、デスクトップが 720 ピクセルです。決済機能とフルスクリーンのブラウザー機能は任意で、デフォルトでは無効になっています。カメラ、マイク、位置情報、クリップボード、ダウンロード、トップレベルナビゲーションが許可されることはありません。
ランタイムでは、コードで管理された sandbox とリファラーポリシーの設定を使用します。顧客が指定した sandbox や権限トークンが、レンダリングされた iframe に渡ることはありません。ブラウザーの sandbox の動作については、WHATWG iframe 仕様を参照してください。
フレーム化の制限
プロバイダーは、Content Security Policy の frame-ancestors ディレクティブまたは X-Frame-Options ヘッダーによって埋め込みを禁止できます。ブラウザーはクロスオリジンのフレーム化失敗に関する詳細を確実に公開しないため、Scoutello はダッシュボードで互換性を確認できず、プロバイダーによる拒否とプロバイダー側の空のページを常に区別できるとは限りません。
保存済みの設定が無効になった場合、ゲスト向け画面には安全なローカライズ済みエラー状態が表示され、可能な場合は外部で開くための代替手段も表示されます。
スクリプトを必要とするプロバイダー
任意のプロバイダースクリプトを Scoutello のページ上で実行することはできません。スクリプトのみの入力はブロックされ、代わりに プロバイダー連携をリクエスト が表示されます。リクエストでは、プロバイダー名、公開ドキュメント URL、想定用途、スクリプトサンプルを収集します。送信前に、シークレット、非公開の認証情報、個人データを削除してください。
スクリプトサンプルはサポートリクエストのプレーンテキストとしてのみ保存され、表示または実行されることはありません。承認によって、そのスニペットが有効になることもありません。承認後は、cookieless で個別に登録可能なオリジン上の sandbox 化されたドキュメントにホストされ、プロバイダー固有の Content Security Policy とオリジン検証済みメッセージングを使用する、審査済みプロバイダーアダプターの開発作業が開始されます。これは OWASP のサードパーティ JavaScript ガイダンスに準拠しています。
サポートチェックリスト
- アドレスが公開 HTTPS であり、意図したプロバイダーに属していることを確認します。
- 公開済みのオリジンで、プロバイダーが iframe 埋め込みを許可していることを確認します。
- プロバイダーのドキュメントで必要とされている場合に限り、決済機能またはフルスクリーンを有効にします。
- 公開前に、プライバシー通知と同意の動作を確認します。
- スクリプトのみのウィジェットにはプロバイダー連携リクエストを使用し、シークレットは決して貼り付けないでください。