Inhalte

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP

ASP.NET Core SAML Single Sign-On (SSO) Middleware bietet die Möglichkeit, SAML Single Sign-On für Ihre ASP.NET-Kernanwendungen zu aktivieren. Mit Single Sign-On können Sie nur ein Passwort verwenden, um auf Ihre ASP.NET-Kernanwendung und -Dienste zuzugreifen. Unsere Middleware ist mit allen SAML-kompatiblen Identitätsanbietern kompatibel. Hier gehen wir eine Schritt-für-Schritt-Anleitung durch, um Single Sign-On (SSO) zwischen ASP.NET Core und Auth0 unter Berücksichtigung von Auth0 als IdP zu konfigurieren. Um mehr über die Funktionen zu erfahren, die wir für ASP.NET Core SSO bereitstellen, klicken Sie auf hier.

Plattformunterstützung: Die ASP.NET Core SAML-Middleware unterstützt ASP.NET Core 2.0 und höher. Es unterstützt alle ASP.NET Core-Plattformen, einschließlich Windows, Linux und macOS.

Voraussetzungen: Download und Installation

.NET5 und höher
NETCore2.0-.NETCore3.1

NuGet-Paket
.NET-CLI

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

      
          
          
    
    using miniorange.saml
    public class Startup
    {
      public void ConfigureServices(IServiceCollection services)
      {
   
       services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme).AddCookie();
       services.AddControllersWithViews();
      }
      public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
      {
        app.UseHttpsRedirection();
        app.UseRouting();
        app.UseAuthorization();
        app.MapRazorPages();
    
        app.UseCookiePolicy();
        app.UseAuthentication();
        app.UseStaticFiles();
        app.UseminiOrangeSAMLSSOMiddleware();
        app.Run();
      }
    }

      
          
    
    using Microsoft.AspNetCore.Authentication.Cookies;
    using miniOrange.saml;
    
    var builder = WebApplication.CreateBuilder(args);
    
    builder.Services.AddRazorPages();
    // Add authentication services
    builder.Services.AddControllersWithViews();
    builder.Services.AddAuthentication(options =>
     {
       options.DefaultAuthenticateScheme = "SSO_OR_Admin";
      options.DefaultScheme = "SSO_OR_Admin";
      options.DefaultChallengeScheme = "SSO_OR_Admin";
     })
    .AddCookie("moAdmin", options =>
     {
     })
    .AddCookie(CookieAuthenticationDefaults.AuthenticationScheme, options =>
     {
      // Configure cookie options as needed for SSO Users
    })
    .AddPolicyScheme("SSO_OR_Admin", "SSO_OR_Admin", options =>
    {
      // runs on each request
      options.ForwardDefaultSelector = context =>
      {
          // filter by auth type, here if the moAdmin cookie is coming in any request the Admin Authentication will work
          foreach (var cookie in context.Request.Cookies)
          {
              if (cookie.Key.Contains(".AspNetCore.Cookies"))
              {
                  return CookieAuthenticationDefaults.AuthenticationScheme;
              }
          }
    // otherwise always check for cookie auth
         return "moAdmin";
         };
    });
    var app = builder.Build();
    
    if (!app.Environment.IsDevelopment())
     {
        app.UseExceptionHandler("/Error");
    
        app.UseHsts();
     }
    
    app.UseHttpsRedirection();
    app.UseRouting();
    app.UseAuthorization();
    app.MapRazorPages();
    
    app.UseCookiePolicy();
    app.UseAuthentication();
    app.UseStaticFiles();
    app.UseminiOrangeSAMLSSOMiddleware();
    app.Run();

Schritte zum Konfigurieren von ASP.NET Core Single Sign-On (SSO) mit Auth0 als IDP

1. Fügen Sie Middleware zur ASP.NET Core-Anwendung hinzu

Öffnen Sie nach der Integration Ihren Browser und durchsuchen Sie das Middleware-Dashboard mit der folgenden URL:
https://<your-application-base-url>/?ssoaction=config
Wenn die Registrierungs- oder Anmeldeseite angezeigt wird, haben Sie die miniOrange ASP.NET SAML SSO-Middleware erfolgreich zu Ihrer Anwendung hinzugefügt.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – SAML-DLL-Register

Registrieren Sie sich oder melden Sie sich mit Ihrem Konto an, indem Sie auf klicken Registrieren Klicken Sie auf die Schaltfläche, um die Middleware zu konfigurieren.

2. Konfigurieren Sie Auth0 als Identitätsanbieter

Unter dem Plugin-Einstellungen Registerkarte, wählen Sie Auth0 Wählen Sie aus der angezeigten Liste Ihren Identitätsanbieter aus.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Wählen Sie Auth0 als Identitätsanbieter

Im Folgenden werden zwei Möglichkeiten beschrieben, mit denen Sie die SAML-SP-Metadaten zur Konfiguration auf der Seite Ihres Identitätsanbieters abrufen können.

A] Verwendung der SAML-Metadaten-URL oder Metadatendatei:

Im Menü „Plugin-Einstellungen“., suchen Dienstanbietereinstellungen. Darunter finden Sie die Metadaten-URL sowie die Möglichkeit, die SAML-Metadaten herunterzuladen.
Kopieren Sie die Metadaten-URL oder laden Sie die Metadatendatei herunter, um sie bei Ihrem Identitätsanbieter zu konfigurieren.
Sie können sich auf den Screenshot unten beziehen:

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Heruntergeladene Metadaten kopieren

B] Metadaten manuell hochladen:

Von dem Dienstanbietereinstellungen Im Abschnitt können Sie die Metadaten des Dienstanbieters manuell kopieren SP-Entitäts-ID, ACS-URL, Single-Logout-URL und geben Sie es zur Konfiguration an Ihren Identitätsanbieter weiter.
Sie können sich auf den Screenshot unten beziehen:

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – manuelle Metadaten

Einloggen auf Ihre Auth0-Dashboard.
Klicken Sie auf Anwendungen.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Navigieren Sie zu „Anwendungen“.

Klicken Sie auf Anwendung erstellen.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Anwendung hinzufügen oder erstellen

Es öffnet sich ein neues Fenster. Geben Sie einen Namen für die Anwendung ein und wählen Sie aus Reguläre Web-App. Klicken Sie auf CREATE .

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Wählen Sie eine reguläre Web-App

Wähle aus Addons Tab.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Wählen Sie SAML SSO Add-ons aus

Ermöglichen SAML2 Option in den Add-ons. Es öffnet sich ein Konfigurationsfenster.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Aktivieren Sie die SAML 2.0-Add-on-Webanwendung

Enter Anwendungsrückruf-URL, Zielgruppe, Empfänger und andere Einstellungen mit SP-Entitäts-ID und ACS-URL vom Plugin kopiert, wie unten gezeigt:

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – SP-Entitäts-ID und URL aus dem Plugin hinzufügen

Scrollen Sie nach unten und klicken Sie auf Speichern.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Entitäts-ID speichern

Gehen Sie zum Anwendungsbereich und klicken Sie auf Metadaten des Identitätsanbieters Download-Link. Es lädt die Metadaten-XML-Datei herunter, die Sie zum Einrichten des SAML-Plugins benötigen.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – IDP-Metadaten-Download

Sie haben Auth0 erfolgreich als SAML-IdP (Identitätsanbieter) konfiguriert, um ASP.NET Core SAML SSO zu erreichen.

3. Konfigurieren Sie ASP.NET SAML Middleware als Dienstanbieter

Im Folgenden werden zwei Möglichkeiten beschrieben, mit denen Sie die Metadaten Ihres SAML-Identitätsanbieters in der Middleware konfigurieren können.

A] Metadaten über die Schaltfläche „IDP-Metadaten hochladen“ hochladen:

Wenn Ihr Identitätsanbieter Ihnen die Metadaten-URL oder Metadatendatei (nur .xml-Format) bereitgestellt hat, können Sie die Metadaten des Identitätsanbieters einfach in der Middleware mithilfe von konfigurieren Laden Sie IDP-Metadaten hoch .
Sie können sich auf den Screenshot unten beziehen:

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Metadaten hochladen

Sie können eine der Optionen entsprechend dem verfügbaren Metadatenformat auswählen.

B] Konfigurieren Sie die Metadaten des Identitätsanbieters manuell:

Nach der Konfiguration Ihres Identitätsanbieter, es wird Ihnen zur Verfügung gestellt IDP-Entitäts-ID, IDP-Single-Sign-On-URL und SAML X509-Zertifikat Felder bzw.
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Speichern um Ihre IDP-Daten zu speichern.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – SAML-DLL-Konfiguration

4. Testen von SAML SSO

Klicken Sie auf Testkonfiguration Klicken Sie auf die Schaltfläche, um zu testen, ob die von Ihnen vorgenommene SAML-Konfiguration korrekt ist.
Der Screenshot unten zeigt ein erfolgreiches Ergebnis. Klicke auf SSO-Integration um die SSO-Integration weiter fortzusetzen.

ASP.NET Core SAML Single Sign-On (SSO) mit Azure AD (Microsoft Entra ID) als IDP – SAML-DLL-Testkonfiguration

Wenn auf der Middleware-Seite ein Fehler auftritt, wird ein Fenster angezeigt, das dem folgenden ähnelt.

ASP.NET Core SAML Single Sign-On (SSO) mit Azure AD (Microsoft Entra ID) als IDP – Debugprotokolle aktivieren

Um den Fehler zu beheben, können Sie die folgenden Schritte ausführen:

Der Problembehandlung Aktivieren Sie auf der Registerkarte den Schalter, um die Plugin-Protokolle zu empfangen.

Nach der Aktivierung können Sie Plugin-Protokolle abrufen, indem Sie zu navigieren Plugin-Einstellungen Tab und klicken Sie auf Testkonfiguration.
Laden Sie die Logdatei von dem Problembehandlung Tab, um zu sehen, was schief gelaufen ist.
Sie können die teilen Logdatei bei uns bei aspnetsupport@xecurify.com und unser Team wird sich mit Ihnen in Verbindung setzen, um Ihr Problem zu lösen.

5. Attributzuordnung

Nachdem Sie die Konfiguration getestet haben, ordnen Sie Ihre Anwendungsattribute den Identitätsanbieterattributen (IdP) zu.
Hinweis: Alle zugeordneten Attribute werden in der Sitzung gespeichert, sodass Sie in Ihrer Anwendung darauf zugreifen können.

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP – Attributzuordnung

6. Integrationscode

Mit diesen Schritten können Sie die SSO-Benutzerinformationen in Ihrer Anwendung in Form von Benutzeransprüchen abrufen.
Sie können auch nachschauen Aufbautour um zu verstehen, wie die SSO-Integration in Ihrer asp.net-Middleware-Anwendung funktionieren würde.
Kopieren Sie einfach dieses Code-Snippet und fügen Sie es dort ein, wo Sie auf die Benutzerattribute zugreifen möchten.

ASP.NET Core SAML Single Sign-On (SSO) | ASP.NET Core-Authentifizierung | ASP.NET Core SAML SSO – Integrationscode

Hinweis:Diese Test-Middleware unterstützt nur Benutzerinformationen in Ansprüchen. Das Abrufen von Benutzerinformationen in Sitzungen und Headern ist im Premium-Plugin verfügbar
Sie können den Integrationscode auch von unten kopieren:

          
      

  string name="";
  string claimtype="";
  string claimvalue="";

   if(User.Identity.IsAuthenticated)
   {
     foreach( var claim  in User.Claims) 
     {
       claimtype = claim.Type;
       claimvalue = claim.Value;
     }
     //retrive custom attributes(for eg. Retrieve Mapped 'mobileNumber' attribute of your IDP)
     var identity = (ClaimsIdentity)User.Identity;
     IEnumerable claims = identity.Claims;
     string mobileNumber = identity.FindFirst("mobileNumber")?.Value;
   }

Hinweis: Alle zugeordneten Attribute werden in den Ansprüchen gespeichert, auf die in Ihrer Anwendung zugegriffen werden kann.
Wenn Sie Hilfe zum Integrationscode benötigen, kontaktieren Sie uns unter aspnetsupport@xecurify.com

7. Anmeldeeinstellungen

Schweben Wählen Sie Aktionen aus und klicken Sie auf SSO-Link kopieren.

ASP.NET Core SAML Single Sign-On (SSO) mit ADFS als IDP – SSO-Link kopieren

Verwenden Sie die folgende URL als Link in der Anwendung, von der aus Sie SSO durchführen möchten:
https://base-url/?ssoaction=login
Sie können es beispielsweise wie folgt verwenden:
<a href=”https://asp-net-core-base-url/?ssoaction=login”>Log in</a>

8. Abmeldeeinstellungen

Verwenden Sie die folgende URL als Link zu Ihrer Anwendung, von der aus Sie SLO durchführen möchten:
https://asp-net-core-base-url/?ssoaction=logout
Sie können es beispielsweise wie folgt verwenden:
<a href=”https://base-url/?ssoaction=logout”>Log out</a>

Sie können die ASP.NET Core SAML 2.0 Single Sign-On (SSO)-Middleware mit jedem Identitätsanbieter konfigurieren, z 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 oder sogar mit Ihrem eigener benutzerdefinierter Identitätsanbieter. Sehen Sie sich die Liste der Identitätsanbieter an hier.

Weitere Informationen

Hilfe benötigt?

Sie können Ihren Identitätsanbieter nicht finden? Schicken Sie uns eine E-Mail aspnetsupport@xecurify.com Wir helfen Ihnen bei der Einrichtung von SSO mit Ihrem IDP und geben Ihnen eine schnelle Anleitung (per E-Mail/Besprechung) zu Ihren Anforderungen. Unser Team hilft Ihnen bei der Auswahl der für Ihre Anforderungen am besten geeigneten Lösung/Plan.

idp_cert	Geben Sie in dieses Feld das IDP-Zertifikat ein
ssourl	Geben Sie in dieses Feld die SSO-URL ein
idp_issuer	Geben Sie in dieses Feld den IDP-Aussteller ein

Inhalte

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP

Voraussetzungen: Download und Installation

Schritte zum Konfigurieren von ASP.NET Core Single Sign-On (SSO) mit Auth0 als IDP

1. Fügen Sie Middleware zur ASP.NET Core-Anwendung hinzu

2. Konfigurieren Sie Auth0 als Identitätsanbieter

A] Verwendung der SAML-Metadaten-URL oder Metadatendatei:

B] Metadaten manuell hochladen:

3. Konfigurieren Sie ASP.NET SAML Middleware als Dienstanbieter

A] Metadaten über die Schaltfläche „IDP-Metadaten hochladen“ hochladen:

B] Konfigurieren Sie die Metadaten des Identitätsanbieters manuell:

4. Testen von SAML SSO

5. Attributzuordnung

6. Integrationscode

7. Anmeldeeinstellungen

8. Abmeldeeinstellungen

Attributzuordnung

Integrationscode

Weitere Informationen

Hilfe benötigt?

IN VERBINDUNG BLEIBEN

Produkt

Lösungen

Warum Miniorange

Firma

Inhalte

ASP.NET Core SAML Single Sign-On (SSO) mit Auth0 als IDP

Voraussetzungen: Download und Installation

Schritte zum Konfigurieren von ASP.NET Core Single Sign-On (SSO) mit Auth0 als IDP

1. Fügen Sie Middleware zur ASP.NET Core-Anwendung hinzu

2. Konfigurieren Sie Auth0 als Identitätsanbieter

A] Verwendung der SAML-Metadaten-URL oder Metadatendatei:

B] Metadaten manuell hochladen:

3. Konfigurieren Sie ASP.NET SAML Middleware als Dienstanbieter

A] Metadaten über die Schaltfläche „IDP-Metadaten hochladen“ hochladen:

B] Konfigurieren Sie die Metadaten des Identitätsanbieters manuell:

4. Testen von SAML SSO

5. Attributzuordnung

6. Integrationscode

7. Anmeldeeinstellungen

8. Abmeldeeinstellungen

Attributzuordnung

Integrationscode

Weitere Informationen

Hilfe benötigt?

IN VERBINDUNG BLEIBEN

Produkt

Lösungen

Warum Miniorange

Firma

Cookie-Einstellungen

Cookie-Zustimmung

Unbedingt notwendige Cookies

Immer aktiv

Performance-Cookies

Immer aktiv