Csempe: Külső beágyazás (`externalEmbed`)
| Mező | Érték |
|---|---|
| Csempeazonosító | externalEmbed |
| Irányítópulton megjelenő címke | Külső beágyazás / Einbettung |
| Kategória | basic |
| Méret | embedded |
A külső beágyazási csempe egy foglalási eszközt vagy más külső szolgáltató oldalát közvetlenül jeleníti meg a közzétett webalkalmazásban. A telepített iOS- és Android-alkalmazások ugyanazt a korlátozott iframe-et jelenítik meg a Capacitor WebView-ban.
Elfogadott bemenet
Az irányítópult az alábbiak egyikét fogadja el:
- Nyilvános HTTPS-URL.
- Egy iframe-et és egy idézőjelek közé zárt
srcattribútumot tartalmazó jelölőkód.
Csak a normalizált iframe-URL kerül tárolásra. A Scoutello figyelmen kívül hagyja a szélességet, magasságot, stílusokat, engedélyeket, sandbox-beállításokat, eseménykezelőket, szkripteket, valamint a szolgáltató által megadott összes környező jelölőkódot. A rendszer elutasítja a HTTP-címeket, a hitelesítési adatokat, az egyéni portokat, az IP-címeket, a helyi vagy belső gazdagépeket, a Scoutello által kezelt gazdagépeket és a hibás iframe-kódot. A Scoutello nem tölti le, nem oldja fel, nem készít képernyőképet, és más módon sem vizsgálja a megadott URL-t.
Az irányítópult helyi konfigurációs előnézetet jelenít meg, és szándékosan nem lép kapcsolatba a szolgáltatóval. A tényleges eredményt a közzétett webalkalmazásban kell tesztelni.
Betöltés, adatvédelem és engedélyek
Az iframe automatikusan és késleltetve töltődik be, amikor közeledik a látható területhez. Ez azt jelenti, hogy a látogató a csempével való interakciója előtt kapcsolat jöhet létre a külső szolgáltatóval. Nincs beépített, látogatók által indítható kattintásos betöltés vagy hozzájáruláskezelő folyamat.
Mentés előtt a szervezetnek nyilatkoznia kell arról, hogy megbízik a szolgáltatóban, valamint hogy a szükséges adatvédelmi tájékoztatásról és hozzájáruláskezelésről gondoskodott. Ez a nyilatkozat a konfiguráló döntését rögzíti, nem minősül a látogató hozzájárulásának.
A mobil- és asztali magasság 240 és 1600 képpont között állítható be. Az alapértelmezett érték mobilon 640, asztali nézetben pedig 720 képpont. A fizetési és teljes képernyős böngészőfunkciók opcionálisak, és alapértelmezés szerint ki vannak kapcsolva. A kamera, a mikrofon, a helymeghatározás, a vágólap, a letöltések és a legfelső szintű navigáció soha nem kap engedélyt.
A futtatókörnyezet által használt sandbox- és hivatkozóházirend-beállításokat a kód határozza meg. Az ügyfél által megadott sandbox- vagy engedélytokenek soha nem jutnak el a megjelenített iframe-be. A böngészők sandbox-szemantikájáról lásd a WHATWG iframe-specifikációt.
A beágyazás korlátai
A szolgáltatók megtilthatják a beágyazást Content Security Policy frame-ancestors direktívával vagy X-Frame-Options fejléccel. Mivel a böngészők nem teszik közzé megbízhatóan a webhelyek közötti keretezési hibák részleteit, a Scoutello nem tudja ellenőrizni a kompatibilitást az irányítópulton, és nem mindig tud különbséget tenni a szolgáltató elutasítása és a szolgáltató üres oldala között.
Ha egy mentett konfiguráció érvénytelenné válik, a vendégfelület biztonságos, lokalizált hibaállapotot jelenít meg, és lehetőség szerint külső megnyitási lehetőséget kínál.
Szkripteket igénylő szolgáltatók
Tetszőleges szolgáltatói szkriptek nem futtathatók Scoutello-oldalon. A kizárólag szkriptet tartalmazó beküldést a rendszer blokkolja, és helyette felajánlja a Szolgáltatói integráció kérése lehetőséget. A kérés bekéri a szolgáltató nevét, a nyilvános dokumentáció URL-jét, a tervezett felhasználási esetet és egy szkriptmintát. Beküldés előtt távolítsa el a titkokat, a bizalmas hitelesítési adatokat és a személyes adatokat.
A szkriptminta kizárólag egyszerű szövegként, támogatási kérés részeként kerül tárolásra, és soha nem jelenik meg, illetve nem fut le. A jóváhagyás nem teszi futtathatóvá ezt a kódrészletet. Ehelyett olyan termékfejlesztési feladatot hoz létre, amelynek eredménye egy ellenőrzött szolgáltatói adapter lesz. Ez az adapter sandboxolt dokumentumban, cookie-k nélküli, külön regisztrálható originen, szolgáltatóspecifikus Content Security Policy-vel és origint ellenőrző üzenetkezeléssel fut. A megoldás követi az OWASP harmadik féltől származó JavaScriptre vonatkozó útmutatását.
Támogatási ellenőrzőlista
- Ellenőrizze, hogy a cím nyilvános HTTPS-cím, és a kívánt szolgáltatóhoz tartozik.
- Ellenőrizze, hogy a szolgáltató engedélyezi az iframe-es beágyazást a közzétett originen.
- A fizetést vagy a teljes képernyőt csak akkor engedélyezze, ha a szolgáltató dokumentációja ezt előírja.
- Közzététel előtt tekintse át az adatvédelmi tájékoztatást és a hozzájáruláskezelés működését.
- Kizárólag szkripten alapuló widgetekhez használja a szolgáltatói integrációs kérést; soha ne illesszen be titkos adatokat.