Dlaždice: Externí vložení (`externalEmbed`)
| Pole | Hodnota |
|---|---|
| Identifikátor dlaždice | externalEmbed |
| Popisek na nástěnce | Externí vložení / Einbettung |
| Kategorie | basic |
| Velikosti | embedded |
Dlaždice externího vložení zobrazuje rezervační nástroj nebo jinou stránku třetí strany přímo v publikované webové aplikaci. Nainstalované aplikace pro iOS a Android vykreslují stejný omezený iframe ve svém Capacitor WebView.
Přijímané vstupy
Nástěnka přijímá jednu z těchto možností:
- Veřejnou HTTPS adresu URL.
- Kód obsahující jeden iframe s jedním atributem
srcv uvozovkách.
Ukládá se pouze normalizovaná adresa URL iframe. Scoutello ignoruje šířku, výšku, styly, oprávnění, nastavení sandboxu, obslužné rutiny událostí, skripty i veškerý okolní kód dodaný poskytovatelem. HTTP adresy, přihlašovací údaje, vlastní porty, IP adresy, lokální či interní hostitelé, hostitelé spravovaní službou Scoutello a neplatný kód iframe jsou odmítnuty. Scoutello zadanou adresu URL nenačítá, nepřevádí, nepořizuje její snímek ani ji jinak neprověřuje.
Nástěnka zobrazuje místní náhled konfigurace a záměrně nekontaktuje poskytovatele. Skutečný výsledek otestujte v publikované webové aplikaci.
Načítání, ochrana soukromí a oprávnění
Iframe se načítá automaticky a odloženě, jakmile se přiblíží k viditelné oblasti. Ještě před interakcí návštěvníka s dlaždicí tak může dojít ke kontaktování poskytovatele třetí strany. Vestavěná možnost načtení po kliknutí návštěvníka ani proces správce souhlasu nejsou k dispozici.
Před uložením musí organizace potvrdit, že poskytovateli důvěřuje a že byly vyřešeny všechny požadované informace o ochraně soukromí nebo zpracování souhlasů. Toto potvrzení zaznamenává rozhodnutí při tvorbě obsahu; nepředstavuje souhlas návštěvníka.
Výšku pro mobilní zařízení i počítače lze nastavit v rozmezí 240 až 1 600 pixelů. Výchozí hodnoty jsou 640 pixelů pro mobilní zařízení a 720 pixelů pro počítače. Možnosti platby a celoobrazovkového režimu prohlížeče jsou volitelné a ve výchozím nastavení vypnuté. Přístup ke kameře, mikrofonu, geolokaci, schránce, stahování ani navigaci na nejvyšší úrovni není nikdy udělen.
Runtime používá nastavení sandboxu a zásad odkazující stránky spravovaná kódem. Zákaznické tokeny sandboxu ani oprávnění se do vykreslovaného iframe nikdy nepředávají. Sémantiku sandboxu prohlížeče popisuje specifikace iframe WHATWG.
Omezení vkládání
Poskytovatelé mohou vkládání zakázat direktivou Content Security Policy frame-ancestors nebo hlavičkou X-Frame-Options. Protože prohlížeče neposkytují spolehlivé podrobnosti o selhání rámování mezi různými zdroji, Scoutello nemůže na nástěnce ověřit kompatibilitu ani vždy rozlišit odmítnutí poskytovatele od prázdné stránky poskytovatele.
Pokud uložená konfigurace přestane být platná, návštěvnické rozhraní zobrazí bezpečný lokalizovaný chybový stav a pokud možno nabídne možnost otevření externí stránky.
Poskytovatelé vyžadující skripty
Libovolné skripty poskytovatele nemohou na stránce Scoutello běžet. Odeslání obsahující pouze skript je zablokováno a místo něj se nabídne možnost Požádat o integraci poskytovatele. Požadavek shromažďuje název poskytovatele, veřejnou adresu URL dokumentace, zamýšlený případ použití a ukázku skriptu. Před odesláním odstraňte tajné údaje, soukromé přihlašovací údaje a osobní data.
Ukázka skriptu se ukládá pouze jako prostý text požadavku na podporu a nikdy se nevykresluje ani nespouští. Schválení tento úryvek nezpřístupní. Vytvoří produktovou úlohu pro prověřený adaptér poskytovatele hostovaný v dokumentu se sandboxem na bezcookieovém, samostatně registrovatelném zdroji se zásadami Content Security Policy specifickými pro poskytovatele a komunikací ověřovanou podle původu. Tento postup vychází z pokynů OWASP pro JavaScript třetích stran.
Kontrolní seznam podpory
- Ověřte, že adresa používá veřejné HTTPS a patří zamýšlenému poskytovateli.
- Ověřte, že poskytovatel povoluje vkládání iframe na publikovaném zdroji.
- Platbu nebo celoobrazovkový režim povolte pouze tehdy, pokud je poskytovatel vyžaduje v dokumentaci.
- Před publikováním zkontrolujte informace o ochraně soukromí a chování souhlasů.
- U widgetů využívajících pouze skripty použijte požadavek na integraci poskytovatele; tajné údaje nikdy nevkládejte.