nopCommerce OAuth Single Sign-On (SSO) med Cognito som IDP

Översikt

nopCommerce OAuth Single Sign-On (SSO) plugin ger möjlighet att aktivera OAuth enkel inloggning för din nopCommerce-butik med hjälp av Cognito som OAuth-leverantör, Använda Enskilt inloggning Du kan bara använda ett lösenord för att komma åt din nopCommerce-butik och dina tjänster. Vår modul är kompatibel med alla OAuth-kompatibla identitetsleverantörerHär går vi igenom en steg-för-steg-guide för att konfigurera Enkel inloggning (SSO) mellan nopCommerce och Cognito.

Förutsättningar: Ladda ner och installation

• Ladda ner nopCommerce OAuth-modulen för enkel inloggning (SSO).
• För att installera pluginet, logga in som administratör i din nopCommerce-butik. I administratörspanelen, navigera till Fliken Konfiguration >> Lokala plugins.

• Klicka på Ladda upp plugin eller tema knappen längst upp till höger, klicka sedan på Välj fil i popup-fönstret, välj den nedladdade ZIP-filen för plugin-programmet och klicka på Ladda upp plugin eller tema att fortsätta.

• Efter att du har laddat upp pluginet klickar du på Starta om programmet för att tillämpa ändringarnaNär programmet har startat om visas plugin-programmet nedan. Klicka på installera knappen för att installera den och klicka sedan på Starta om programmet igen för att tillämpa ändringarna.

Konfigurationssteg

Steg-för-steg-guide för nopCommerce OAuth SSO med Cognito som identitetsleverantör.

• Efter lyckad installation, leta reda på plugin-programmet i listan och klicka på Inställd knappen för att fortsätta med installationen.

1. Aktivera SAML-pluginet med licensnyckeln

• När du klickar Inställd, kommer du att omdirigeras till licensaktiveringssidan och du kommer att få en testlicensnyckel till din registrerade e-postadress.
• Om du inte har fått licensnyckeln i den e-postadress du angett, använd Ladda ner licensnyckel knappen i pluginet för att ladda ner licensfilen.

• För att aktivera plugin-programmet kan du antingen:
  • Ange licensnyckel mottagen via e-post i det angivna inmatningsfältet.

  OR

  • Ladda upp licensfilen som du laddade ner med knappen som nämns ovan.

• Markera sedan rutan "Jag har läst ovanstående villkor och jag vill aktivera mellanprogramvaran", och klicka Aktivera licens knapp.

2. Konfigurera nopCommerce Callback URL i Cognito

• Efter lyckad licensaktivering öppnas plugin-instrumentpanelen enligt nedan.
• Klicka på Lägg till ny IDP knappen för att konfigurera en ny identitetsleverantör.

• Under fliken Plugin-inställningar väljer du Cognito som din identitetsleverantör från listan.

• När du har valt din identitetsleverantör från listan öppnas sidan för konfiguration av identitetsleverantör.
• I Inställningar för identitetsleverantör fliken hittar du Återuppringnings-URL under Omdirigera webbadresser sektion.
• Kopiera denna URL och ha den till hands, eftersom den kommer att krävas när du konfigurerar identitetsleverantören.
• Du kan också kopiera Omdirigerings-URL för utloggning från avsnittet Omdirigerings-URL:er för konfiguration av identitetsleverantör.

• Gå till Amazon konsol och registrera dig/logga in på ditt konto för att konfigurera Amazon Cognito.

• Sök efter Cognito i AWS tjänster sökfältet som visas nedan.

• Klicka på Skapa en användarpool för att skapa en ny användarpool.

• Välj de attribut i din användarpool som ska användas under inloggningsprocessen

• Ställ in ett starkt lösenord för att konfigurera dina säkerhetskrav. Gå vidare med "Ingen MFA" alternativet om du vill att användare endast ska logga in med en enda autentiseringsfaktor. Om du vill aktivera MFA (multifaktorautentisering) det kommer att kräva SMS-meddelanden som debiteras separat av Amazon SNS. Lär dig mer om det här.. Klicka Nästa.

• Konfigurera attribut som skulle krävas under användarregistreringsflöde.

• Välj ytterligare attribut om du vill. Klick Nästa.

• Konfigurera hur din användarpool skickar e-postmeddelanden till användare.

• Ange ett namn för din användarpool, även under Hosted autentiseringssidor, kolla upp "Använd Cognito Hosted UI".

• Välj nu domäntypen under avsnittet Domän "Använd en Cognito-domän". Ange ett domännamn för din Cognito-app.

• Enligt Initial appklient sektion, Ange ett namn för din appklient och kontrollera Skapa en klienthemlighet.

• Ange nu din Callback/Redirect URL som du får från din miniOrange-plugin som finns på din klientsida och klistra in den under Tillåtna återuppringningsadresser textfält. Se även följande bild för att välja autentiseringsflöden för din app.

• Nu, Under Avancerade appklientinställningar. Välj Identitetsleverantör as Cognito användarpool & Välj Behörighetskod beviljas under OAuth 2.0-bidragstyper och även välja öppet, e-mail och profil kryssrutor under OpenID Connect-omfattningar avsnitt (se bilden nedan). Klicka på Nästa knapp till spara dina konfigurationer.

• Granska nu ditt urval av krav. Klick Skapa användarpool för att bekräfta valet och skapa en användarpool.

• Efter att ha skapat din användarpool, Välj ditt poolnamn från listan över pooler för att börja med skapande av användare.

• Gå till fliken användare, och klicka Skapa användare.

• Ange detaljer som t.ex användarnamn, e-postadress och lösenord. Klicka på Skapa användare till spara detaljerna.

• Efter framgångsrikt skapande av användaren behöver du en kopia av Cognito domän, kund-IDoch Klienthemlighet. Gå till 'App Integration' och kopiera hela domännamn {ditt domännamn}.auth.{regionsnamn}.amazoncognito.com. Detta ska anges i ändpunktersfältet under i miniOrange nopCommerce OAuth-plugin.

• För att få den kund-ID och Klienthemlighet, håll dig kvar'App Integrationfliken ' och scrolla ner till 'Appklienter och analyser' sektion. Klicka på ditt app-klientnamn för att se kund-ID och Klienthemlighet.

Du har framgångsrikt konfigurerat Cognito som OAuth-server (identitetsleverantör) för att uppnå SSO-inloggning i din nopCommerce-butik eller applikation.

3. Konfigurera identitetsleverantörens klient-ID, klienthemlighet och slutpunkter i nopCommerce

• I Inställningar för identitetsleverantör fliken, bläddra ner till Leverantörskonfiguration sektion.
• Enligt Leverantörskonfiguration sektion, ange IdP-namn och tillhandahålla Klient-ID och klienthemlighet hämtad från Cognito-applikationen.

• Ange de obligatoriska slutpunkterna, t.ex. Auktoriseringsslutpunkt, tokenslutpunkt, resursslutpunkt och utloggningsslutpunkt i avsnittet Slutpunkter.
• Se tabellen nedan för att konfigurera endpoints Amazon Cognito i pluginet

Auktorisera slutpunkt:	https://<cognito-app-domain>/oauth2/authorize
Åtkomsttokens slutpunkt:	https://<cognito-app-domain>/oauth2/token
Resursslutpunkt:	https://<cognito-app-domain>/oauth2/resource

• Klicka på Spara inställningar för att spara din konfiguration.

4. Testar OAuth SSO

• När du har angett klient-ID, klienthemlighet och slutpunktsinformation, navigera tillbaka till instrumentpanelen. Klicka på de tre punkterna (⋮) bredvid den konfigurerade identitetsleverantören och välj Testkonfiguration.

• Vid lyckad konfiguration får du attributnamn och attributvärden i testkonfigurationsfönstret.

5. Attributmappning

• Enligt Attribut/rollmappning På fliken "mappera" attributnamnen som tillhandahålls av din identitetsleverantör med dina nopcommerce-butiksattribut.
• Klicka på Spara knapp.

• På fliken Attribut-/Rollmappning bläddrar du ner till Standardrollmappning avsnittet och välj rollen från Välj Roll rullgardinsmenyn som du vill tilldela användare som standard. Klicka sedan på Spara.

6. Lägger till SSO-länk för din nopCommerce-butik

• När du har sparat attributmappningen, navigera tillbaka till instrumentpanelen. Klicka på de tre punkterna (⋮) bredvid den konfigurerade identitetsleverantören och välj SSO-länk.
• SSO-länken kopieras automatiskt, och en "Kopierad till urklipp" aviseringen kommer att visas.

Relaterade artiklar

• nopCommerce SAML SSO
• nopCommerce tvåfaktorsautentisering
• nopCommerce OAuth SSO med ADFS som IDP