Implementera Atlas Embed

För att komma igång med Atlas Embed på er webbplats så krävs det en del grunder. Men när allt är konfigurerat korrekt så kommer Atlas laddas i er webbplats på ett sömlöst vis.

Vad är Atlas Embed?

Atlas Embed är en javascript-lösning för att skapa en automatisk "iframe" på er webbplats som i sin tur laddar er Atlas-webb i er egen webblösning. Historiskt sett så har detta inneburit en hel del problem då den här iframe:n kunnat haft eget scroll, samt att det inte går att bokmärka eller länka till "undersidor" som är laddade i iframe:n. Men med vårt javascript så löses detta automatiskt.

Hur funkar det?

Scriptet laddas från er Atlaswebb, skapar en "iframe" och laddar sedan till exempel Tjänsteguiden eller annan Atlas-applikation där ni valt att inkludera den. Scriptet ser sedan till att ramen den laddas i alltid har rätt höjd så man slipper scrollning mitt i sidan. Sedan uppdaterar den även sidans "hash", det vill säga en textsträng som visas efter ett #-tecken i sökvägen, på så sätt så kan man sätta ett bokmärke, eller länka till en specifik undersida

Kom igång

Detta är stegen för att komma igång med Atlas Embed:

Ni pekar en underdomän till Atlas

Detta är det viktigaste steget, för Atlas Embed måste laddas från en underdomän till den domän som scriptet implementeras på. Anledningen till detta är att de flesta webbläsare tillåter inte att cookies sparas om det laddas via en annan toppdomän. Så om er toppdomän är stadsnätet.se så måste Atlas Embed laddas via till exempel embed.stadsnätet.se som ni pekar på Atlas.

DNS-information. Om ni inte har en Atlas-web idag så är det också en idé att peka atlas.stadsnätet.se så kan vi ge den sidan en lite mer användarvänlig design för administration. Använd supportloggen för att meddela oss när ni pekat domänen så att er Atlaswebb tar emot den korrekt.

Aktivera Atlas Embed

När ni har verifierat att pekningen funkar och ni kommer till Atlas-webben när ni besöker den nya underdomänen, samt att SSL funkar som det ska så går ni till Atlas CMSInställningarEmbed och aktiverar Atlas Embed. Där anger ni vilka URL:er som ska godkännas att ladda Atlas Embed (här anger ni alltså www.stadsnätet.se bland annat). Där väljer ni också vilken konfigurerad domän som är er Embed-domän för Atlas.

Ni implementerar vårt Embed-script

Detta är den enklaste delen. På en undersida på er sida så klistrar ni in något av de exempel-script som visas när ni konfigurerat ovanstående och sparat. Ni får exempel på till exempel Tjänsteguiden och Anslutamotorn men även andra publika webapplikationer.

Tänk på

Om ni använder säkerhetspolicy för innehåll (Content Security Policy) så måste ni tillåta att den URL som ni laddar (i exemplet "embed.stadsnätet.se") som tillåtet innehåll för "frame-src" och "frame-ancestors" för att det ska fungera.