Ruta: Extern inbäddning (`externalEmbed`)
| Fält | Värde |
|---|---|
| Tile-identifierare | externalEmbed |
| Etikett i dashboarden | Extern inbäddning / Einbettung |
| Kategori | basic |
| Storlekar | embedded |
Tiletypen för extern inbäddning visar ett bokningsverktyg eller en annan tredjepartssida direkt i en publicerad webbapp. Installerade iOS- och Android-appar återger samma begränsade iframe i sin Capacitor WebView.
Godkända indata
Dashboarden accepterar antingen:
- En offentlig HTTPS-URL.
- Kod som innehåller ett iframe-element med ett citerat
src-attribut.
Endast den normaliserade iframe-URL:en sparas. Scoutello ignorerar bredd, höjd, formatmallar, behörigheter, sandbox-inställningar, händelsehanterare, skript och all omgivande kod som leverantören har angett. HTTP-adresser, autentiseringsuppgifter, anpassade portar, IP-adresser, lokala eller interna värdar, Scoutello-kontrollerade värdar och felaktig iframe-kod avvisas. Scoutello hämtar, löser upp, skärmdumpar eller sonderar på annat sätt inte den inskickade URL:en.
Dashboarden visar en lokal konfigurationsförhandsvisning och kontaktar medvetet inte leverantören. Testa det faktiska resultatet i den publicerade webbappen.
Inläsning, integritet och behörigheter
Iframe-elementet läses in automatiskt och med lazy loading när det närmar sig det synliga området. Detta kan kontakta tredjepartsleverantören innan en besökare interagerar med tilelementet. Det finns inget inbyggt flöde där besökaren klickar för att läsa in innehållet eller hanterar samtycke.
Innan sparandet måste organisationen bekräfta att leverantören är betrodd och att nödvändiga integritetsmeddelanden eller samtyckeshantering har hanterats. Bekräftelsen registrerar ett beslut vid skapandet; den utgör inte besökarens samtycke.
Höjden för mobil och dator kan ställas in från 240 till 1 600 pixlar. Standardvärdet är 640 pixlar på mobil och 720 pixlar på dator. Webbläsarfunktioner för betalning och helskärm är valfria och inaktiverade som standard. Kamera, mikrofon, geolokalisering, urklipp, nedladdningar och navigering på toppnivå beviljas aldrig.
Körningen använder kodstyrda sandbox- och referrer-policy-inställningar. Sandboxing- eller behörighetstokens som anges av kunden når aldrig det återgivna iframe-elementet. Se WHATWG:s iframe-specifikation för webbläsarens sandbox-semantik.
Begränsningar för inbäddning
Leverantörer kan förhindra inbäddning med direktivet Content Security Policy frame-ancestors eller en X-Frame-Options-header. Eftersom webbläsare inte tillhandahåller tillförlitlig information om misslyckad inbäddning mellan ursprung kan Scoutello inte verifiera kompatibiliteten i dashboarden eller alltid skilja ett avvisande från leverantören från en tom leverantörssida.
Om en sparad konfiguration blir ogiltig visas ett säkert, lokaliserat felläge för besökaren och, när det är möjligt, ett alternativ för att öppna sidan externt.
Leverantörer som kräver skript
Godtyckliga leverantörsskript kan inte köras på en Scoutello-sida. Ett skriptbaserat försök blockeras och erbjuder i stället Begär leverantörsintegration. Begäran samlar in leverantörens namn, URL till offentlig dokumentation, avsett användningsfall och ett skriptexempel. Ta bort hemligheter, privata autentiseringsuppgifter och personuppgifter innan begäran skickas in.
Skriptexemplet sparas endast som oformaterad text i supportärendet och återges eller körs aldrig. Ett godkännande aktiverar inte kodavsnittet. I stället skapas produktarbete för en granskad leverantörsanpassning som körs i ett sandboxat dokument på ett cookie-fritt, separat registrerbart ursprung med en leverantörsspecifik Content Security Policy och meddelandehantering som kontrollerar ursprung. Detta följer OWASP:s vägledning för JavaScript från tredje part.
Checklista för support
- Bekräfta att adressen är offentlig HTTPS och tillhör den avsedda leverantören.
- Bekräfta att leverantören tillåter iframe-inbäddning på det publicerade ursprunget.
- Aktivera betalning eller helskärm endast när leverantörens dokumentation kräver det.
- Granska integritetsmeddelanden och samtyckeshantering före publicering.
- Använd begäran om leverantörsintegration för skriptbaserade widgetar; klistra aldrig in hemligheter.