Single sign-on för Drupal-sajter
Den här sidan förklarar hur du integrerar ett SuperSaaS-schema i en webbplats byggd med Drupal, så att dina användare bara behöver logga in en gång för att komma åt både din webbplats och SuperSaaS-schemat på den. För att kunna använda det behöver du först skapa ett (kostnadsfritt) SuperSaaS-konto.
- Använd inloggningen från Drupal i dina SuperSaaS-scheman
- Installera och ställ in modulen i Drupal
- Ändra inställningarna i SuperSaaS
- Lägg till en bokningsknapp på dina sidor
- Tips vid felsökning
Använd inloggningsnamn från Drupal i ditt SuperSaaS-schema
SuperSaaS modul för Drupal visar en ”Boka nu”-knapp som automatiskt loggar in användaren i ett SuperSaaS-schema med hens användarnamn i Drupal. Om du inte använder användarregistreringen i Drupal bör du i stället följa de allmänna anvisningarna om hur du integrerar ett schema på din webbplats.
Knappen som modulen skapar skickar vidare informationen från användardatabasen i Drupal till SuperSaaS, så att användaren skapas i SuperSaaS databas eller får sina uppgifter uppdaterade vid behov. Då slipper användarna skapa en separat inloggning för bokningssystemet och behöver inte logga in två gånger.
Installera och ställ in modulen i Drupal
Följ de här stegen för att ställa in modulen i Drupal:
-
Installera modulen (Drupal 10.2 & 11).
Följ installationsanvisningarna under ”Releases” på projektsidan SuperSaaS Drupal module.
Markera sedan rutan bredvid modulens namn på sidan Extend för att aktivera den och klicka på .Gå nu till Manage>Configuration och klicka på SuperSaaS Settings.
Fyll i eller töm fälten och markera eller avmarkera ”Enable HTTPS” utifrån dina inställningar.Klicka på Manage>Structure i administrationsmenyn i Drupal och klicka sedan på Block layout. Klicka på Place Block vid det blockområde där du vill placera SuperSaaS-modulen. Leta upp blocket ”SuperSaaS login” och klicka på knappen Place Block bredvid det. Under ”Configure block” kan du ändra rubriken eller dölja den, och justera olika inställningar.
För kompatibilitet med äldre versioner av Drupal kan du ladda ned en version från sidan GitHub releases. -
Ställ in modulen. Fyll i sidan SuperSaaS Settings:
- SuperSaaS account name – Namnet på ditt konto (inte din e-postadress)
- SuperSaaS API key – Du hittar API-nyckeln för ditt SuperSaaS-konto längst ned på sidan Kontouppgifter.
- Schedule name – Du kan antingen ange namnet på ett schema eller en fullständig webbadress, om du vill lägga till parametrar som leder användaren till en viss vy. Om du använder fler än ett schema, se nedan.
- Button Label – Knappens text. Den är som standard ”Book Now” eller motsvarande på de språk som stöds. Om knappen har en bakgrundsbild används texten som alternativ text.
- Button image – Webbadressen till bakgrundsbilden. Fältet har inget standardvärde, så om du inte fyller i det får knappen ingen bakgrundsbild. Exempel:
- Custom Domain Name – Om du har skapat ett eget domännamn som pekar på ditt schema kan du ange det här, så att dina användare hamnar rätt.
- Enable HTTPS – Markera det här alternativet om du har aktiverat ”Kryptera anslutningen med SSL/TLS” för dina SuperSaaS-scheman.
(Se 
Ändra kontoinställningarna i SuperSaaS så att de fungerar med Drupal
Användardatabasen i Drupal är den primära källan, så ändringar av användaruppgifter på din Drupal-sajt förs över till SuperSaaS, men inte tvärtom. Därför rekommenderar vi att du inte låter dina användare ändra sina användaruppgifter i SuperSaaS, eftersom det lätt kan förvirra dem. Om en användare till exempel fick byta lösenord i SuperSaaS skulle hen förmodligen inte inse att lösenordet i Drupal fortfarande är detsamma.
Gör följande ändringar i ditt SuperSaaS-konto för att undvika inkonsekvenser:
- Välj på sidan Åtkomst
- Markera på sidan Åtkomst
- Fyll i fältet Din URL på sidan Layoutinställningar med webbadressen till den sida på din webbplats där användarna loggar in
Du behöver också se till att databasfälten i Drupal stämmer överens med dem i din användardatabas i SuperSaaS. Gör följande ändringar på sidan Åtkomst:
- Avmarkera
- Ställ in alternativknappen för E-post som då visas på Valfritt (eller Obligatoriskt)
- Ställ in alla andra fält på Fråga inte (du kan även stänga av fältet Lösenord om du har valt )
Nu kan du prova knappen på din webbplats. Som administratör behöver du fortfarande logga in via SuperSaaS vanliga inloggningssida, så det är bäst att prova som om du vore en vanlig användare. Om du vill ha superanvändare i SuperSaaS ska du se till att de har loggat in minst en gång med knappen innan du ändrar deras roll på sidan Användarhantering.
Konfigurera SuperSaaS
Bilden visar sidan Åtkomst i ditt SuperSaaS-konto när du har gjort inställningarna som beskrivs ovan.Lägg till knappen på dina sidor
Gå till Manage>Structure (Drupal 10.2 eller 11) i huvudmenyn och välj alternativet Block layout. Klicka sedan på Place block på ett lämpligt ställe på sidan. Du kan klicka på configure för att anpassa rubriken och välja på vilka sidor knappen ska visas.
Tips vid felsökning
- Observera att knappen bara visas för användare som är inloggade på din Drupal-sajt
- Om du ser felmeddelandet ”E-post är inte en giltig e-postadress” kan du läsa föregående avsnitt igen, för att kontrollera att du har gjort rätt inställningar i ditt SuperSaaS-konto
- Om knappen skickar användaren vidare men inte verkar logga in hen, och du har angett en webbadress i fältet Schedule name, kontrollera att domänen i den webbadressen är angiven i fältet Custom Domain Name