मुख्य कंटेंट पर जाएँ

टाइल: बाहरी एम्बेड (`externalEmbed`)

फ़ील्डमान
टाइल पहचानकर्ताexternalEmbed
डैशबोर्ड लेबलExternal embed / Einbettung
श्रेणीbasic
आकारembedded

बाहरी-एम्बेड टाइल किसी प्रकाशित वेब ऐप में बुकिंग टूल या किसी अन्य तृतीय-पक्ष पेज को सीधे दिखाती है। इंस्टॉल किए गए iOS और Android ऐप भी उसी प्रतिबंधित iframe को अपने Capacitor WebView के भीतर रेंडर करते हैं।

स्वीकार्य इनपुट​

डैशबोर्ड इनमें से कोई एक स्वीकार करता है:

  • सार्वजनिक HTTPS URL।
  • एक iframe वाला ऐसा मार्कअप, जिसमें एक उद्धृत src एट्रिब्यूट हो।

केवल सामान्यीकृत iframe URL संग्रहीत किया जाता है। Scoutello प्रदाता द्वारा दिए गए width, height, styles, permissions, sandbox सेटिंग, event handlers, scripts और आसपास के सभी मार्कअप को अनदेखा करता है। HTTP पते, क्रेडेंशियल, कस्टम पोर्ट, IP पते, स्थानीय/आंतरिक होस्ट, Scoutello-नियंत्रित होस्ट और गलत iframe कोड अस्वीकार किए जाते हैं। Scoutello सबमिट किए गए URL को फ़ेच, रिज़ॉल्व, स्क्रीनशॉट या किसी अन्य तरीके से प्रोब नहीं करता।

डैशबोर्ड स्थानीय कॉन्फ़िगरेशन प्रीव्यू दिखाता है और जानबूझकर प्रदाता से संपर्क नहीं करता। वास्तविक परिणाम को प्रकाशित वेब ऐप में टेस्ट करें।

लोडिंग, गोपनीयता और अनुमतियाँ​

दृश्य क्षेत्र के पास पहुँचने पर iframe अपने-आप और लेज़ी तरीके से लोड होता है। इससे विज़िटर के टाइल के साथ इंटरैक्ट करने से पहले ही तृतीय-पक्ष प्रदाता से संपर्क हो सकता है। विज़िटर के लिए बिल्ट-इन क्लिक-टू-लोड या सहमति-प्रबंधन प्रवाह उपलब्ध नहीं है।

सहेजने से पहले, संगठन को स्वीकार करना होगा कि प्रदाता विश्वसनीय है और आवश्यक गोपनीयता सूचनाओं या सहमति-प्रबंधन की व्यवस्था की जा चुकी है। यह स्वीकृति सामग्री तैयार करने का निर्णय दर्ज करती है; यह विज़िटर की सहमति नहीं है।

मोबाइल और डेस्कटॉप की ऊँचाई 240 से 1,600 पिक्सेल तक सेट की जा सकती है। डिफ़ॉल्ट रूप से मोबाइल पर ऊँचाई 640 पिक्सेल और डेस्कटॉप पर 720 पिक्सेल होती है। भुगतान और फ़ुलस्क्रीन ब्राउज़र क्षमताएँ वैकल्पिक हैं और डिफ़ॉल्ट रूप से अक्षम रहती हैं। कैमरा, माइक्रोफ़ोन, जियोलोकेशन, क्लिपबोर्ड, डाउनलोड और शीर्ष-स्तरीय नेविगेशन की अनुमति कभी नहीं दी जाती।

रनटाइम कोड-नियंत्रित sandbox और referrer-policy सेटिंग का उपयोग करता है। ग्राहक द्वारा दिए गए sandbox या permission टोकन रेंडर किए गए iframe तक कभी नहीं पहुँचते। ब्राउज़र sandbox के अर्थ के लिए WHATWG iframe specification देखें।

फ़्रेमिंग सीमाएँ​

प्रदाता Content Security Policy frame-ancestors निर्देश या X-Frame-Options हेडर के माध्यम से एम्बेडिंग रोक सकते हैं। चूँकि ब्राउज़र क्रॉस-ओरिजिन फ़्रेमिंग विफलता का विश्वसनीय विवरण उपलब्ध नहीं कराते, Scoutello डैशबोर्ड में संगतता सत्यापित नहीं कर सकता और हमेशा यह अलग नहीं कर सकता कि प्रदाता ने अनुरोध अस्वीकार किया है या प्रदाता का पेज खाली है।

यदि सहेजा गया कॉन्फ़िगरेशन अमान्य हो जाता है, तो अतिथि अनुभव सुरक्षित, स्थानीयकृत त्रुटि स्थिति दिखाता है और, जहाँ संभव हो, बाहरी रूप से खोलने का विकल्प देता है।

ऐसे प्रदाता जिन्हें स्क्रिप्ट की आवश्यकता होती है​

मनमानी प्रदाता स्क्रिप्ट Scoutello पेज में नहीं चल सकतीं। केवल-स्क्रिप्ट सबमिशन को ब्लॉक कर दिया जाता है और इसके बजाय Request provider integration विकल्प दिया जाता है। इस अनुरोध में प्रदाता का नाम, सार्वजनिक दस्तावेज़ URL, इच्छित उपयोग का मामला और स्क्रिप्ट का नमूना लिया जाता है। सबमिट करने से पहले रहस्य, निजी क्रेडेंशियल और व्यक्तिगत डेटा हटा दें।

स्क्रिप्ट का नमूना केवल सादे सहायता-अनुरोध टेक्स्ट के रूप में संग्रहीत किया जाता है और कभी रेंडर या निष्पादित नहीं किया जाता। स्वीकृति से उस स्निपेट की सुविधा उपलब्ध नहीं होती। इसके बजाय समीक्षा किए गए प्रदाता अडैप्टर के लिए उत्पाद कार्य तैयार होता है। यह अडैप्टर cookieless, अलग से रजिस्टर किए जा सकने वाले origin पर sandbox किए गए दस्तावेज़ में होस्ट किया जाता है और इसमें प्रदाता-विशिष्ट Content Security Policy तथा origin-जाँचा गया messaging होता है। यह OWASP third-party JavaScript guidance के अनुरूप है।

सहायता चेकलिस्ट​

  • पुष्टि करें कि पता सार्वजनिक HTTPS है और इच्छित प्रदाता का है।
  • पुष्टि करें कि प्रदाता प्रकाशित origin पर iframe एम्बेडिंग की अनुमति देता है।
  • भुगतान या फ़ुलस्क्रीन केवल तभी सक्षम करें, जब प्रदाता के दस्तावेज़ में इसकी आवश्यकता हो।
  • प्रकाशन से पहले गोपनीयता सूचनाओं और सहमति व्यवहार की समीक्षा करें।
  • केवल-स्क्रिप्ट विजेट के लिए provider-integration request का उपयोग करें; रहस्य कभी पेस्ट न करें।