Siirry pääsisältöön

Ruutu: ulkoinen upotus (`externalEmbed`)

KenttäArvo
Ruudun tunnisteexternalEmbed
Hallintapaneelin nimiUlkoinen upotus / Einbettung
Luokkabasic
Kootembedded

Ulkoisen upotuksen ruutu näyttää ajanvaraus työkalun tai muun kolmannen osapuolen sivun suoraan julkaistussa verkkosovelluksessa. Asennetut iOS- ja Android-sovellukset näyttävät saman rajoitetun iframen Capacitor WebView -näkymässä.

Hyväksytty syöte​

Hallintapaneeli hyväksyy jommankumman seuraavista:

  • Julkinen HTTPS-URL-osoite.
  • Merkintä, joka sisältää yhden iframen ja yhden lainausmerkeillä ympäröidyn src-määritteen.

Vain normalisoitu iframe-URL-osoite tallennetaan. Scoutello ohittaa palveluntarjoajan toimittamat leveys- ja korkeustiedot, tyylit, käyttöoikeudet, sandbox-asetukset, tapahtumankäsittelijät, skriptit ja kaiken muun ympäröivän merkinnän. HTTP-osoitteet, tunnistetiedot, mukautetut portit, IP-osoitteet, paikalliset tai sisäiset isännät, Scoutellon hallitsemat isännät ja virheellinen iframe-koodi hylätään. Scoutello ei hae, selvitä, kaappaa näyttökuvaa tai muuten tutki lähetettyä URL-osoitetta.

Hallintapaneeli näyttää paikallisen määritys esikatselun eikä tarkoituksella ota yhteyttä palveluntarjoajaan. Testaa todellinen tulos julkaistussa verkkosovelluksessa.

Lataus, yksityisyys ja käyttöoikeudet​

Iframe latautuu automaattisesti ja viivästetysti, kun se lähestyy näkyvää aluetta. Tämä voi ottaa yhteyttä kolmannen osapuolen palveluntarjoajaan ennen kuin kävijä käyttää ruutua. Sisäänrakennettua kävijän napsautuksella käynnistettävää latausta tai suostumusten hallintaa ei ole.

Ennen tallentamista organisaation on vahvistettava, että palveluntarjoajaan luotetaan ja että tarvittavat tietosuojailmoitukset tai suostumusten käsittely on hoidettu. Tämä vahvistus tallentaa määrityksen laatimista koskevan päätöksen; se ei ole kävijän suostumus.

Mobiili- ja työpöytänäkymän korkeudeksi voi määrittää 240–1 600 pikseliä. Oletusarvot ovat mobiilissa 640 pikseliä ja työpöydällä 720 pikseliä. Maksu- ja koko näytön selaintoiminnot ovat valinnaisia ja oletusarvoisesti poissa käytöstä. Kameraa, mikrofonia, sijaintia, leikepöytää, latauksia tai ylätason navigointia ei koskaan sallita.

Ajoaika käyttää koodin määrittämiä sandbox- ja viittaajapolitiikan asetuksia. Asiakkaan toimittamat sandbox- tai käyttöoikeustunnisteet eivät koskaan päädy renderöityyn iframeen. Katso WHATWG:n iframe-määrityksestä selaimen sandbox-toiminnan semantiikka.

Kehystämisen rajoitukset​

Palveluntarjoajat voivat estää upottamisen Content Security Policy -käytännön frame-ancestors direktiivillä tai X-Frame-Options-otsakkeella. Koska selaimet eivät tarjoa luotettavia tietoja eri alkuperien välisen kehystämisen epäonnistumisesta, Scoutello ei voi vahvistaa yhteensopivuutta hallintapaneelissa eikä aina erottaa palveluntarjoajan estoa tyhjästä palveluntarjoajan sivusta.

Jos tallennettu määritys muuttuu virheelliseksi, vierailijan näkymässä näytetään turvallinen lokalisoitu virhetila ja mahdollisuuksien mukaan vaihtoehto avata sisältö ulkoisesti.

Skriptejä edellyttävät palveluntarjoajat​

Palveluntarjoajan mielivaltaiset skriptit eivät voi suorittaa koodia Scoutello-sivulla. Pelkän skriptin sisältävä lähetys estetään ja sen sijaan tarjotaan Pyydä palveluntarjoajan integraatiota. Pyynnössä kerätään palveluntarjoajan nimi, julkinen dokumentaatio-URL, aiottu käyttötapaus ja skrip tinäyte. Poista siitä salaisuudet, yksityiset tunnistetiedot ja henkilötiedot ennen lähettämistä.

Skriptinäyte tallennetaan vain pelkkänä tukipyynnön tekstinä, eikä sitä koskaan renderöidä tai suoriteta. Hyväksyntä ei ota kyseistä katkelmaa käyttöön. Sen perusteella käynnistetään tuotekehitystyö tarkastetun palveluntarjoajasovittimen toteuttamiseksi. Sovitin isännöidään sandboxatussa dokumentissa evästeettömässä, erikseen rekisteröitävissä olevassa alkuperässä, jossa käytetään palveluntarjoajakohtaista Content Security Policy -käytäntöä ja alkuperän tarkistavaa viestintää. Tämä noudattaa OWASP:n kolmannen osapuolen JavaScript-ohjeistusta.

Tuen tarkistuslista​

  • Vahvista, että osoite on julkinen HTTPS-osoite ja kuuluu tarkoitetulle palveluntarjoajalle.
  • Vahvista, että palveluntarjoaja sallii iframe-upotukset julkaistussa alkuperässä.
  • Ota maksu- tai koko näytön toiminto käyttöön vain, jos palveluntarjoajan dokumentaatio sitä edellyttää.
  • Tarkista tietosuojailmoitukset ja suostumusten käsittely ennen julkaisua.
  • Käytä palveluntarjoajan integraatiopyyntöä vain skriptiä käyttäville pienoisohjelmille. Älä koskaan liitä mukaan salaisuuksia.