Kachel: Externe Einbettung (`externalEmbed`)
| Feld | Wert |
|---|---|
| Kachelkennung | externalEmbed |
| Dashboard-Bezeichnung | Externe Einbettung / Einbettung |
| Kategorie | basic |
| Größen | embedded |
Die Kachel für externe Einbettungen zeigt ein Buchungstool oder eine andere Seite eines Drittanbieters direkt in einer veröffentlichten Web-App an. Installierte iOS- und Android-Apps rendern dasselbe eingeschränkte iframe in ihrer Capacitor-WebView.
Akzeptierte Eingaben
Das Dashboard akzeptiert entweder:
- Eine öffentliche HTTPS-URL.
- Markup mit einem iframe und genau einem in Anführungszeichen gesetzten
src-Attribut.
Gespeichert wird nur die normalisierte iframe-URL. Scoutello ignoriert Breite, Höhe, Styles, Berechtigungen, Sandbox-Einstellungen, Event-Handler, Skripte und sämtliches umgebendes Markup des Anbieters. HTTP-Adressen, Zugangsdaten, benutzerdefinierte Ports, IP-Adressen, lokale oder interne Hosts, von Scoutello kontrollierte Hosts sowie fehlerhaftes iframe-Markup werden abgelehnt. Scoutello ruft die eingereichte URL nicht ab, löst sie nicht auf und prüft sie auch nicht anderweitig.
Das Dashboard zeigt eine lokale Konfigurationsvorschau an und kontaktiert den Anbieter bewusst nicht. Das tatsächliche Ergebnis sollte in der veröffentlichten Web-App getestet werden.
Laden, Datenschutz und Berechtigungen
Das iframe wird automatisch und verzögert geladen, sobald es sich dem sichtbaren Bereich nähert. Dadurch kann der Drittanbieter kontaktiert werden, bevor eine Person mit der Kachel interagiert. Es gibt keinen integrierten Ablauf zum Laden per Klick oder zur Einwilligungsverwaltung.
Vor dem Speichern muss die Organisation bestätigen, dass dem Anbieter vertraut wird und alle erforderlichen Datenschutzhinweise oder Einwilligungsprozesse berücksichtigt wurden. Diese Bestätigung dokumentiert eine Entscheidung bei der Erstellung; sie stellt keine Einwilligung der Besuchenden dar.
Für Mobilgeräte und Desktop können Höhen zwischen 240 und 1.600 Pixeln festgelegt werden. Die Standardwerte betragen 640 Pixel für Mobilgeräte und 720 Pixel für Desktop. Browserfunktionen für Zahlungen und den Vollbildmodus sind optional und standardmäßig deaktiviert. Kamera, Mikrofon, Geolokalisierung, Zwischenablage, Downloads und die Navigation auf oberster Ebene werden niemals freigegeben.
Die Laufzeit verwendet vom Code festgelegte Sandbox- und Referrer-Policy-Einstellungen. Von Kundenseite angegebene Sandbox- oder Berechtigungstokens erreichen das gerenderte iframe nie. Weitere Informationen zu den Sandbox-Semantiken von Browsern enthält die WHATWG-iframe-Spezifikation.
Einschränkungen beim Einbetten
Anbieter können das Einbetten mit einer Content-Security-Policy-Direktive frame-ancestors oder einem X-Frame-Options-Header verhindern. Da Browser keine zuverlässigen Details zu Fehlern beim Cross-Origin-Framing bereitstellen, kann Scoutello die Kompatibilität im Dashboard nicht überprüfen und eine Ablehnung durch den Anbieter nicht immer von einer leeren Anbieterseite unterscheiden.
Wenn eine gespeicherte Konfiguration ungültig wird, zeigt die Gastansicht einen sicheren lokalisierten Fehlerstatus und, sofern möglich, eine Option zum Öffnen in einem externen Fenster an.
Anbieter, die Skripte erfordern
Beliebige Anbieterskripte können nicht in einer Scoutello-Seite ausgeführt werden. Eine Einreichung, die ausschließlich aus einem Skript besteht, wird blockiert und bietet stattdessen Anbieterintegration anfordern an. Die Anfrage erfasst den Namen des Anbieters, die öffentliche Dokumentations-URL, den vorgesehenen Anwendungsfall und ein Skriptbeispiel. Vor dem Absenden müssen Geheimnisse, private Zugangsdaten und personenbezogene Daten entfernt werden.
Das Skriptbeispiel wird ausschließlich als einfacher Text in der Supportanfrage gespeichert und niemals gerendert oder ausgeführt. Eine Genehmigung schaltet diesen Ausschnitt nicht frei. Sie führt zu Produktarbeit für einen geprüften Anbieteradapter, der in einem isolierten Dokument auf einer cookielosen, separat registrierbaren Origin mit anbieterspezifischer Content Security Policy und einer Origin-geprüften Nachrichtenübermittlung gehostet wird. Dies folgt den OWASP-Richtlinien für JavaScript von Drittanbietern.
Checkliste zur Problemlösung
- Bestätigen, dass die Adresse öffentlich per HTTPS erreichbar ist und zum vorgesehenen Anbieter gehört.
- Bestätigen, dass der Anbieter das Einbetten per iframe auf der veröffentlichten Origin erlaubt.
- Zahlung oder Vollbildmodus nur aktivieren, wenn dies laut Anbieterdokumentation erforderlich ist.
- Datenschutzhinweise und Einwilligungsverhalten vor der Veröffentlichung prüfen.
- Für Widgets, die ausschließlich Skripte verwenden, die Anfrage zur Anbieterintegration nutzen; niemals Geheimnisse einfügen.