Riquadro: Incorporazione esterna (`externalEmbed`)
| Campo | Valore |
|---|---|
| Identificatore della tile | externalEmbed |
| Etichetta nella dashboard | Incorporazione esterna / Einbettung |
| Categoria | basic |
| Dimensioni | embedded |
La tile di incorporazione esterna visualizza direttamente in un'app web pubblicata uno strumento di prenotazione o un'altra pagina di terze parti. Le app iOS e Android installate eseguono lo stesso iframe con restrizioni nella WebView di Capacitor.
Input accettato
La dashboard accetta una delle seguenti opzioni:
- Un URL HTTPS pubblico.
- Codice contenente un iframe con un attributo
srcracchiuso tra virgolette.
Viene memorizzato solo l'URL normalizzato dell'iframe. Scoutello ignora larghezza, altezza, stili, autorizzazioni, impostazioni sandbox, gestori di eventi, script e tutto il markup circostante fornito dal provider. Gli indirizzi HTTP, le credenziali, le porte personalizzate, gli indirizzi IP, gli host locali o interni, gli host controllati da Scoutello e il codice iframe non valido vengono rifiutati. Scoutello non recupera, risolve, acquisisce schermate né esegue altri controlli sull'URL inviato.
La dashboard mostra un'anteprima locale della configurazione e, intenzionalmente, non contatta il provider. Per verificare il risultato effettivo, usare l'app web pubblicata.
Caricamento, privacy e autorizzazioni
L'iframe viene caricato automaticamente e in modo differito quando si avvicina all'area visibile. Questo può contattare il provider di terze parti prima che una persona interagisca con la tile. Non è disponibile una funzione integrata per consentire il caricamento tramite clic o per gestire il consenso.
Prima del salvataggio, l'organizzazione deve confermare che il provider è considerato affidabile e che eventuali informative sulla privacy o procedure di gestione del consenso necessarie sono state predisposte. Questa conferma registra una decisione relativa alla configurazione; non costituisce il consenso della persona visitante.
Le altezze per dispositivi mobili e desktop possono essere impostate da 240 a 1.600 pixel. I valori predefiniti sono 640 pixel sui dispositivi mobili e 720 pixel sui desktop. Le funzionalità del browser per i pagamenti e la modalità a schermo intero sono facoltative e disabilitate per impostazione predefinita. Fotocamera, microfono, geolocalizzazione, appunti, download e navigazione di primo livello non vengono mai autorizzati.
Il runtime utilizza impostazioni di sandbox e referrer policy definite nel codice. I token sandbox o di autorizzazione forniti dall'organizzazione non raggiungono mai l'iframe renderizzato. Per informazioni sulla semantica della sandbox del browser, consultare la specifica WHATWG sugli iframe.
Limitazioni dell'incorporazione
I provider possono vietare l'incorporazione mediante una direttiva Content Security Policy frame-ancestors o un'intestazione X-Frame-Options. Poiché i browser non espongono dettagli affidabili sui problemi di incorporazione tra origini diverse, Scoutello non può verificare la compatibilità nella dashboard né distinguere sempre un rifiuto del provider da una pagina del provider vuota.
Se una configurazione salvata diventa non valida, l'esperienza della persona ospite mostra uno stato di errore localizzato e sicuro e, quando possibile, un'opzione per aprire il contenuto esternamente.
Provider che richiedono script
Gli script arbitrari dei provider non possono essere eseguiti in una pagina Scoutello. L'invio di codice contenente solo uno script viene bloccato e propone invece Richiedi un'integrazione del provider. La richiesta raccoglie il nome del provider, l'URL della documentazione pubblica, il caso d'uso previsto e un esempio di script. Rimuovere segreti, credenziali private e dati personali prima dell'invio.
L'esempio di script viene memorizzato solo come testo semplice nella richiesta di assistenza e non viene mai visualizzato né eseguito. L'approvazione non abilita quello snippet. Genera un'attività di prodotto per un adattatore del provider sottoposto a revisione, ospitato in un documento sandbox su un'origine senza cookie e registrabile separatamente, con una Content Security Policy specifica del provider e messaggistica verificata per origine. Questo approccio segue le indicazioni OWASP sul JavaScript di terze parti.
Checklist di assistenza
- Verificare che l'indirizzo sia HTTPS pubblico e appartenga al provider previsto.
- Verificare che il provider consenta l'incorporazione tramite iframe nell'origine pubblicata.
- Abilitare i pagamenti o la modalità a schermo intero solo quando richiesto dalla documentazione del provider.
- Esaminare le informative sulla privacy e il comportamento relativo al consenso prima della pubblicazione.
- Usare la richiesta di integrazione del provider per i widget che richiedono esclusivamente script; non incollare mai segreti.