Tegel: Externe insluiting (`externalEmbed`)
| Veld | Waarde |
|---|---|
| Tegel-ID | externalEmbed |
| Dashboardlabel | Externe insluiting / Einbettung |
| Categorie | basic |
| Formaten | embedded |
De tegel voor externe insluiting toont een boekingstool of andere pagina van een derde partij rechtstreeks in een gepubliceerde webapp. Geïnstalleerde iOS- en Android-apps geven dezelfde beperkte iframe weer in hun Capacitor WebView.
Geaccepteerde invoer
Het dashboard accepteert een van de volgende opties:
- Een openbare HTTPS-URL.
- Markup met één iframe met één aangehaald
src-attribuut.
Alleen de genormaliseerde iframe-URL wordt opgeslagen. Scoutello negeert breedte, hoogte, stijlen, machtigingen, sandbox-instellingen, eventhandlers, scripts en alle overige markup die door de provider wordt aangeleverd. HTTP-adressen, inloggegevens, aangepaste poorten, IP-adressen, lokale of interne hosts, door Scoutello beheerde hosts en ongeldige iframe-code worden geweigerd. Scoutello haalt de ingediende URL niet op en voert er geen DNS-resolutie, screenshot of andere controle op uit.
Het dashboard toont een lokale configuratievoorbeeldweergave en maakt bewust geen verbinding met de provider. Test het daadwerkelijke resultaat in de gepubliceerde webapp.
Laden, privacy en machtigingen
De iframe wordt automatisch en lazy geladen zodra deze de zichtbare zone nadert. Hierdoor kan vóór interactie met de tegel contact worden opgenomen met de externe provider. Er is geen ingebouwde flow waarbij bezoekers via een klik laden of toestemming beheren.
Voor het opslaan moet de organisatie bevestigen dat de provider wordt vertrouwd en dat eventuele vereiste privacyverklaringen of toestemmingsprocessen zijn geregeld. Deze bevestiging legt een beslissing bij het maken van de configuratie vast; het is geen toestemming van bezoekers.
Hoogtes voor mobiel en desktop kunnen worden ingesteld van 240 tot 1.600 pixels. De standaardwaarden zijn 640 pixels voor mobiel en 720 pixels voor desktop. Browsermogelijkheden voor betalingen en volledig scherm zijn optioneel en standaard uitgeschakeld. Toegang tot camera, microfoon, geolocatie en klembord, downloads en navigatie op hoofdniveau wordt nooit verleend.
De runtime gebruikt codegestuurde sandbox- en referrer-policy-instellingen. Door klanten aangeleverde sandbox- of machtigingstokens bereiken de weergegeven iframe nooit. Zie de WHATWG iframe-specificatie voor de semantiek van browsersandboxen.
Beperkingen voor insluiting
Providers kunnen insluiting verbieden met een Content Security Policy frame-ancestors-richtlijn of een X-Frame-Options-header. Omdat browsers geen betrouwbare details over fouten bij cross-origin framing beschikbaar maken, kan Scoutello de compatibiliteit niet in het dashboard verifiëren en niet altijd onderscheid maken tussen een weigering door de provider en een lege providerpagina.
Als een opgeslagen configuratie ongeldig wordt, toont de bezoekerservaring een veilige, gelokaliseerde foutstatus en, indien mogelijk, een alternatief om de pagina extern te openen.
Providers waarvoor scripts nodig zijn
Willekeurige providerscripts kunnen niet in een Scoutello-pagina worden uitgevoerd. Een inzending die alleen uit een script bestaat, wordt geblokkeerd en biedt in plaats daarvan Providerintegratie aanvragen. Bij de aanvraag worden de providernaam, openbare documentatie-URL, het beoogde gebruik en een scriptvoorbeeld verzameld. Verwijder geheimen, privé-inloggegevens en persoonsgegevens voordat de aanvraag wordt ingediend.
Het scriptvoorbeeld wordt uitsluitend opgeslagen als tekst in een ondersteuningsaanvraag en wordt nooit weergegeven of uitgevoerd. Goedkeuring activeert dat fragment niet. Er wordt productwerk aangemaakt voor een beoordeelde provideradapter die wordt gehost in een gesandboxte documentomgeving op een cookie-loze, afzonderlijk registreerbare origin, met een providerspecifiek Content Security Policy en messaging waarbij de origin wordt gecontroleerd. Dit volgt de OWASP-richtlijnen voor JavaScript van derden.
Checklist voor ondersteuning
- Controleer of het adres openbare HTTPS gebruikt en bij de beoogde provider hoort.
- Controleer of de provider iframe-insluiting op de gepubliceerde origin toestaat.
- Schakel betaling of volledig scherm alleen in als de providerdocumentatie dit vereist.
- Controleer privacyverklaringen en toestemmingsgedrag vóór publicatie.
- Gebruik de aanvraag voor providerintegratie voor widgets die alleen scripts gebruiken; plak nooit geheimen.