Hoppa till huvudinnehåll

Single Sign-On (SSO): konfigurera och testa SAML-inloggning

Konfigurera SAML-SSO för butikens kunder. Följ metadata, attribut, kundgrupper och teststeg och välj säkert hur kunderna ska logga in.

Med Single Sign-On (SSO) kan kunder logga in i din webbutik med företagets befintliga konto. Den här guiden gäller SAML 2.0 för kundinloggning, inte inloggning för butikens administratörer. SSO erbjuds som tillägg i Abicart Pro och behöver aktiveras av Abicart Support. Be support bekräfta tjänstens pris och omfattning för din butik.

  • Kontrollera Abicart Pro och bekräftad SSO-aktivering. Ha en administratör hos er identitetsleverantör till hands.

  • Skapa anslutningen i Abicart, byt metadata med identitetsleverantören och spara attributmappningen.

  • Testa rätt butik, nya och befintliga kunder samt deras kundgrupper innan SSO börjar krävas för alla.

  • Välj därefter om vanlig lösenordsinloggning ska finnas kvar. Automatisk omdirigering och blockering av andra inloggningsmetoder är två olika inställningar.

Välj rätt typ av anslutning

SAML 2.0 använder metadata och attributmappning enligt stegen nedan. OAuth2 och OpenID Connect (OIDC) använder andra inställningar. Om ni vill återanvända en befintlig inloggning från en annan webbplats behöver support först bekräfta vilken anslutning som passar; klistra inte in SAML-metadata som en lösning för ett OIDC-flöde.

Se SSO-tillägget för Abicart Pro för tjänstens kommersiella information. Stegen på den här sidan gäller SAML-anslutningen.

Det här behöver du

Ha gärna följande redo innan du börjar:

  • Åtkomst till administrationspanelen hos din identitetsleverantör, till exempel Azure AD, Google Workspace eller Okta

  • SAML-metadata som XML eller URL från identitetsleverantören

  • SSO aktiverat på ditt Abicart-konto av Abicart Support

  • Administratörsbehörighet i Abicart Admin

Konfigurera SSO i fyra steg

1 Skapa din SSO-konfiguration i Abicart Admin

Gå till Inställningar > Single-Sign-On i Abicart Admin och lägg till en ny konfiguration. Ge den ett namn, till exempel företagets namn, och spara.

När du sparar skapas Abicarts metadata-URL för konfigurationen. Du hittar den på samma sida under URL till Abicart-metadata. Kopiera URL:en direkt. Du behöver inte skriva in något eller fylla i några ID:n manuellt.

✓

Tips Låt gärna sidan vara öppen i en flik. I steg 3 går du tillbaka hit och klistrar in metadata från identitetsleverantören.

2 Skapa en SAML-applikation hos identitetsleverantören

Skapa en ny SAML-applikation för webbutiken hos din identitetsleverantör, till exempel Microsoft Azure AD. Klistra sedan in Abicarts metadata-URL som du kopierade i steg 1.

✓

Tips I Azure AD brukar identitetsleverantörens metadata-URL, som du behöver i steg 3, se ut ungefär så här:

https://login.microsoftonline.com/{tenant-id}/federationmetadata/2007-06/federationmetadata.xml?appid={app-id}

3 Lägg in identitetsleverantörens metadata i Abicart

Gå tillbaka till SSO-konfigurationen från steg 1 och fyll i följande:

Identitetsleverantörens metadata (XML eller URL)
Metadata som XML eller URL från identitetsleverantören i steg 2.

Mappning
Attributmappning i JSON-format. Se standardmappningen nedan.

Standardmappning för Microsoft Azure AD:

{
  "sub":         "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",
  "name":        "http://schemas.microsoft.com/identity/claims/displayname",
  "family_name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname",
  "given_name":  "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
  "email":       "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
}

Kontrollera vilket kundkonto inloggningen öppnar. Värdet i sub identifierar kundkontot. Kontrollera att värdet är unikt för rätt person och kommer från den betrodda identitetsleverantören. Ändra inte mappningen för befintliga kunder utan att först kontrollera hur deras konton ska kopplas. En lyckad inloggning räcker inte: kontrollera rätt kundkonto, orderhistorik och behörighet för både nya och befintliga kunder.

De viktigaste inställningarna:

Aktiv: Måste vara aktiverad. Annars fungerar inte konfigurationen.

Skapa saknad kund vid inloggning: Aktivera inställningen om ett kundkonto ska skapas automatiskt när kunden loggar in för första gången.

Uppdatera befintlig kund vid inloggning: Aktivera inställningen om kunduppgifterna ska uppdateras från identitetsleverantören vid inloggningen.

Inga andra inloggningsmetoder tillåtna: Låt inställningen vara avstängd om vanlig lösenordsinloggning fortfarande ska vara möjlig. Mer information finns längre ned.

4 Spara och testa

Klicka på Uppdatera för att spara och därefter på Test för att prova inloggningsflödet. Testa först med ett avsett testkonto. Kontrollera både en ny och en befintlig kund, rätt kundgrupp samt vilken butik kunden hamnar i. Om det inte fungerar, jämför metadata-URL:erna och attributmappningen med det som identitetsleverantören faktiskt skickar. Behåll en överenskommen reservväg till kundinloggningen tills testerna är klara.

Använda SSO i en multibutik

Varje webbutik har sin egen SSO-konfiguration. Det innebär att olika webbutiker inom samma multibutik kan ha olika inloggningslösningar.

  • Butik A kan kräva SSO för alla användare.

  • Butik B kan erbjuda både SSO och vanlig inloggning med lösenord.

  • Butik C kan fortsätta använda enbart vanlig lösenordsinloggning.

SSO-konfiguration och automatisk omdirigering ställs in per webbutik. Övriga butiker behåller sina egna inloggningsinställningar. Kundkonton kan däremot vara gemensamma med huvudbutiken. Om inställningen Uppdatera befintlig kund vid inloggning är aktiverad kan namn och e-postadress på det gemensamma kundkontot uppdateras vid SSO-inloggning i en underbutik. Kontrollera därför även hur uppdateringen påverkar samma kundkonto i de övriga butiker där det används. Separata SSO-inställningar innebär inte automatiskt separata kundregister.

Välj hur kunderna ska logga in

Inloggningen kan konfigureras på tre olika sätt, från det mest flexibla alternativet till det mest begränsade. Välj den lösning som bäst motsvarar hur kunderna ska logga in.

1. SSO som huvudsaklig inloggningsmetod

Kunderna loggar in via identitetsleverantören. Det här alternativet passar när SSO ska vara den huvudsakliga inloggningsmetoden, men kunderna inte behöver omdirigeras automatiskt så snart de besöker butiken.

Kan konfigureras i Admin: konfigurera och testa SSO-anslutningen direkt i Abicart Admin.

2. SSO och vanlig inloggning visas tillsammans

Kunderna ser båda alternativen på inloggningssidan och kan välja mellan SSO och vanlig inloggning med e-postadress och lösenord. Inloggningssidan behöver konfigureras så att båda alternativen visas.

Kräver hjälp från Abicart Support: kontakta support för att konfigurera en inloggningssida som erbjuder båda alternativen.

3. SSO krävs för alla, utan vanlig inloggning som alternativ

Kunder som inte redan är inloggade omdirigeras automatiskt till SSO så snart de besöker butiken, innan de når den vanliga inloggningssidan. Det går därför inte att använda lösenordsinloggning som reservlösning.

Kräver hjälp från Abicart Support: kontakta support för att lägga till automatisk SSO-omdirigering i det aktiva temat.

!

Välj endast det här alternativet om alla kunder ska logga in via identitetsleverantören. Den automatiska omdirigeringen gör att kunderna inte kan nå den vanliga inloggningssidan.

i

Om inställningen ”Inga andra inloggningsmetoder tillåtna” Den här inställningen är separat från den automatiska omdirigeringen. Aktivera den endast om andra inloggningsmetoder ska blockeras helt, även via en direktlänk till den vanliga inloggningssidan.

Kundgrupper baserat på SSO-konfiguration

Om flera SSO-konfigurationer är kopplade till samma webbutik kan varje konfiguration automatiskt placera kunderna i en egen kundgrupp. Det gör det enklare för flera företag att använda samma webbutik och samtidigt få olika priser, sortiment eller andra kundgruppsspecifika inställningar.

Exempel:

  • Kunder som loggar in via SSO-konfigurationen för Företag A kan placeras i kundgruppen A Personal.

  • Kunder som loggar in via SSO-konfigurationen för Företag B kan placeras i kundgruppen B Personal.

  • Kunder som loggar in via SSO-konfigurationen för Företag C kan placeras i kundgruppen C Personal. Kopplingen görs per SSO-konfiguration, inte genom att valfri e-postdomän automatiskt väljer kundgrupp.

Kundgruppen tilldelas när kunden loggar in genom den aktuella SSO-konfigurationen, för både nya och befintliga kundkonton. Tilldelningen lägger till den valda gruppen; den innebär inte att kundens övriga grupper tas bort. Kontrollera därför kundens samlade grupper och vilka priser och sortiment de ger tillgång till.

Tillgängligt i Admin: varje SSO-konfiguration kan kopplas till en egen kundgrupp via inställningen Assign to customer group.

Viktiga URL:er

Abicarts SSO-metadata
​https://saml.abicart.com/{SHOP_ID}/{SSO_ID}/meta

URL för test och SSO-inloggning
​https://saml.abicart.com/{SHOP_ID}/{SSO_ID}

SSO-inställningar i Admin
Abicart Admin > Inställningar > Single-Sign-On. Kontrollera rätt butik och befintliga konfigurationers namn om du inte hittar den anslutning du söker.

Behöver du hjälp?

Oavsett om du konfigurerar din första SSO-anslutning, använder flera identitetsleverantörer eller planerar en lösning för en multibutik hjälper vi dig gärna.

Kontakta Abicart Support, så hjälper vi dig vidare med konfigurationen.

Felsök inloggningen

Symtom

Kontroll och nästa steg

SSO-konfigurationen hittas inte

Kontrollera vald butik, behörighet och konfigurationens namn. En saknad menypost bevisar inte att en befintlig SSO-anslutning är avstängd. Kontakta support om du fortfarande inte hittar den.

Identitetsleverantören avvisar inloggningen

Be er IT-ansvariga kontrollera tilldelad användare, aktuell metadata, certifikat, Identifier/Entity ID och Reply URL/ACS mot Abicarts metadata. Använd inte exempeladresser från en annan applikation.

Inloggning fungerar men kunden får fel grupp eller sortiment

Kontrollera vilken SSO-konfiguration kunden använde, dess inställning Assign to customer group och kundens befintliga grupper. Logga in igen efter en rättning och kontrollera resultatet i rätt butik.

Vanlig inloggning går inte att nå

Kontrollera både automatisk omdirigering i temat och Inga andra inloggningsmetoder tillåtna. Ta hjälp av support och er IT-ansvariga innan fler begränsningar aktiveras.

Vid kontakt med support: ange butik, konfigurationens namn, tidpunkt, felmeddelande och om felet uppstår hos identitetsleverantören eller i Abicart. Skicka inte lösenord, inloggningsbiljetter eller en oredigerad SAML-respons med kunduppgifter i en vanlig supportfråga.

Fick du svar på din fråga?