Guide för att konfigurera ASP.NET Framework SAML SSO med Azure B2C som IDP

Översikt

ASP.NET SAML Single Sign-On (SSO)-modul ger möjlighet att aktivera SAML enkel inloggning för dina ASP.NET-applikationer. Använda Enskilt inloggning du kan bara använda ett lösenord för att komma åt din ASP.NET-applikation och tjänster. Vår modul är kompatibel med alla SAML-kompatibla identitetsleverantörerHär går vi igenom en steg-för-steg-guide för att konfigurera Enkel inloggning (SSO) mellan ASP.NET och Azure B2C med tanke på Azure B2C som IdP.

Ladda ner Prissättning planer

Förutsättningar: Ladda ner och installation

• För att installera miniOrange SAML SSO NuGet-paket I din .NET-applikation installerar du helt enkelt miniOrange NuGet-paketet ovanpå din applikation.

NuGet-paketet

.NET CLI

PM> NuGet\Install-Package miniOrange.SAML.SSO

> dotnet lägg till paketet miniOrange.SAML.SSO

• Efter installationen öppnar du webbläsaren och bläddrar i modulens instrumentpanel med URL:en nedan:

 http(s)<your-dotnet-application-base-url>?ssoaction=config


• Om registreringssidan eller inloggningssidan dyker upp har du lagt till miniOrange SAML SSO-modulen i din applikation.

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

• Efter lyckad registrering får du en testlicensnyckel till din registrerade e-postadress.

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

OR

• Ladda upp licensfilen som du laddade ner genom att klicka på Klicka här knapp.

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

Konfigurationssteg

1. Tillhandahåll .NET-applikationsmetadata till Azure B2C Identity Provider

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

• I Menyn för plugininställningar, leta efter Inställningar för tjänsteleverantör. 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:

B] Ladda upp metadata manuellt

• Från Inställningar för tjänsteleverantör avsnitt, kan du manuellt kopiera tjänsteleverantörens metadata som SP Entity ID, ACS URL, Single Logout URL och dela den med din identitetsleverantör för konfiguration.

• Du kan hänvisa till skärmdumpen nedan:

Registrera applikationen Identity Experience Framework

• Logga in Azure B2C Portal.
• Från Azure AD B2C-klienten väljer du AppregistreringarOch väljer sedan Ny registrering.

• För Namn , ange IdentityExperienceFramework.
• Enligt Kontotyper som stöds, Välj Endast konton i den här organisationskatalogen.

• Enligt Omdirigera URI, välj Webb och ange sedan "https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com", där your-tenant-name är ditt Azure AD B2C-klientdomännamn.

• Enligt behörigheter, Välj Ge administratörsmedgivande till behörigheter för openid och offline_access kryssrutan.
• Klicka på Registrera.

• Spela in Program (klient) ID för användning i ett senare steg.

Registrera applikationen Identity Experience Framework

• Enligt hantera, Välj Exponera ett API.
• Välja Lägg till ett omfång, välj sedan Spara och fortsätt att acceptera standardprogram-ID-URI.

• Ange följande värden för att skapa ett omfång som tillåter anpassad policykörning i din Azure AD B2C-klient:
• Omfattningsnamn: användarimitation
• Visningsnamn för administratörssamtyckeÅtkomst till IdentityExperienceFramework
• Beskrivning av administratörens samtyckeTillåt att applikationen får åtkomst till IdentityExperienceFramework för den inloggade användarens räkning.

• Välja Lägg till omfattning.

Registrera applikationen ProxyIdentityExperienceFramework

• Välja AppregistreringarOch väljer sedan Ny registrering.
• För Namn , ange ProxyIdentityExperienceFramework.
• Enligt Kontotyper som stöds, Välj Endast konton i den här organisationskatalogen.

• Enligt Omdirigera URI, använd rullgardinsmenyn för att välja Offentlig klient/native (mobil & desktop).
• För Omdirigera URI, ange myapp://auth.
• Enligt behörigheter, markera kryssrutan Ge administratörssamtycke till behörigheter för openid och offline_access.
• Välja Registrera.

• Spela in Program (klient) ID för användning i ett senare steg.

Ange därefter att ansökan ska behandlas som en offentlig klient

• Enligt hantera, Välj Autentisering.
• Enligt Avancerade inställningar, Gör det möjligt Tillåt offentliga kundflöden (välj Ja).
• Välja Spara.

Ge nu behörigheter till API-omfattningen som du visade tidigare i IdentityExperienceFramework-registreringen

• Enligt hantera, Välj API-behörigheter.
• Enligt Konfigurerade behörigheter, Välj Lägg till en behörighet.

• Välj Mina API:er och välj sedan IdentityExperienceFramework ansökan.

• Enligt tillstånd, Välj user_impersonation omfattning som du definierade tidigare.
• Välja Lägg till behörigheter. Vänta några minuter enligt anvisningarna innan du fortsätter till nästa steg.

• Välja Ge administratörsmedgivande för (ditt hyresgästnamn).

• Välj ditt för närvarande inloggade administratörskonto eller logga in med ett konto i din Azure AD B2C-klient som har tilldelats åtminstone rollen som molnapplikationsadministratör.
• Välja Ja.
• Välja refresh, och kontrollera sedan att "Beviljas för ..." visas under Status för scopes - offline_access, openid och user_impersonation. Det kan ta några minuter innan behörigheterna sprids.

Registrera ASP.NET-applikationen

• Välj appregistreringar och sedan ny registrering.
• Ange ett namn för applikationen, till exempel: WP-app.
• Enligt Kontotyper som stöds, Välj Konton i en organisationskatalog eller vilken identitetsleverantör som helst. För autentisering av användare med Azure AD B2C.

• Enligt Omdirigera URI, välj Webb och ange sedan ACS URL från Inställningar för tjänsteleverantör fliken i miniOrange ASP.NET SAML-plugin.
• Välja Registrera.

• Enligt hantera, Klicka på Exponera ett API.
• Klicka på uppsättning för applikations-ID-URI och klicka sedan på Spara, accepterar standardvärdet.

• När du har sparat kopierar du applikations-ID-URI och navigerar till Tjänsteleverantörens metadata fliken i plugin-programmet.
• Klistra in det kopierade värdet under SP Entity ID / Emittent fältet på den här fliken.
• Klicka på Spara.

Generera SSO-policyer

• Från vår Azure B2C-portal, navigera till avsnittet Översikt för din B2C-klient och registrera ditt klientnamn.
  ANMÄRKNINGAROm din B2C-domän är b2ctest.onmicrosoft.com, då är ditt hyresgästnamn b2ctest.

• Ange din Azure B2C klientnamn nedan, tillsammans med program-ID:t för IdentityExperienceFramework- och ProxyIdentityExperienceFramework-apparna som registrerats i stegen ovan.

• Klicka på Generera Azure B2C-policyer knappen för att ladda ner SSO-policyerna.
• Extrahera den nedladdade zip-filen. Den innehåller policyfilerna och certifikatet (.pfx), som du behöver i följande steg.

Konfigurera och ladda upp certifikat

• Logga in på Azur portalen och bläddra till din Azure AD B2C-klient.

• Enligt policies, Välj Identity Experience Framework och då Policynycklar.

• Välja Lägg tillOch väljer sedan Alternativ > Ladda upp.
• Ange namnet som SamlIdpCert. Prefixet B2C_1A_ läggs automatiskt till i namnet på din nyckel.

• Använd uppladdningsfilkontrollen och ladda upp ditt certifikat som genererades i stegen ovan tillsammans med SSO-policyerna (tenantname-cert.pfx).
• Ange certifikatets lösenord som ditt klientnamn och klicka på Skapa. Om ditt klientnamn till exempel är xyzb2c.onmicrosoft.com anger du lösenordet som xyzb2c.
• Du bör kunna se en ny policynyckel med namnet B2C_1A_SamlIdpCert.

Skapa signeringsnyckeln

• På översiktssidan för din Azure AD B2C-klient, under policies, Välj Identity Experience Framework.
• Välja Policynycklar och välj sedan Lägg till.
• För Montering, välj Generera.
• In Namn , ange TokenSigningKeyContainer.
• För Nyckeltyp, välj RSA.
• För Nyckelanvändning, välj Signatur.

• Välja Skapa.

Skapa krypteringsnyckeln

• På översiktssidan för din Azure AD B2C-klient, under policies, Välj Identity Experience Framework.
• Välja Policynycklar och välj sedan Lägg till.
• För Montering, välj Generera.
• In Namn , ange TokenEncryptionKeyContainer.
• För Nyckeltyp, välj RSA.
• För Nyckelanvändning, välj Kryptering.

• Välja Skapa.

Ladda upp policyerna

• Välj Identity Experience Framework menyalternativ i din B2C-klient i Azure-portalen.

• Välja Ladda upp anpassad policy.

• Ladda upp policyfilerna som laddats ner i stegen ovan enligt följande ordning:
• TrustFrameworkBase.xml
• TrustFrameworkExtensions.xml
• SignUpOrSignin.xml
• ProfilEdit.xml
• PasswordReset.xml
• SignUpOrSigninSAML.xml

• När du laddar upp filerna lägger Azure till prefixet B2C_1A_ till var och en.

Du har konfigurerat Azure B2C som SAML IDP (identitetsleverantör) för att uppnå ASP.NET Single Sign-On (SSO).

2. Konfigurera metadata för AzureB2C-identitetsleverantörer i .NET-applikationen

• Klicka på Välj din IDP knappen för att konfigurera en ny identitetsleverantör.

• Enligt plugin Settings fliken, välj AzureB2C som din identitetsleverantör från listan som visas.

Det finns två sätt som beskrivs nedan för att konfigurera din SAML-identitetsleverantörs metadata 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) kan du helt enkelt konfigurera identitetsleverantörens metadata i modulen med hjälp av Ladda upp IDP-metadata alternativ.

• Kopiera metadata-URL eller ladda ned metadatafilen för att konfigurera densamma på din identitetsleverantör.

• Du kan hänvisa till skärmdumpen nedan:

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

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 SAML X509-certifikat fält respektive.

• Klicka Spara för att spara dina IDP-uppgifter.

3. Testa SAML SSO

• Efter att du har laddat upp metadatadetaljerna, navigera till Inställningar för identitetsleverantör sektionen. Håll muspekaren över Välj Åtgärder rullgardinsmenyn och klicka på Testkonfiguration.

• Skärmdumpen nedan visar ett lyckat resultat. Klicka på SSO-integration för att fortsätta med SSO-integrationen.

• Om du upplever något fel i modulens ände 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 loggfil från felsöka fliken för att se vad som gick fel.

• Du kan dela loggfil med oss ​​kl aspnetsupport@xecurify.com och vårt team kommer att kontakta dig för att lösa ditt problem.

4. Attributmappning

• Efter att ha testat konfigurationen, mappa dina applikationsattribut med attributen Identity Provider (IdP).

• Från vänstermenyn i miniOrange ASP.NET SAML SSO-modulen klickar du på Attribut/rollmappning fliken som visas på bilden.

• Om du vill skicka ytterligare attribut från din IdP anger du attributnamnet och motsvarande attributvärde under Anpassad attributmappning.

• Obs: Alla mappade attribut kommer att lagras i sessionen så att du kan komma åt dem i din applikation.

• När attributen är mappade klickar du på Spara attributmappning att tillämpa ändringar.

5. Integrationskod

• Med de här stegen kan du hämta SSO-användarinformationen i din applikation i form av en session.

• Du kan också titta på installationstur för att förstå hur SSO-integrationen skulle fungera i din asp.net-modulapplikation.

• Bara kopiera och klistra in det kodavsnittet där du vill komma åt användarattributen.

• Obs: Med testmodulen lagras de autentiserade användaruppgifterna i sessionsvariabler. Stöd för att ställa in användaranspråk med hjälp av Header-baserad, Forms-Cookie-baserad och JWT-baserad autentisering finns tillgängligt i vårt premium-plugin.

6. Inloggningsinställningar

• Hök på Välj Åtgärder och klicka på Kopiera SSO-länk.

• Använd följande URL som en länk i applikationen där du vill utföra SSO:

  https://<asp.net-module-base-url>/?ssoaction=login


• Du kan till exempel använda det som:

  <a href="https://<asp.net-module-base-url>/?ssoaction=login">Log in</a>


7. Logga ut Inställningar

• Använd följande URL som en länk till din applikation där du vill utföra SLO:

  https://<asp.net-module-base-url>/?ssoaction=logout


• Du kan till exempel använda det som:

  <a href="https://<asp.net-module-base-url>/?ssoaction=logout">Log out</a>


Relaterade artiklar

• ASP.NET SAML SSO
• ASP.NET OAuth SSO
• ASP.NET tvåfaktorsautentisering (2FA)

Hör av dig

Hör av dig till oss på aspnetsupport@xecurify.com, och vårt team hjälper dig att konfigurera ASP.NET Framework SAML SSO. Vårt team hjälper dig att välja den bästa lösningen/planen utifrån dina behov.