Kafelek: Zewnętrzne osadzanie (`externalEmbed`)
| Pole | Wartość |
|---|---|
| Identyfikator kafelka | externalEmbed |
| Etykieta na pulpicie | External embed / Einbettung |
| Kategoria | basic |
| Rozmiary | embedded |
Kafelek zewnętrznego osadzania wyświetla narzędzie do rezerwacji lub inną stronę zewnętrznego dostawcy bezpośrednio w opublikowanej aplikacji internetowej. Zainstalowane aplikacje na iOS i Androida renderują ten sam ograniczony element iframe wewnątrz Capacitor WebView.
Akceptowane dane wejściowe
Pulpit akceptuje:
- Publiczny adres HTTPS.
- Kod zawierający jeden element iframe z jednym ujętym w cudzysłów atrybutem
src.
Zapisywany jest tylko znormalizowany adres URL elementu iframe. Scoutello ignoruje szerokość, wysokość, style, uprawnienia, ustawienia sandbox, procedury obsługi zdarzeń, skrypty i cały pozostały kod dostarczony przez dostawcę. Adresy HTTP, dane uwierzytelniające, niestandardowe porty, adresy IP, hosty lokalne i wewnętrzne, hosty kontrolowane przez Scoutello oraz nieprawidłowy kod iframe są odrzucane. Scoutello nie pobiera, nie rozwiązuje, nie wykonuje zrzutów ekranu ani w żaden inny sposób nie sprawdza przesłanego adresu URL.
Pulpit wyświetla lokalny podgląd konfiguracji i celowo nie łączy się z dostawcą. Rzeczywisty wynik należy sprawdzić w opublikowanej aplikacji internetowej.
Ładowanie, prywatność i uprawnienia
Element iframe ładuje się automatycznie i z opóźnieniem, gdy zbliża się do widocznego obszaru. Może to spowodować kontakt z zewnętrznym dostawcą, zanim osoba odwiedzająca wejdzie w interakcję z kafelkiem. Nie ma wbudowanego mechanizmu kliknięcia w celu załadowania ani obsługi zgód przez menedżer zgód.
Przed zapisaniem organizacja musi potwierdzić, że dostawca jest zaufany oraz że uwzględniono wymagane informacje dotyczące prywatności i obsługę zgód. To potwierdzenie rejestruje decyzję osoby konfigurującej; nie jest zgodą osoby odwiedzającej.
Wysokość na urządzeniach mobilnych i komputerach można ustawić w zakresie od 240 do 1600 pikseli. Wartość domyślna wynosi 640 pikseli na urządzeniach mobilnych i 720 pikseli na komputerach. Możliwości płatności i trybu pełnoekranowego przeglądarki są opcjonalne i domyślnie wyłączone. Uprawnienia do kamery, mikrofonu, geolokalizacji, schowka, pobierania i nawigacji najwyższego poziomu nigdy nie są przyznawane.
Środowisko wykonawcze korzysta z ustawień sandbox i referrer-policy zarządzanych przez kod. Dostarczone przez klienta tokeny sandbox lub uprawnień nigdy nie trafiają do renderowanego elementu iframe. Zobacz specyfikację iframe WHATWG, aby poznać zasady działania sandbox w przeglądarkach.
Ograniczenia osadzania
Dostawcy mogą uniemożliwić osadzanie za pomocą dyrektywy Content Security Policy frame-ancestors lub nagłówka X-Frame-Options. Ponieważ przeglądarki nie udostępniają wiarygodnych informacji o błędach osadzania między domenami, Scoutello nie może zweryfikować zgodności na pulpicie ani zawsze odróżnić odmowy dostawcy od pustej strony dostawcy.
Jeśli zapisana konfiguracja stanie się nieprawidłowa, interfejs dla osób odwiedzających wyświetla bezpieczny, zlokalizowany stan błędu oraz, jeśli to możliwe, opcję otwarcia strony zewnętrznej.
Dostawcy wymagający skryptów
Własne skrypty dostawcy nie mogą być uruchamiane na stronie Scoutello. Zgłoszenie zawierające wyłącznie skrypt jest blokowane i udostępnia opcję Request provider integration. Formularz zbiera nazwę dostawcy, publiczny adres URL dokumentacji, zamierzony przypadek użycia oraz próbkę skryptu. Przed przesłaniem należy usunąć sekrety, prywatne dane uwierzytelniające i dane osobowe.
Próbka skryptu jest przechowywana wyłącznie jako zwykły tekst zgłoszenia do pomocy technicznej i nigdy nie jest renderowana ani wykonywana. Zatwierdzenie nie odblokowuje tego fragmentu. Tworzy ono zadanie produktowe dotyczące zweryfikowanego adaptera dostawcy, hostowanego w dokumencie z izolacją sandbox, w pozbawionej plików cookie domenie o odrębnej możliwości rejestracji, z zasadami Content Security Policy właściwymi dla dostawcy i komunikacją sprawdzającą pochodzenie. Rozwiązanie jest zgodne z wytycznymi OWASP dotyczącymi JavaScriptu stron trzecich.
Lista kontrolna wsparcia
- Potwierdź, że adres jest publicznym adresem HTTPS i należy do właściwego dostawcy.
- Potwierdź, że dostawca zezwala na osadzanie iframe w opublikowanej domenie.
- Włącz płatności lub tryb pełnoekranowy tylko wtedy, gdy wymaga tego dokumentacja dostawcy.
- Przed publikacją sprawdź informacje dotyczące prywatności i sposób obsługi zgód.
- W przypadku widżetów działających wyłącznie ze skryptem użyj zgłoszenia integracji z dostawcą; nigdy nie wklejaj sekretów.