Treci la conținutul principal

Dală: încorporare externă (`externalEmbed`)

CâmpValoare
Identificator dalăexternalEmbed
Denumire în panoul de controlÎncorporare externă / Încorporare
Categoriebasic
Dimensiuniembedded

Dală pentru încorporări externe afișează un instrument de rezervare sau o altă pagină a unui terț direct într-o aplicație web publicată. Aplicațiile iOS și Android instalate afișează același iframe restricționat în Capacitor WebView.

Date acceptate​

Panoul de control acceptă fie:

  • O adresă HTTPS publică.
  • Marcaj cu exact un iframe și un atribut src între ghilimele.

Se salvează numai adresa iframe normalizată. Scoutello ignoră lățimea, înălțimea, stilurile, permisiunile, setările sandbox, gestionarii de evenimente, scripturile și marcajul furnizorului din jur. Sunt respinse adresele HTTP, datele de autentificare, porturile personalizate, adresele IP, gazdele locale sau interne, gazdele controlate de Scoutello și marcajul iframe incorect. Scoutello nu accesează, nu rezolvă, nu capturează și nu verifică în alt mod adresa trimisă.

Panoul de control afișează o previzualizare locală a configurației și nu contactează intenționat furnizorul. Rezultatul efectiv trebuie testat în aplicația web publicată.

Încărcare, confidențialitate și permisiuni​

Iframe-ul se încarcă automat, cu întârziere, când se apropie de zona vizibilă. Astfel, terțul poate fi contactat înainte ca o persoană să interacționeze cu dala. Nu există un mecanism integrat de încărcare la clic sau un proces de colectare a consimțământului.

Înainte de salvare, organizația trebuie să confirme că furnizorul este de încredere și că au fost luate în considerare informările de confidențialitate sau mecanismele de consimțământ necesare. Această confirmare documentează o decizie editorială, nu consimțământul vizitatorilor.

Înălțimile pentru mobil și desktop pot fi setate între 240 și 1.600 de pixeli. Valorile implicite sunt 640 de pixeli pe mobil și 720 pe desktop. Funcțiile de plată și de afișare pe tot ecranul sunt opționale și dezactivate implicit. Camera, microfonul, geolocalizarea, clipboardul, descărcările și navigarea la nivel superior nu sunt niciodată permise.

Mediul de execuție folosește setările sandbox și de politică a referentului definite în cod. Tokenurile sandbox sau de permisiuni furnizate de clienți nu ajung niciodată în iframe-ul afișat. Specificația WHATWG pentru iframe descrie semantica sandbox din browser.

Restricții de încorporare​

Furnizorii pot interzice încorporarea prin directiva Content Security Policy frame-ancestors sau antetul X-Frame-Options. Browserele nu oferă detalii fiabile despre erorile de încorporare între origini, astfel că Scoutello nu poate verifica compatibilitatea în panoul de control sau distinge întotdeauna refuzul încorporării de o pagină goală a furnizorului.

Dacă o configurație salvată devine nevalidă, vizualizarea pentru oaspeți afișează o eroare sigură, localizată și, când este posibil, o opțiune de deschidere într-o fereastră externă.

Furnizori care necesită scripturi​

Scripturile arbitrare ale furnizorilor nu pot rula pe o pagină Scoutello. O trimitere care conține doar un script este blocată și oferă în schimb Solicită integrarea furnizorului. Cererea colectează numele furnizorului, adresa publică a documentației, cazul de utilizare și un exemplu de script. Eliminați secretele, datele private de autentificare și datele personale înainte de trimitere.

Exemplul de script se salvează numai ca text simplu în cererea de asistență și nu este niciodată afișat ca element executabil sau rulat. Aprobarea nu activează acel fragment. Ea inițiază lucrări de produs pentru un adaptor verificat, găzduit într-un document izolat, pe o origine fără cookie-uri și cu domeniu înregistrabil separat, cu Content Security Policy specifică furnizorului și mesagerie verificată după origine. Acest lucru respectă recomandările OWASP pentru JavaScript terț.

Listă de verificare pentru asistență​

  • Confirmați că adresa este publică prin HTTPS și aparține furnizorului dorit.
  • Confirmați că furnizorul permite încorporarea iframe pe originea publicată.
  • Activați plata sau afișarea pe tot ecranul numai dacă documentația furnizorului le cere.
  • Verificați informările de confidențialitate și consimțământul înainte de publicare.
  • Pentru widgeturi bazate exclusiv pe scripturi, folosiți cererea de integrare a furnizorului; nu includeți niciodată secrete.