Preskoči na glavni sadržaj

Pločica: Vanjsko ugrađivanje (`externalEmbed`)

PoljeVrijednost
Identifikator pločiceexternalEmbed
Oznaka nadzorne pločeExternal embed / Einbettung
Kategorijaosnovno
Veličineembedded

Pločica za vanjsko ugrađivanje prikazuje alat za rezervacije ili drugu stranicu treće strane izravno u objavljenoj web-aplikaciji. Instalirane iOS i Android aplikacije prikazuju isti ograničeni iframe unutar svojeg Capacitor WebViewa.

Prihvaćeni unos​

Nadzorna ploča prihvaća jedno od sljedećeg:

  • Javni HTTPS URL.
  • Oznaku koja sadrži jedan iframe s jednim navodnicima omeđenim atributom src.

Pohranjuje se samo normalizirani URL iframea. Scoutello zanemaruje širinu, visinu, stilove, dopuštenja, postavke sandboxa, rukovatelje događajima, skripte i sav okolni kod koji je isporučio pružatelj. HTTP adrese, vjerodajnice, prilagođeni portovi, IP adrese, lokalni/interni hostovi, hostovi pod kontrolom sustava Scoutello i neispravan kod iframea odbijaju se. Scoutello ne dohvaća, ne razrješava, ne snima zaslonske prikaze niti na drugi način provjerava poslani URL.

Nadzorna ploča prikazuje lokalni pregled konfiguracije i namjerno ne kontaktira pružatelja. Stvarni rezultat testirajte u objavljenoj web-aplikaciji.

Učitavanje, privatnost i dopuštenja​

Iframe se učitava automatski i odgođeno, kada se približi vidljivom području. To može uspostaviti kontakt s pružateljem treće strane prije nego što posjetitelj stupi u interakciju s pločicom. Nema ugrađenog tijeka za učitavanje na klik posjetitelja ni tijeka upravljanja privolama.

Prije spremanja organizacija mora potvrditi da je pružatelj pouzdan te da su riješene sve potrebne obavijesti o privatnosti i postupanje s privolama. Ova potvrda bilježi odluku pri izradi sadržaja; ona nije privola posjetitelja.

Visine za mobilne i stolne uređaje mogu se postaviti od 240 do 1.600 piksela. Zadane su vrijednosti 640 piksela za mobilne uređaje i 720 piksela za stolne uređaje. Mogućnosti plaćanja i prikaza preko cijelog zaslona u pregledniku nisu obavezne i prema zadanim su postavkama onemogućene. Kamera, mikrofon, geolokacija, međuspremnik, preuzimanja i navigacija najviše razine nikad se ne dopuštaju.

Izvršno okruženje upotrebljava postavke sandboxa i pravila upućivača kojima upravlja kod. Tokeni sandboxa ili dopuštenja koje dostavi korisnik nikad ne dospijevaju u prikazani iframe. Pogledajte WHATWG specifikaciju iframea za semantiku sandboxa u preglednicima.

Ograničenja ugrađivanja​

Pružatelji mogu zabraniti ugrađivanje direktivom Content Security Policy frame-ancestors ili zaglavljem X-Frame-Options. Budući da preglednici ne izlažu pouzdane pojedinosti o neuspjelom ugrađivanju sadržaja s druge izvorišne domene, Scoutello ne može provjeriti kompatibilnost na nadzornoj ploči niti uvijek razlikovati odbijanje pružatelja od prazne stranice pružatelja.

Ako spremljena konfiguracija postane nevažeća, iskustvo gosta prikazuje sigurno lokalizirano stanje pogreške i, kada je moguće, alternativu za otvaranje sadržaja izvana.

Pružatelji koji zahtijevaju skripte​

Proizvoljne skripte pružatelja ne mogu se izvršavati na stranici Scoutella. Slanje koje sadrži samo skriptu blokira se i nudi mogućnost Zatraži integraciju pružatelja. Zahtjev prikuplja naziv pružatelja, URL javne dokumentacije, predviđeni slučaj upotrebe i primjer skripte. Prije slanja uklonite tajne, privatne vjerodajnice i osobne podatke.

Primjer skripte pohranjuje se samo kao običan tekst zahtjeva za podršku te se nikad ne prikazuje niti izvršava. Odobrenje ne otključava taj isječak. Ono pokreće rad na proizvodu za pregledani prilagodnik pružatelja, hostan u dokumentu sa sandboxom na izvornoj domeni bez kolačića i zasebno registrabilnoj domeni, uz Content Security Policy specifičan za pružatelja i razmjenu poruka provjerenu prema izvornoj domeni. To je u skladu sa smjernicama OWASP-a za JavaScript trećih strana.

Kontrolni popis za podršku​

  • Potvrdite da je adresa javni HTTPS URL i da pripada predviđenom pružatelju.
  • Potvrdite da pružatelj dopušta ugrađivanje iframea na objavljenoj izvorišnoj domeni.
  • Omogućite plaćanje ili prikaz preko cijelog zaslona samo kada je to potrebno prema dokumentaciji pružatelja.
  • Prije objave pregledajte obavijesti o privatnosti i ponašanje privola.
  • Za widgete koji koriste samo skripte upotrijebite zahtjev za integraciju pružatelja; nikad ne lijepite tajne.