Перейти к основному содержимому

Плитка: внешнее встраивание (`externalEmbed`)

ПолеЗначение
Идентификатор плиткиexternalEmbed
Название на панели управленияВнешнее встраивание / Einbettung
Категорияbasic
Размерыembedded

Плитка внешнего встраивания отображает инструмент бронирования или другую страницу стороннего сервиса непосредственно в опубликованном веб-приложении. Установленные приложения для iOS и Android отображают тот же ограниченный iframe внутри Capacitor WebView.

Принимаемые данные​

Панель управления принимает один из следующих вариантов:

  • Общедоступный URL с 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-ограничениями на источнике без cookies, который можно регистрировать отдельно, с отдельной Content Security Policy для провайдера и проверкой источника сообщений. Это соответствует рекомендациям OWASP по стороннему JavaScript.

Контрольный список для службы поддержки​

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