Hop til hovedindhold

Flise: Ekstern indlejring (`externalEmbed`)

FeltVærdi
Flise-idexternalEmbed
DashboardetiketEkstern indlejring / Einbettung
Kategoribasic
Størrelserembedded

Flisen til ekstern indlejring viser et bookingsystem eller en anden tredjepartsside direkte i en publiceret webapp. Installerede iOS- og Android-apps viser den samme begrænsede iframe i deres Capacitor WebView.

Accepteret input​

Dashboardet accepterer enten:

  • En offentlig HTTPS-URL.
  • Markup, der indeholder én iframe med én attribut med anførselstegn: src.

Kun den normaliserede iframe-URL gemmes. Scoutello ignorerer bredde, højde, typografier, tilladelser, sandbox-indstillinger, hændelseshandlere, scripts og al omgivende markup fra udbyderen. HTTP-adresser, legitimationsoplysninger, brugerdefinerede porte, IP-adresser, lokale/interne værter, Scoutello-kontrollerede værter og ugyldig iframe-kode afvises. Scoutello henter, opløser, tager skærmbilleder af eller undersøger på anden måde ikke den indsendte URL.

Dashboardet viser en lokal konfigurationsforhåndsvisning og kontakter med vilje ikke udbyderen. Test det faktiske resultat i den publicerede webapp.

Indlæsning, privatliv og tilladelser​

Iframe-elementet indlæses automatisk og forsinket, når det nærmer sig det synlige område. Det kan medføre kontakt til tredjepartsudbyderen, før en besøgende interagerer med flisen. Der findes ingen indbygget funktion til, at besøgende klikker for at indlæse, eller til håndtering af samtykke.

Før lagring skal organisationen bekræfte, at der er tillid til udbyderen, og at eventuelle nødvendige privatlivsmeddelelser eller samtykkeprocedurer er håndteret. Denne bekræftelse registrerer en beslutning truffet under oprettelsen; den er ikke den besøgendes samtykke.

Højden på mobil og desktop kan indstilles fra 240 til 1.600 pixels. Standardværdierne er 640 pixels på mobil og 720 pixels på desktop. Betalings- og fuldskærmsfunktioner i browseren er valgfrie og deaktiveret som standard. Kamera, mikrofon, geolokation, udklipsholder, downloads og navigation på øverste niveau tillades aldrig.

Kørselstiden bruger sandbox- og referrer-policy-indstillinger, der styres af koden. Kundeleverede sandbox- eller tilladelsestokens videregives aldrig til den renderede iframe. Se WHATWG iframe-specifikationen for oplysninger om browsersandboxens semantik.

Begrænsninger ved indlejring​

Udbydere kan forbyde indlejring med Content Security Policy-direktivet frame-ancestors eller en X-Frame-Options-header. Da browsere ikke giver adgang til pålidelige oplysninger om fejl ved indramning på tværs af oprindelser, kan Scoutello ikke bekræfte kompatibilitet i dashboardet eller altid skelne mellem en afvisning fra udbyderen og en tom udbyderside.

Hvis en gemt konfiguration bliver ugyldig, viser gæsteoplevelsen en sikker lokaliseret fejltilstand og, når det er muligt, et alternativ til at åbne siden eksternt.

Udbydere, der kræver scripts​

Udbyderes vilkårlige scripts kan ikke køre på en Scoutello-side. En indsendelse, der kun indeholder et script, blokeres og viser i stedet Anmod om integration af udbyder. Anmodningen indsamler udbyderens navn, URL til offentlig dokumentation, det tilsigtede anvendelsestilfælde og et scripteksempel. Fjern hemmeligheder, private legitimationsoplysninger og persondata, før det indsendes.

Scripteksemplet gemmes kun som almindelig tekst i supportanmodningen og renderes eller køres aldrig. En godkendelse aktiverer ikke dette kodestykke. Den opretter produktarbejde til en gennemgået udbyderadapter, der hostes i et sandboxet dokument på en cookiefri origin, der kan registreres separat, med en udbyderspecifik Content Security Policy og meddelelsesudveksling, der kontrollerer origin. Dette følger OWASP's vejledning om JavaScript fra tredjeparter.

Supporttjekliste​

  • Bekræft, at adressen er offentlig HTTPS og tilhører den tilsigtede udbyder.
  • Bekræft, at udbyderen tillader iframe-indlejring på den publicerede origin.
  • Aktivér kun betaling eller fuldskærm, når udbyderens dokumentation kræver det.
  • Gennemgå privatlivsmeddelelser og samtykkeadfærd før publicering.
  • Brug anmodningen om udbyderintegration til widgets, der kun fungerer via scripts; indsæt aldrig hemmeligheder.