Ana içeriğe geç

Kutucuk: Harici yerleştirme (`externalEmbed`)

AlanDeğer
Tile tanımlayıcısıexternalEmbed
Kontrol paneli etiketiHarici yerleştirme / Einbettung
Kategoribasic
Boyutlarembedded

Harici yerleştirme kutucuğu, bir rezervasyon aracını veya başka bir üçüncü taraf sayfasını yayınlanmış bir web uygulamasında doğrudan görüntüler. Yüklü iOS ve Android uygulamaları, aynı kısıtlanmış iframe'i Capacitor WebView içinde görüntüler.

Kabul edilen giriş​

Kontrol paneli aşağıdakilerden birini kabul eder:

  • Herkese açık bir HTTPS URL'si.
  • Tek bir iframe ve tırnak içine alınmış bir src özniteliği içeren işaretleme.

Yalnızca normalleştirilmiş iframe URL'si saklanır. Scoutello; sağlayıcı tarafından gönderilen genişlik, yükseklik, stiller, izinler, sandbox ayarları, olay işleyicileri, komut dosyaları ve çevresindeki tüm işaretlemeleri yok sayar. HTTP adresleri, kimlik bilgileri, özel bağlantı noktaları, IP adresleri, yerel veya dahili ana makineler, Scoutello tarafından kontrol edilen ana makineler ve hatalı iframe kodu reddedilir. Scoutello, gönderilen URL'yi almaz, çözümlemez, ekran görüntüsünü almaz veya başka şekilde yoklamaz.

Kontrol paneli yerel bir yapılandırma önizlemesi gösterir ve sağlayıcıyla bilerek iletişim kurmaz. Gerçek sonucu yayınlanmış web uygulamasında test edin.

Yükleme, gizlilik ve izinler​

Iframe, görünür alana yaklaştığında otomatik ve gecikmeli olarak yüklenir. Bu işlem, ziyaretçi kutucukla etkileşime geçmeden önce üçüncü taraf sağlayıcıyla iletişim kurulmasına neden olabilir. Yerleşik bir ziyaretçi tıklayarak yükleme veya izin yöneticisi akışı yoktur.

Kaydetmeden önce kuruluş, sağlayıcıya güvenildiğini ve gerekli gizlilik bildirimleri veya izin işlemlerinin ele alındığını onaylamalıdır. Bu onay, içeriği oluşturan kişinin kararını kaydeder; ziyaretçi izni anlamına gelmez.

Mobil ve masaüstü yükseklikleri 240 ile 1.600 piksel arasında ayarlanabilir. Varsayılan değerler mobil için 640, masaüstü için 720 pikseldir. Ödeme ve tam ekran tarayıcı özellikleri isteğe bağlıdır ve varsayılan olarak devre dışıdır. Kamera, mikrofon, coğrafi konum, pano, indirmeler ve üst düzey gezinme için hiçbir zaman izin verilmez.

Çalışma zamanı, kod tarafından belirlenen sandbox ve yönlendiren politikası ayarlarını kullanır. Müşteri tarafından sağlanan sandbox veya izin belirteçleri, görüntülenen iframe'e hiçbir zaman ulaşmaz. Tarayıcı sandbox semantiği için WHATWG iframe spesifikasyonuna bakın.

Çerçeveleme sınırlamaları​

Sağlayıcılar, Content Security Policy frame-ancestors yönergesi veya X-Frame-Options başlığıyla yerleştirmeyi engelleyebilir. Tarayıcılar kaynaklar arası çerçeveleme hatası ayrıntılarını güvenilir biçimde sunmadığından Scoutello, kontrol panelinde uyumluluğu doğrulayamaz veya sağlayıcının reddetmesini boş bir sağlayıcı sayfasından her zaman ayırt edemez.

Kaydedilmiş bir yapılandırma geçersiz hâle gelirse konuk deneyiminde güvenli, yerelleştirilmiş bir hata durumu ve mümkün olduğunda harici açma seçeneği gösterilir.

Komut dosyası gerektiren sağlayıcılar​

Rastgele sağlayıcı komut dosyaları Scoutello sayfasında çalıştırılamaz. Yalnızca komut dosyasından oluşan gönderimler engellenir ve bunun yerine Sağlayıcı entegrasyonu iste seçeneği sunulur. İstekte sağlayıcının adı, herkese açık dokümantasyon URL'si, amaçlanan kullanım senaryosu ve bir komut dosyası örneği toplanır. Göndermeden önce gizli bilgileri, özel kimlik bilgilerini ve kişisel verileri kaldırın.

Komut dosyası örneği yalnızca düz destek talebi metni olarak saklanır; hiçbir zaman görüntülenmez veya çalıştırılmaz. Onay, bu parçanın kilidini açmaz. Bunun yerine, tanımlama bilgileri kullanılmayan ve ayrı kaydedilebilir bir origin üzerinde, sandbox uygulanmış bir belgede barındırılan; sağlayıcıya özel Content Security Policy ve origin doğrulamalı mesajlaşma kullanan, incelenmiş bir sağlayıcı bağdaştırıcısı için ürün çalışması oluşturur. Bu yaklaşım OWASP üçüncü taraf JavaScript kılavuzunu izler.

Destek kontrol listesi​

  • Adresin herkese açık bir HTTPS adresi olduğunu ve amaçlanan sağlayıcıya ait olduğunu doğrulayın.
  • Sağlayıcının, yayınlanmış origin üzerinde iframe yerleştirmeye izin verdiğini doğrulayın.
  • Ödeme veya tam ekranı yalnızca sağlayıcı dokümantasyonu gerektirdiğinde etkinleştirin.
  • Yayınlamadan önce gizlilik bildirimlerini ve izin davranışını gözden geçirin.
  • Yalnızca komut dosyasıyla çalışan widget'lar için sağlayıcı entegrasyonu isteğini kullanın; gizli bilgileri asla yapıştırmayın.