Preskočiť na hlavný obsah

Dlaždica: externé vloženie (`externalEmbed`)

PoleHodnota
Identifikátor dlaždiceexternalEmbed
Označenie na dashboardeExternal embed / Einbettung
Kategóriabasic
Veľkostiembedded

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 src v ú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á.