Hopp til hovedinnholdet

Flis: ekstern innbygging (`externalEmbed`)

FeltVerdi
Tile-identifikatorexternalEmbed
Etikett i kontrollpaneletExternal embed / Einbettung
Kategoribasic
Størrelserembedded

Tiletypen for eksternt innebygd innhold viser et bestillingsverktøy eller en annen tredjepartsside direkte i en publisert nettapp. Installerte iOS- og Android-apper viser den samme begrensede iframen i sin Capacitor WebView.

Godkjente inndata​

Kontrollpanelet godtar enten:

  • En offentlig HTTPS-URL.
  • Markup som inneholder én iframe med ett anførselstegninnrammet src-attributt.

Bare den normaliserte iframe-URL-en lagres. Scoutello ignorerer bredde, høyde, stiler, tillatelser, sandbox-innstillinger, hendelsesbehandlere, skript og all omsluttende markup fra leverandøren. HTTP-adresser, påloggingsdetaljer, egendefinerte porter, IP-adresser, lokale/interne verter, Scoutello-kontrollerte verter og ugyldig iframe-kode avvises. Scoutello henter ikke, løser ikke opp, tar ikke skjermbilder av og undersøker på ingen annen måte den innsendte URL-en.

Kontrollpanelet viser en lokal konfigurasjonsforhåndsvisning og kontakter med hensikt ikke leverandøren. Test det faktiske resultatet i den publiserte nettappen.

Innlasting, personvern og tillatelser​

Iframen lastes inn automatisk og utsatt når den nærmer seg det synlige området. Dette kan kontakte tredjepartsleverandøren før en besøkende samhandler med tile-elementet. Det finnes ingen innebygd funksjon for at besøkende kan klikke for å laste inn, og heller ingen flyt for samtykkehåndtering.

Før lagring må organisasjonen bekrefte at leverandøren er klarert, og at eventuelle nødvendige personvernmerknader eller samtykkehåndtering er ivaretatt. Bekreftelsen registrerer en beslutning under opprettelsen; den er ikke besøkendes samtykke.

Høyden på mobil og desktop kan angis fra 240 til 1 600 piksler. Standardverdiene er 640 piksler på mobil og 720 piksler på desktop. Betaling og fullskjermfunksjoner i nettleseren er valgfrie og deaktivert som standard. Kamera, mikrofon, geolokasjon, utklippstavle, nedlastinger og navigering på toppnivå gis aldri tilgang.

Kjøretidsmiljøet bruker sandbox- og referrer-policy-innstillinger som eies av koden. Kundedefinerte sandbox- eller tillatelsestokener når aldri den gjengitte iframen. Se WHATWG iframe-spesifikasjonen for informasjon om sandbox-semantikk i nettlesere.

Begrensninger for innramming​

Leverandører kan hindre innebygging med et Content Security Policy frame-ancestors-direktiv eller en X-Frame-Options-header. Ettersom nettlesere ikke eksponerer pålitelig informasjon om mislykket innramming på tvers av opprinnelser, kan Scoutello ikke bekrefte kompatibilitet i kontrollpanelet eller alltid skille mellom at leverandøren avviser innramming og at leverandørsiden er tom.

Hvis en lagret konfigurasjon blir ugyldig, viser gjesteopplevelsen en trygg, lokalisert feiltilstand og, når det er mulig, et alternativ for å åpne innholdet eksternt.

Leverandører som krever skript​

Vilkommelige leverandørskript kan ikke kjøre på en Scoutello-side. En innsending som bare inneholder skript, blokkeres og tilbyr i stedet Be om leverandørintegrasjon. Forespørselen samler inn leverandørnavn, offentlig dokumentasjons-URL, tiltenkt bruksområde og et skripteksempel. Fjern hemmeligheter, private påloggingsopplysninger og personopplysninger før innsending.

Skripteksempelet lagres bare som ren tekst i supportforespørselen og blir aldri gjengitt eller kjørt. Godkjenning låser ikke opp dette utdraget. Den oppretter produktarbeid for en gjennomgått leverandøradapter som kjøres i et sandboxet dokument på en informasjonskapselløs, separat registrerbar opprinnelse med leverandørspesifikk Content Security Policy og meldingsutveksling som kontrollerer opprinnelsen. Dette følger OWASP-veiledningen for JavaScript fra tredjeparter.

Sjekkliste for support​

  • Bekreft at adressen er offentlig HTTPS og tilhører den tiltenkte leverandøren.
  • Bekreft at leverandøren tillater iframe-innbygging på den publiserte opprinnelsen.
  • Aktiver betaling eller fullskjerm bare når leverandørens dokumentasjon krever det.
  • Gå gjennom personvernmerknader og samtykkehåndtering før publisering.
  • Bruk forespørselen om leverandørintegrasjon for widgeter som bare bruker skript; lim aldri inn hemmeligheter.