Dlaždica: externé vloženie (`externalEmbed`)
| Pole | Hodnota |
|---|---|
| Identifikátor dlaždice | externalEmbed |
| Označenie na dashboarde | External embed / Einbettung |
| Kategória | basic |
| Veľkosti | embedded |
Dlaždica externého vloženia zobrazuje rezervačný nástroj alebo inú stránku tretej strany priamo v publikovanej webovej aplikácii. Nainštalované aplikácie pre iOS a Android vykresľujú rovnaký obmedzený iframe vo svojom Capacitor WebView.
Akceptovaný vstup
Dashboard akceptuje jednu z týchto možností:
- Verejná HTTPS URL.
- Kód obsahujúci jeden iframe s jedným atribútom
srcv úvodzovkách.
Ukladá sa iba normalizovaná URL iframe. Scoutello ignoruje šírku, výšku, štýly, povolenia, nastavenia sandboxu, obslužné rutiny udalostí, skripty a všetok okolitý kód dodaný poskytovateľom. HTTP adresy, prihlasovacie údaje, vlastné porty, IP adresy, lokálni alebo interní hostitelia, hostitelia spravovaní službou Scoutello a neplatný kód iframe sa zamietajú. Scoutello odoslanú URL nenačítava, neprekladá, nevytvára z nej snímky obrazovky ani ju inak netestuje.
Dashboard zobrazuje lokálny náhľad konfigurácie a zámerne nekontaktuje poskytovateľa. Skutočný výsledok otestujte v publikovanej webovej aplikácii.
Načítanie, ochrana súkromia a povolenia
Iframe sa načíta automaticky a odložene, keď sa priblíži k viditeľnej oblasti. Poskytovateľ tretej strany tak môže byť kontaktovaný ešte pred interakciou návštevníka s dlaždicou. Vstavaný proces načítania po kliknutí návštevníka ani proces správcu súhlasov nie sú k dispozícii.
Pred uložením musí organizácia potvrdiť, že poskytovateľ je dôveryhodný a že boli vyriešené všetky požadované oznámenia o ochrane súkromia alebo správa súhlasov. Toto potvrdenie zaznamenáva rozhodnutie pri tvorbe obsahu; nejde o súhlas návštevníka.
Výšku pre mobilné zariadenia a počítače možno nastaviť od 240 do 1 600 pixelov. Predvolené hodnoty sú 640 pixelov pre mobilné zariadenia a 720 pixelov pre počítače. Možnosti platieb a režimu celej obrazovky v prehliadači sú voliteľné a predvolene vypnuté. Kamera, mikrofón, geolokácia, schránka, sťahovanie a navigácia na najvyššej úrovni sa nikdy nepovoľujú.
Runtime používa nastavenia sandboxu a politiky odkazovača definované v kóde. Tokeny sandboxu alebo povolení dodané zákazníkom sa do vykresleného iframe nikdy nedostanú. Sémantiku sandboxu v prehliadačoch opisuje špecifikácia iframe WHATWG.
Obmedzenia vkladania
Poskytovatelia môžu zakázať vkladanie pomocou direktívy Content Security Policy frame-ancestors alebo hlavičky X-Frame-Options. Keďže prehliadače neposkytujú spoľahlivé podrobnosti o zlyhaní rámcovania medzi doménami, Scoutello nemôže overiť kompatibilitu v dashboarde ani vždy rozlíšiť odmietnutie poskytovateľa od prázdnej stránky poskytovateľa.
Ak sa uložená konfigurácia stane neplatnou, prostredie pre návštevníkov zobrazí bezpečný lokalizovaný chybový stav a podľa možnosti aj alternatívu na otvorenie externého obsahu.
Poskytovatelia vyžadujúci skripty
Ľubovoľné skripty poskytovateľa nemôžu byť spustené na stránke Scoutello. Odoslanie obsahujúce iba skript sa zablokuje a ponúkne možnosť Požiadať o integráciu poskytovateľa. Žiadosť zhromažďuje názov poskytovateľa, verejnú URL dokumentácie, zamýšľaný prípad použitia a ukážku skriptu. Pred odoslaním odstráňte tajomstvá, súkromné prihlasovacie údaje a osobné údaje.
Ukážka skriptu sa ukladá iba ako obyčajný text žiadosti o podporu a nikdy sa nevykresľuje ani nespúšťa. Schválenie tento úryvok neodomkne. Vytvorí produktovú úlohu na preskúmanie adaptéra poskytovateľa, ktorý bude hostovaný v sandboxovanom dokumente na samostatne registrovateľnom origine bez súborov cookie, s politikou Content Security Policy špecifickou pre poskytovateľa a komunikáciou overovanou podľa originu. Tento postup vychádza z usmernení OWASP pre JavaScript tretích strán.
Kontrolný zoznam podpory
- Overte, že adresa je verejná HTTPS adresa a patrí zamýšľanému poskytovateľovi.
- Overte, že poskytovateľ povoľuje vkladanie iframe na publikovanom origine.
- Platby alebo režim celej obrazovky povoľte iba vtedy, keď ich vyžaduje dokumentácia poskytovateľa.
- Pred publikovaním skontrolujte oznámenia o ochrane súkromia a správanie súhlasov.
- V prípade widgetov fungujúcich iba so skriptom použite žiadosť o integráciu poskytovateľa; nikdy nevkladajte tajomstvá.