Ubin: sematan eksternal (`externalEmbed`)
| Kolom | Nilai |
|---|---|
| Identifier tile | externalEmbed |
| Label dashboard | External embed / Einbettung |
| Kategori | basic |
| Ukuran | embedded |
Tile external embed menampilkan alat pemesanan atau halaman pihak ketiga lainnya langsung di aplikasi web yang dipublikasikan. Aplikasi iOS dan Android yang terpasang merender iframe terbatas yang sama di dalam Capacitor WebView.
Input yang diterima
Dashboard menerima salah satu dari berikut:
- URL HTTPS publik.
- Markup yang berisi satu iframe dengan satu atribut
srcyang diapit tanda kutip.
Hanya URL iframe yang telah dinormalisasi yang disimpan. Scoutello mengabaikan lebar, tinggi, gaya, izin, pengaturan sandbox, penanganan event, skrip, dan semua markup lain di sekitar yang disediakan oleh penyedia. Alamat HTTP, kredensial, port khusus, alamat IP, host lokal/internal, host yang dikendalikan Scoutello, serta kode iframe yang formatnya tidak valid akan ditolak. Scoutello tidak mengambil, me-resolve, mengambil tangkapan layar, atau memeriksa URL yang dikirimkan dengan cara lain.
Dashboard menampilkan pratinjau konfigurasi lokal dan sengaja tidak menghubungi penyedia. Uji hasil sebenarnya di aplikasi web yang telah dipublikasikan.
Pemuatan, privasi, dan izin
Iframe dimuat secara otomatis dan secara lazy saat mendekati area yang terlihat. Hal ini dapat menghubungi penyedia pihak ketiga sebelum pengunjung berinteraksi dengan tile. Tidak tersedia alur bawaan untuk memuat dengan klik pengunjung atau pengelola persetujuan.
Sebelum menyimpan, organisasi harus mengakui bahwa penyedia tersebut tepercaya dan bahwa pemberitahuan privasi atau penanganan persetujuan yang diperlukan telah disiapkan. Pengakuan ini mencatat keputusan saat membuat konfigurasi; ini bukan persetujuan pengunjung.
Tinggi pada perangkat seluler dan desktop dapat diatur dari 240 hingga 1.600 piksel. Nilai defaultnya adalah 640 piksel pada perangkat seluler dan 720 piksel pada desktop. Kemampuan pembayaran dan layar penuh di browser bersifat opsional dan dinonaktifkan secara default. Kamera, mikrofon, geolokasi, clipboard, unduhan, dan navigasi tingkat atas tidak pernah diberikan.
Runtime menggunakan pengaturan sandbox dan kebijakan perujuk yang dikelola oleh kode. Token sandbox atau izin yang diberikan pelanggan tidak pernah diteruskan ke iframe yang dirender. Lihat spesifikasi iframe WHATWG untuk memahami semantik sandbox browser.
Keterbatasan embedding
Penyedia dapat melarang embedding menggunakan direktif Content Security Policy frame-ancestors atau header X-Frame-Options. Karena browser tidak menampilkan detail kegagalan framing lintas asal yang andal, Scoutello tidak dapat memverifikasi kompatibilitas di dashboard atau selalu membedakan penolakan penyedia dari halaman penyedia yang kosong.
Jika konfigurasi yang tersimpan menjadi tidak valid, pengalaman tamu menampilkan status error terlokalisasi yang aman dan, jika memungkinkan, opsi untuk membuka secara eksternal.
Penyedia yang memerlukan skrip
Skrip penyedia arbitrer tidak dapat dijalankan di halaman Scoutello. Pengiriman yang hanya berisi skrip akan diblokir dan menawarkan Request provider integration. Permintaan ini mengumpulkan nama penyedia, URL dokumentasi publik, kasus penggunaan yang dimaksud, dan contoh skrip. Hapus rahasia, kredensial pribadi, dan data pribadi sebelum mengirimkannya.
Contoh skrip hanya disimpan sebagai teks biasa dalam permintaan dukungan dan tidak pernah dirender atau dijalankan. Persetujuan tidak membuka akses ke cuplikan tersebut. Persetujuan membuat pekerjaan produk untuk adapter penyedia yang telah ditinjau, yang di-host dalam dokumen bersandbox di origin yang dapat didaftarkan secara terpisah dan tanpa cookie, dengan Content Security Policy khusus penyedia serta pesan yang memeriksa origin. Pendekatan ini mengikuti panduan JavaScript pihak ketiga OWASP.
Daftar periksa dukungan
- Pastikan alamat tersebut merupakan HTTPS publik dan milik penyedia yang dimaksud.
- Pastikan penyedia mengizinkan embedding iframe pada origin yang dipublikasikan.
- Aktifkan pembayaran atau layar penuh hanya jika diwajibkan oleh dokumentasi penyedia.
- Tinjau pemberitahuan privasi dan perilaku persetujuan sebelum publikasi.
- Gunakan permintaan integrasi penyedia untuk widget yang hanya menggunakan skrip; jangan pernah menempelkan rahasia.