Перейти до основного вмісту

Плитка: зовнішнє вбудовування (`externalEmbed`)

ПолеЗначення
Ідентифікатор плиткиexternalEmbed
Назва на панелі керуванняExternal embed / Вбудовування
Категоріяbasic
Розміриembedded

Плитка зовнішнього вбудовування відображає інструмент бронювання або іншу сторінку стороннього постачальника безпосередньо в опублікованому вебзастосунку. Встановлені застосунки для iOS та Android відображають той самий обмежений iframe у своєму Capacitor WebView.

Прийнятні вхідні дані​

Панель керування приймає один із таких варіантів:

  • Загальнодоступна HTTPS-адреса.
  • Розмітка, що містить один iframe з одним атрибутом src у лапках.

Зберігається лише нормалізована URL-адреса iframe. Scoutello ігнорує ширину, висоту, стилі, дозволи, налаштування sandbox, обробники подій, скрипти та всю іншу розмітку, надану постачальником. HTTP-адреси, облікові дані, нестандартні порти, IP-адреси, локальні або внутрішні хости, хости під керуванням Scoutello та некоректний код iframe відхиляються. Scoutello не завантажує, не визначає, не створює знімки екрана й іншим чином не перевіряє надану URL-адресу.

На панелі керування відображається попередній перегляд локальної конфігурації, який навмисно не встановлює з’єднання з постачальником. Перевіряйте фактичний результат в опублікованому вебзастосунку.

Завантаження, конфіденційність і дозволи​

Iframe завантажується автоматично та з відкладеним завантаженням, коли наближається до видимої області. Це може встановити з’єднання зі стороннім постачальником ще до взаємодії відвідувача з плиткою. Вбудованого сценарію «натисніть, щоб завантажити» або процесу керування згодою немає.

Перед збереженням організація має підтвердити, що постачальнику довіряють, а всі необхідні повідомлення про конфіденційність і процеси отримання згоди опрацьовано. Це підтвердження фіксує рішення під час налаштування, а не згоду відвідувача.

Висоту на мобільних і настільних пристроях можна встановити від 240 до 1 600 пікселів. Значення за замовчуванням становлять 640 пікселів для мобільних пристроїв і 720 пікселів для настільних. Можливості браузера для платежів і повноекранного режиму є необов’язковими та за замовчуванням вимкнені. Доступ до камери, мікрофона, геолокації, буфера обміну, завантажень і навігації верхнього рівня ніколи не надається.

Середовище виконання використовує налаштування sandbox і політики реферера, визначені кодом. Надані клієнтом токени sandbox або дозволів ніколи не потрапляють до відображеного iframe. Докладніше про семантику sandbox у браузерах див. у специфікації iframe WHATWG.

Обмеження вбудовування​

Постачальники можуть заборонити вбудовування за допомогою директиви Content Security Policy frame-ancestors або заголовка X-Frame-Options. Оскільки браузери не надають надійних відомостей про помилки міждоменного вбудовування, Scoutello не може перевірити сумісність на панелі керування або завжди відрізнити відмову постачальника від порожньої сторінки постачальника.

Якщо збережена конфігурація стає недійсною, для гостя відображається безпечний локалізований стан помилки та, якщо можливо, варіант відкриття зовнішньої сторінки.

Постачальники, яким потрібні скрипти​

Довільні скрипти постачальника не можуть виконуватися на сторінці Scoutello. Надсилання лише скрипту блокується, натомість пропонується варіант Запросити інтеграцію постачальника. У запиті вказуються назва постачальника, загальнодоступна URL-адреса документації, передбачений сценарій використання та приклад скрипту. Перед надсиланням видаліть секрети, приватні облікові дані й персональні дані.

Приклад скрипту зберігається лише як звичайний текст запиту до служби підтримки й ніколи не відображається та не виконується. Схвалення не активує цей фрагмент. Натомість воно створює завдання для продукту: розробити перевірений адаптер постачальника, розміщений у документі із sandbox в окремому походженні, яке можна реєструвати окремо, без використання cookie, із політикою Content Security Policy для конкретного постачальника та обміном повідомленнями з перевіркою походження. Це відповідає рекомендаціям OWASP щодо стороннього JavaScript.

Контрольний список підтримки​

  • Переконайтеся, що адреса є загальнодоступною HTTPS-адресою та належить потрібному постачальнику.
  • Переконайтеся, що постачальник дозволяє вбудовування iframe в опублікованому походженні.
  • Увімкніть платежі або повноекранний режим лише тоді, коли цього вимагає документація постачальника.
  • Перевірте повідомлення про конфіденційність і поведінку згоди перед публікацією.
  • Для віджетів, яким потрібні лише скрипти, використовуйте запит на інтеграцію постачальника; ніколи не вставляйте секрети.