Innehåll

Umbraco SAML Single Sign-On (SSO) med Onelogin som IDP

Umbraco SAML Single Sign-On (SSO) plugin ger möjlighet att aktivera SAML Single Sign-On för dina Umbraco-applikationer. Genom att använda Single Sign-On kan du bara använda ett lösenord för att komma åt din Umbraco-applikation och dina tjänster. Vårt plugin är kompatibelt med alla SAML-kompatibla identitetsleverantörer. Här kommer vi att gå igenom en steg-för-steg-guide för att konfigurera Single Sign-On (SSO) mellan Umbraco och Onelogin med tanke på Onelogin som IdP. För att veta mer om funktionerna vi tillhandahåller för Umbraco SSO, klicka här..

Välj din umbraco-version för att konfigurera SSO med:

Förutsättningar: Ladda ner och installation

Installera från NuGet butik
Manuell installation

NuGet-paketet
.NET CLI

PM> NuGet\Install-Package miniOrange.Umbraco8.SAML.SSO -Version 5.4.2

Download Umbraco SAML Single Sign-On (SSO)-modul.
För att ställa in modulen, extrahera umbraco-saml-sso-connector.zip, hittar du en DLL-fil miniorange-saml-sso.dll, en konfigurationsfil saml.config och en integration.md fil som innehåller stegen för att lägga till modulen i din applikation.

Lägg till miniorange-saml-sso.dll i bin-mappen (där dina andra DLL-filer finns) för din Umbraco-webbplats.
Registrera miniorangesamlsso modul för din umbraco SSO enligt de medföljande stegen i integration.md fil.
Lägg till den medföljande konfigurationsfilen saml.config i rotkatalogen för din umbraco-webbplats.

Lägg till referensen miniorange-saml-sso.dll fil i din Umbraco-applikation:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Lägg till miniOrange DLL-fil

Lägg till miniOrange-sso-konfiguration fil i din Umbraco-applikation.
I Startup.cs fil:

Lägg till namnområdet miniOrange.samlusing miniOrange.saml;
Uppdatera raderna för Umbraco middleware-kodavsnitt i Startup.Configure-metoden enligt nedan:

app.UseUmbraco()

                .WithMiddleware(u => { 

                    u.UseBackOffice();
            

                    u.UseWebsite();
            

                    u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
            

                }) 

                .WithEndpoints(u => { 

                    u.UseInstallerEndpoints();
            

                    u.UseBackOfficeEndpoints();
            

                    u.UseWebsiteEndpoints();
            

                });

Kör programmet när konfigurationen är klar.
Efter integrationen, öppna din webbläsare och bläddra i plugin-instrumentpanelen med URL:en nedan: https://<umbraco-application-base-url>/?ssoaction=config
Om registreringssidan eller inloggningssidan dyker upp har du framgångsrikt lagt till miniOrange Umbraco SAML-mellanvara i din Umbraco-applikation.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Umbracos inloggningssida

Registrera dig eller logga in med ditt konto genom att klicka på Registrera knappen för att konfigurera plugin-programmet

Efter integreringen öppnar du din webbläsare och bläddrar i anslutningspanelen med webbadressen nedan:
https://<your-application-base-url>/?ssoaction=config
Om registreringssidan eller inloggningssidan dyker upp har du framgångsrikt lagt till miniOrange Umbraco SAML SSO-anslutningen till din applikation.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Umbraco SAML Registration

Registrera dig eller logga in med ditt konto genom att klicka på Registrera för att konfigurera modulen.

Konfigurera Umbraco Single Sign-On (SSO) med OneLogin som IDP

1. Konfigurera Onelogin som IDP

Det finns nedan två sätt med vilka du kan få SAML SP-metadata att konfigurera på din OneLogin-ände.

A] Använda SAML-metadata-URL eller metadatafil:

Enligt Inställningar för tjänsteleverantör avsnittet kan du hitta metadata-URL samt möjligheten att ladda ner SAML-metadata
Kopiera metadata-URL eller ladda ned metadatafil för att konfigurera densamma på din OneLogin-sida.
Du kan hänvisa till skärmdumpen nedan

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Service provider metadata

B] Ladda upp metadata manuellt:

Från avsnittet Tjänsteleverantörsinställningar kan du kopiera tjänsteleverantörens metadata manuellt som SP Entity ID, ACS URL, Single Logout URL, och ge den till din identitetsleverantör för konfiguration.
Du kan hänvisa till skärmdumpen nedan

Enligt plugin Settings fliken, välj OneLogin som din identitetsleverantör från listan nedan:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Välj din IDP

Det finns två sätt som beskrivs nedan med vilka du kan få SAML SP-metadata att konfigurera på din identitetsleverantör.

A] Använda SAML-metadata-URL eller metadatafil:

Leta efter i menyn Plugin-inställningar Leverantör inställningar. Under det kan du hitta metadata-URLen samt möjligheten att ladda ner SAML-metadata.
Kopiera metadata-URL eller ladda ned metadatafilen för att konfigurera densamma på din identitetsleverantör. Du kan hänvisa till skärmdumpen nedan:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Ladda ner SP Metadata

B] Ladda upp metadata manuellt:

Från Leverantör inställningar kan du manuellt kopiera tjänsteleverantörens metadata som SP Entity ID, ACS URL, URL för enkel utloggning och dela den med din identitetsleverantör för konfiguration. Du kan hänvisa till skärmdumpen nedan:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Kopiera SP Metadata

Gå till onelogin.com, ange din domän och Logga in på OneLogin.
Logga in på OneLogin som administratör och gå till appar Företagsappar Lägg till Apps från Navbar.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Lägg till applikation

Skriv i sökrutan SAML Test Connector (SP) och klicka på appen för att lägga till den.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Sök-app

Ange visningsnamnet och klicka Save.
In Allmänna Inställningar, ange appnamn och klicka på Nästa.
Efter att ha sparat, gå till Konfigurationsfliken och skriv in följande:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - App Configuration

publik	Ge Målgrupps-URL från fliken Service Provider Metadata i plugin-programmet
Mottagare	Ge Mottagarens URL från fliken Service Provider Metadata i plugin-programmet
ACS (Consumer) URL Validator	Ge ACS (Assertion Consumer Service) URL från fliken Service Provider Metadata i plugin-programmet
ACS (Consumer) URL	Ge ACS (Assertion Consumer Service) URLfrån fliken Service Provider Metadata i plugin-programmet
URL för enkel utloggning	Ge URL för enkel utloggning från fliken Service Provider Metadata i plugin-programmet

Klicka på Spara.

miniorange img Tilldela grupper/personer

Gå till Fliken SSO. Anteckna URL/slutpunkter. Dessa kommer att krävas när du konfigurerar plugin-programmet.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Aktivera SAML SSO

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Lägg till certifikat_X.509

Du har framgångsrikt konfigurerat OneLogin som SAML IdP (Identity Provider) för att uppnå Umbraco Single Sign-On (SSO).

2. Konfigurera Umbraco som SP

Notera: Efter installationen av plugin-programmet måste vi ställa in förtroendet mellan din Umbraco-applikation och OneLogin. SAML-metadata delas med OneLogin så att de kan uppdatera sin inbyggda konfiguration för att stödja enkel inloggning.

2.1: Dela SAML-metadata med OneLogin

Klicka på Lägg till ny IDP för att konfigurera Umbraco Single Sign-On (SSO) med OneLogin.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Lägg till ny IDP

Enligt Inställningar för tjänsteleverantör fliken kan du antingen kopiera och klistra in metadata-URL på din IDP-sida eller ladda ner SP-metadata som en XML-fil. Dessutom kan du välja att manuellt kopiera och klistra in Grundadress, SP Entity IDoch ACS URL.
Dela SAML-metadata med din identitetsleverantör.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - SP Settings Metadata

2.2: Importera OneLogin SAML-metadata

Välja OneLogin från listan över identitetsleverantörer som visas nedan.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Välj identitetsleverantör

Nedan finns två sätt som du kan konfigurera din SAML-identitetsleverantörs metadata med i modulen.

A] Ladda upp metadata med knappen Ladda upp IDP-metadata:

Om din identitetsleverantör har försett dig med metadata-URL eller metadatafil (endast .xml-format) konfigurerar du helt enkelt identitetsleverantörens metadata i modulen med hjälp av Ladda upp IdP-metadata alternativ.
Du kan hänvisa till skärmdumpen nedan

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Ladda upp metadata

Du kan välja vilket som helst av alternativen enligt det metadataformat du är tillgänglig med.

B] Konfigurera identitetsleverantörens metadata manuellt:

Efter att ha konfigurerat din Identitetsleverantör, kommer det att ge dig IDP Entity ID, IDP Single Sign On URL och x.509 Certifikat. Konfigurera dessa värden under IDP Entity ID, Single Sign-On URL och SAML X509-certifikat fält respektive.
Klicka Save för att spara dina IDP-uppgifter.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Ange IDP-metadata

Du har framgångsrikt konfigurerat din Umbraco-applikation som en tjänsteleverantör.

Det finns två sätt som beskrivs nedan med vilka du kan konfigurera din SAML-identitetsleverantörs metadata i plugin-programmet.

A] Ladda upp metadata med knappen Ladda upp IDP-metadata:

Om din identitetsleverantör har försett dig med metadata-URL eller metadatafil (endast .xml-format) kan du helt enkelt konfigurera identitetsleverantörens metadata i plugin-programmet med hjälp av Ladda upp IDP-metadata alternativ. Du kan hänvisa till skärmdumpen nedan:

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Ladda upp IDP-metadata

Du kan välja vilket som helst av alternativen enligt det metadataformat du har tillgängligt.

B] Konfigurera identitetsleverantörens metadata manuellt:

När du har konfigurerat din identitetsleverantör kommer den att förse dig med IDP-enhets-ID, IDP Single Sign On URL och SAML X509-certifikat fält respektive.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Ange IDP-metadata manuellt

Klicka Save för att spara dina IDP-uppgifter

3. Testa SAML SSO

Innan du testar, kontrollera följande:

Umbraco (SP) SAML-metadata har exporterats till OneLogin (IDP).
Importera OneLogin (IDP) SAML-metadata i Umbraco (SP).

För att testa om SAML-konfigurationen du har gjort är korrekt, gå till Välj Åtgärder Klicka sedan på Testkonfiguration.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Testa SAML SSO

Notera: I testversionen av pluginet kan du bara konfigurera och testa en identitetsleverantör (IDP).
Skärmdumpen nedan visar ett lyckat resultat. Klicka på Färdig för att fortsätta med SSO-integrationen.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Testar SAML SSO

Om du upplever något fel i modulens ände kommer du att visas med fönstret som liknar nedan.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Error Window

För att felsöka felet kan du följa stegen nedan:

Enligt Felsökning fliken, aktivera växeln för att ta emot pluginloggarna.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Aktivera felsökningsloggar

När det är aktiverat kommer du att kunna hämta pluginloggar genom att navigera till Inställningar för identitetsleverantör fliken och klicka på Testkonfiguration.
ladda ner loggfil från felsöka fliken för att se vad som gick fel.
Du kan dela loggfil med oss kl umbracosupport@xecurify.com och vårt team kommer att kontakta dig för att lösa ditt problem.

Klicka på Testkonfiguration för att testa om SAML-konfigurationen du har gjort är korrekt.
Skärmdumpen nedan visar ett lyckat resultat. Klicka på SSO-integration för att fortsätta med SSO-integrationen.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - framgångsrik testkonfiguration

Om du upplever något fel i plugin-änden kommer du att visas med fönstret som liknar nedan.
För att felsöka felet kan du följa stegen nedan:
- Enligt felsöka fliken, aktivera växeln för att ta emot pluginloggarna.
- När det är aktiverat kommer du att kunna hämta pluginloggar genom att navigera till plugin Settings fliken och klicka på Testkonfiguration.
- Ladda ner loggfilen från fliken Felsökning för att se vad som gick fel.
- Du kan dela loggfilen med oss på umbracosupport@xecurify.com och vårt team kommer att kontakta dig för att lösa ditt problem.

4. Inloggningsinställningar

Gå till Välj Åtgärder och klicka på Kopiera SSO-länk.

Umbraco SAML Single Sign-On (SSO) med OneLogin som IDP - Kopiera SSO-länk

Använd den kopierade länken i applikationen varifrån du vill utföra SSO
Du kan till exempel använda den som:
<a href="copied-sso-link”>Login</a>"

Använd följande URL som en länk i applikationen där du vill utföra SSO: https://<umbraco-application-base-url>/?ssoaction=login

5. Logga ut Inställningar

Använd följande URL som en länk i din Umbraco varifrån du vill utföra SLO:
https://umbraco-base-url/?ssoaction=logout
Du kan till exempel använda den som:
<a href="https://umbraco-base-url/?ssoaction=logout”>Logout</a>"

Du kan till och med konfigurera nopCommerce SAML Single Sign-On (SSO) modul med eventuella identitetsleverantörer som t.ex ADFS, Azure AD, Bitium, Centrify, G Suite, JBoss Keycloak, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML, WSO2 eller till och med med din egen anpassade identitetsleverantör. Kontrollera listan över identitetsleverantörer här..

Ytterligare resurser

Behöver hjälp?

Kan du inte hitta din identitetsleverantör? Maila oss vidare umbracosupport@xecurify.com och vi hjälper dig att ställa in SSO med din IDP och för snabb vägledning (via e-post/möte) om ditt krav och vårt team hjälper dig att välja den bästa lämpliga lösningen/planen enligt dina krav.

Innehåll

Umbraco SAML Single Sign-On (SSO) med Onelogin som IDP

Förutsättningar: Ladda ner och installation