Umbraco SAML Single Sign-On (SSO) med Salesforce 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 Salesforce med tanke på Salesforce som IdP. För att veta mer om funktionerna vi tillhandahåller för Umbraco SSO, klicka här..

Förutsättningar: Ladda ner och installation

• 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 a integration.md fil som innehåller stegen för att lägga till modulen i din applikation.

1. Lägg till modul i Umbraco Application

• 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.
• Efter integrationen öppnar webbläsaren och bläddrar i modulens instrumentpanel med URL nedan:
  https://<umbraco-base-url>/?ssoaction=config
• Om det dyker upp registreringssidan eller inloggningssidan har du framgångsrikt lagt till miniOrange saml sso-modulen för din applikation.

• Registrera or Logga in för att konfigurera modulen.

2. Konfigurera Salesforce som IDP

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

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

• Under avsnittet Tjänsteleverantörsinställningar 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 identitetsleverantör.
• Du kan hänvisa till nedanstående skärmdump:
  
  

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 nedanstående skärmdump:
  
  

• Logga in på ditt Salesforce konto som admin.
• Växla till Salesforce Lightning läge från profilmenyn och gå sedan till Inställning sida genom att klicka på inställningsknappen.


• Välj från den vänstra rutan Fliken Inställningar och klicka på Identitetsleverantör.


• Klicka på Aktivera identitetsleverantör.


• I Leverantör klicka på länken för att skapa Leverantör med hjälp av Anslutna appar.


• ange Ansluten appnamn, API-namn och Kontakt E.

Ansluten appnamn	Ange ett namn för Connected App
API-namn	Ange ett API-namn
Kontakt E	Ange en kontakt-e-post



• Enligt Inställningar för webbapp, kolla Aktivera SAML kryssrutan och ange följande värden:

Aktivera SAML	Kontrollerade
Enhets-ID	SP-EntityID / Emittent från Tjänsteleverantörens metadata fliken i plugin-programmet
ACS URL	ACS (AssertionConsumerService) URL från Tjänsteleverantörens metadata fliken i plugin-programmet
Typ av ämne	Användarnamn
Namn ID-format	urn:oasis:names:tc:SAML:2.0:nameid-format:unspecificated



• Klicka på Save för att spara konfigurationen.
• Nu från den vänstra rutan, under Plattformsverktyg avsnittet väljer Anslutna appar.
• Välj sedan Hantera anslutna appar och klicka på appen du just skapade.


• I Profiler avsnitt klicka Hantera profiler knapp.
• Tilldela Profiler du vill ge åtkomst att logga in via denna app.


• Enligt SAML inloggningsinformation, Klicka på Ladda ner metadata.


• Håll denna metadata till hands för att konfigurera Leverantör.

Du har framgångsrikt konfigurerat Salesforce som SAML IdP (Identity Provider) för att uppnå Salesforce SSO-inloggning i din Umbraco-applikation.

3. Konfigurera Umbraco som SP

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
  
  
• 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.

4. Testa konfigurationen

• Klicka på Testkonfiguration för att testa om SAML-konfigurationen du har gjort är korrekt eller inte.
• Skärmdumpen nedan visar ett lyckat resultat.

5. Attributmappning

• Kartlägg dina umbraco-attribut med attributen Identity Provider (IdP).

• Klicka på Spara attributmappning knappen för att spara inställningarna.

6. Inloggningstyp

Umbraco-plattformen stöder två olika sätt att logga in:

7. Inloggningsinställningar

• Använd följande URL som en länk på din Umbraco-webbplats där du vill initiera SSO:
  https://umbraco-base-url/?ssoaction=login
• Du kan till exempel använda den som:
  <a href="https://umbraco-base-url/?ssoaction=login”>Login</a>"

8. 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 konfigurera Umbraco SAML 2.0 Single Sign-On (SSO)-modulen med valfri identitetsleverantör som t.ex. ADFS, Azure AD, Bitium, Centrify, G Suite, JBoss Keycloak, Okta, OneLogin, WordPress, 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

• DNN SAML Single Sign-On (SSO)
• Umbraco SAML Single Sign-On (SSO)
• ASP.NET SAML Single Sign-On (SSO)
• nopCommerce SAML Single Sign-On (SSO)
• DNN REST API-autentisering