Anleitung zur Konfiguration von ASP.NET Framework SAML SSO mit Gluu Server als IDP

Voraussetzungen: Download und Installation

A] NuGet-Installation:

• Einloggen um http://portal.miniorange.com/ und navigiere zu Downloads Dort finden Sie das von Ihnen erworbene Plugin und klicken darauf. Download Plugin um die Plugin-ZIP-Datei herunterzuladen.

• Entpacken Sie die heruntergeladene ZIP-Datei auf Ihrem Rechner und legen Sie die NuGet-Paketdatei (.nupkg-Datei) in einen Ordner wie z. B. "C:\miniOrangePackages" ab.
• Führen Sie folgenden Befehl in Ihrem VS-Terminal aus, um es als Paketquelle hinzuzufügen:

• Öffnen Sie Ihr Projekt im Terminal:

• Installieren Sie das Paket in Ihrem Projekt mit dem folgenden Befehl:

OR

• Nachdem Sie das NuGet-Paket (die .nupkg-Datei) in einem lokalen Ordner abgelegt haben, können Sie es anstelle der Verwendung des Terminals auch mit Visual Studio installieren, indem Sie die folgenden Schritte befolgen:
• Öffnen Sie Ihre .NET-Anwendung in Visual Studio und klicken Sie auf Zubehör in der oberen Navigationsleiste und navigieren Sie zu NuGet-Paket-Manager → NuGet-Pakete für Projektmappe verwalten.

• Es öffnet sich ein neues Fenster; klicken Sie auf die Zahnrad-Symbol neben dem Dropdown-Menü „Paketquelle“.

• Ein Popup-Fenster öffnet sich; wählen Sie Paketquellen Klicken Sie im linken Navigationsbereich auf das Pluszeichen. (+) Symbol, geben Sie ein Name Geben Sie für die Paketquelle den Pfad des Ordners an, in dem Sie das NuGet-Paket abgelegt haben. Quelle Feld, dann klicken Sie auf Update und schließlich klicken OK Um die Änderungen zu speichern, wie im Bild gezeigt.

• Nachdem Sie das Popup-Fenster geschlossen haben, wählen Sie die neu hinzugefügte Paketquelle aus der Liste aus. Paketquelle Dropdown-Liste.

• Klicken Sie nun auf die Jetzt entdecken Registerkarte, suchen nach miniOrange.SAML.SSOWählen Sie das gewünschte Paket aus den Ergebnissen aus und klicken Sie auf Installieren.

B] Manuelle Installation:

• Entpacken Sie das heruntergeladene Paket aus dem miniOrange Portal. Es enthält a Manuelle Installation Ordner mit miniorange-saml-sso.dll und andere DLL-Dateien, die in Ihrer Anwendung platziert werden müssen Kasten -Ordner.
• Legen Sie die saml.config Datei und die miniOrangeContent Ordner im Stammverzeichnis Ihrer Anwendung.
• Registrieren Sie das miniOrange-Modul in Ihrem web.config indem man die Schritte in der Integration.md.

Zugriff auf das Modul-Dashboard

• Öffnen Sie nach der Installation Ihren Browser und durchsuchen Sie das Modul-Dashboard mit der folgenden URL:
  

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


• Wenn die Anmeldeseite erscheint, haben Sie das miniOrange SAML SSO-Modul erfolgreich in Ihre Anwendung integriert.

• Melden Sie sich mit Ihrem lizenzierten miniOrange-Konto an, um das Modul zu konfigurieren.
• Nach dem Einloggen wird der Account Setup Das Dashboard wird geöffnet. Geben Sie den Lizenzschlüssel ein, um das Plugin zu aktivieren. Diesen erhalten Sie nach dem Einloggen. portal.miniorange.com und navigieren zu Lizenz verwalten → Lizenzschlüssel.

• Setzen Sie dann ein Häkchen in das Kästchen. „Ich habe die beiden oben genannten Bedingungen gelesen und möchte das Plugin aktivieren.“und klicken Sie auf Lizenz aktivieren .

A] Verwenden der SAML-Metadaten-URL oder Metadatendatei

• Im Menü „Plugin-Einstellungen“., suchen DienstanbietereinstellungenDarunter finden Sie die Metadaten-URL sowie die Option zum Herunterladen der SAML-Metadaten.

• Kopieren Sie die Metadaten-URL oder laden Sie die Metadatendatei herunter, um sie auf der Seite Ihres Identitätsanbieters zu konfigurieren.

• Sie können sich auf den Screenshot unten beziehen:

B] Manuelles Hochladen von Metadaten

• Von dem Dienstanbietereinstellungen In diesem Abschnitt können Sie die Metadaten des Dienstanbieters manuell kopieren, wie zum Beispiel SP-Entitäts-ID, ACS-URL, Single-Logout-URLund teilen Sie es Ihrem Identitätsanbieter zur Konfiguration mit.
• Sie können das SP-Zertifikat auch herunterladen, indem Sie darauf klicken. SP-Zertifikat herunterladen und übermitteln Sie diese gegebenenfalls Ihrem Identitätsanbieter.
• Unter dem Verschlüsselungszertifikat Im entsprechenden Abschnitt wählen Sie den für Ihre Anforderungen passenden Zertifikatstyp aus.
• Nachdem Sie die oben genannten Schritte abgeschlossen haben, klicken Sie auf Gespeichert um die Konfiguration zu übernehmen.

• Sie können sich auf den Screenshot unten beziehen:

Schritte zur Konfiguration des Gluu Server IdP

• Melden Sie sich beim Gluu-Server an Admin-Konsole.
• Klicken Sie im Navigationsbereich auf SAML->Vertrauensbeziehungen hinzufügen.

• Konfigurieren Sie Folgendes in Formular für eine Vertrauensbeziehung:
• Display Name: ASP.NET SAML-Anwendung (Geben Sie einen beliebigen Namen zur Identifizierung der Anwendung ein)
• BeschreibungGeben Sie eine geeignete Beschreibung für Ihre Bewerbung an.
• Entitätstyp: Einzelner SP
• Metadatenspeicherort: Datei

• Von dem Metadaten des Dienstanbieters Klicken Sie im Plugin auf die Registerkarte, laden Sie die herunter Metadaten-XML-Datei.
• Laden Sie die Metadatendatei hoch SP-Metadatendatei.
• Aktivieren Sie nun das Kontrollkästchen „Relying Party konfigurieren“ und klicken Sie auf Konfigurieren Sie die vertrauende Seite Link.

• Ihnen werden die angezeigt Konfigurationen der vertrauenden Seite
• Von Verfügbare ProfilkonfigurationenWählen SAML2SSO und klicken Sie auf Speichern SAML2SSO hinzufügen Ausgewählte Profilkonfigurationen.
• In SAML 2 SSO-Profil, konfigurieren Sie Folgendes:

signAssertions	Nie
signRequests	Bedingt
encryptAssertions	Bedingt
defaultAuthenticationMethods	Keine Präsentation
Unterstützt nicht spezifiziertes NameId-Format	Aktivieren Sie das Kontrollkästchen

• Von Verfügbare NamedId-FormateWählen urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress und urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified und füge es hinzu Ausgewählte NamedId-Formate.
• Klicken Sie auf Gespeichert .

• Von dem Geben Sie zusätzliche Attribute frei Fügen Sie im rechten Abschnitt die Attribute hinzu, die Sie an den Dienstanbieter senden möchten.
• Klicken Sie auf Update .

• Die SAML-IDP-Metadaten von Gluu finden Sie unter https://HOSTNAME/idp/shibbolethDies ist erforderlich, um das Plugin im Dienstanbieter zu konfigurieren.

• Klicken Sie auf Neuen IDP hinzufügen Schaltfläche, um einen neuen Identitätsanbieter zu konfigurieren.

• Unter dem Plugin-Einstellungen Registerkarte, wählen Sie Gluu-Server als Ihren Identitätsanbieter aus der angezeigten Liste.

Es gibt zwei im Folgenden detailliert beschriebene Möglichkeiten, mit denen Sie die Metadaten Ihres SAML-Identitätsanbieters im Modul konfigurieren können.

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

• Wenn Ihr Identitätsanbieter Ihnen die Metadaten-URL oder die Metadatendatei (nur im XML-Format) bereitgestellt hat, können Sie die Metadaten des Identitätsanbieters einfach im Modul konfigurieren. Laden Sie IDP-Metadaten hoch .

• Kopieren Sie die Metadaten-URL oder laden Sie die Metadatendatei herunter, um sie auf der Seite Ihres Identitätsanbieters zu konfigurieren.

• Sie können sich auf den Screenshot unten beziehen:

• 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, wird es Ihnen zur Verfügung stellen IDP-Entitäts-ID, IDP-Single-Sign-On-URL und SAML X509-Zertifikat Felder bzw.

• Klicken Sie auf Gespeichert um Ihre IDP-Daten zu speichern.

• Navigieren Sie nach dem Hochladen der Metadatendetails zum Einstellungen des Identitätsanbieters Abschnitt. Bewegen Sie den Mauszeiger über den Abschnitt. Wählen Sie Aktionen aus Dropdown-Liste und klicken Sie auf Testkonfiguration.

• Der untenstehende Screenshot zeigt ein erfolgreiches Testergebnis. Bitte klicken Sie auf hier klicken um die verbleibenden SSO-Integrationsschritte abzuschließen.

• Sollten Sie auf Modulseite einen Fehler feststellen, wird Ihnen ein Fenster ähnlich dem untenstehenden angezeigt.

• 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 Tabulatortaste und Klicken auf Testkonfiguration.
• Laden Sie Logdatei von der Problembehandlung Klicken Sie auf die entsprechende Taste, um zu sehen, was schiefgelaufen ist.
• Sie können die teilen Logdatei bei uns bei aspnetsupport@xecurify.com Unser Team wird sich mit Ihnen in Verbindung setzen, um Ihr Problem zu lösen.

• Nach dem Testen der Konfiguration ordnen Sie Ihre Anwendungsattribute den Attributen des Identitätsanbieters (IdP) zu.

• Klicken Sie im linken Menü des miniOrange ASP.NET SAML SSO-Moduls auf Attribut-/Rollenzuordnung Registerkarte, wie im Bild gezeigt.
• Erstellen Sie eine Karte der erforderlichen IdP-Attribute (wie z. B. Benutzername, E-Mail-Adresse, Vorname und Nachname), die in der SAML-Antwort empfangen und ihren entsprechenden Feldern zugeordnet werden.

• Hinweis: Alle zugeordneten Attribute werden in der Sitzung gespeichert, sodass Sie in Ihrer Anwendung darauf zugreifen können.
• Sobald die Attribute zugeordnet sind, klicken Sie auf Attributzuordnung speichern Änderungen anwenden.

Benutzerdefinierte Attributzuordnung

• Wenn Sie zusätzliche Attribute von Ihrem Identitätsanbieter (IdP) übergeben möchten, geben Sie den Attributnamen und den entsprechenden Attributwert unter folgendem Link ein: Benutzerdefinierte Attributzuordnung.
• Von dem Attributwert (Anspruch) Wählen Sie im Dropdown-Menü einen der Ansprüche aus, die Sie in den Testkonfigurationsergebnissen erhalten haben. Zum Beispiel: NameID.
• Diese Ansprüche entsprechen den Attributen, die von Ihrem Identitätsanbieter (IdP) gesendet werden.

• Diese Ansprüche entsprechen den Attributen, die von Ihrem Identitätsanbieter (IdP) gesendet werden.

• Im Attributname Geben Sie im Feld den Namen des Attributs so ein, wie er in Ihrer .NET-Anwendung angezeigt oder verwendet werden soll.
• Sie können mehrere Zuordnungen hinzufügen, wenn Ihre Anwendung mehrere Attribute benötigt, indem Sie auf die entsprechende Schaltfläche klicken. + .
• Nachdem Sie alle erforderlichen Zuordnungen definiert haben, klicken Sie auf Attributzuordnung speichern um die Konfiguration zu speichern.

• Das Modul übersetzt nun die eingehenden SSO-Ansprüche Ihres Identitätsanbieters (IdP) in die hier definierten benutzerdefinierten Attributnamen.

Rollenzuordnung

• Im Rollenzuordnung Abschnitt, geben Sie die ein Gruppenattributname genau so, wie es in Ihrem Identitätsanbieter konfiguriert ist, um die Benutzergruppeninformationen abzurufen.
• Geben Sie die Rollenname vom Identitätsanbieter empfangen und dem entsprechenden Eintrag zuordnen Rollenwert Geben Sie im Feld „Rollenwert“ die in Ihrer .NET-Anwendung definierten Rollen ein.
• Beispiel: Ordnen Sie die unter dem Attribut UserGroups empfangene IdP-Gruppe Group1 oder Group10 der entsprechenden Rolle zu, die in Ihrer .NET-Anwendung konfiguriert ist.
• Nachdem Sie die erforderlichen Zuordnungen hinzugefügt haben, klicken Sie auf Rollenzuordnung speichern Die Konfiguration wurde erfolgreich gespeichert.

Domänenbeschränkung

• Mit dieser Funktion kann der Zugriff von Benutzern auf die Website basierend auf der Domain ihres zugeordneten "E-Mail"-Attributs eingeschränkt werden.
• Im E-Mail-Attribut Geben Sie im Feld den Attributnamen ein, der die vom Identitätsanbieter (IdP) erhaltene E-Mail-Adresse des Benutzers enthält.

• Im Domain Name Geben Sie im Feld die Domain(s) ein, die Sie zulassen oder einschränken möchten. Bei mehreren Domains trennen Sie die Domains durch Kommas.
• Aktivieren Sie die Einschränkungsschalter basierend auf Ihrer Anforderung zur Konfiguration des Zugriffs auf eine Blacklist oder eine Whitelist.
• Nach Abschluss der Konfiguration klicken Sie auf Domains speichern Die Einstellungen wurden erfolgreich gespeichert.

• Mithilfe dieser Schritte können Sie die SSO-Benutzerinformationen in Ihrer Anwendung in Form einer Sitzung abrufen.
• Sie können auch nachschauen Aufbautour um zu verstehen, wie die SSO-Integration in Ihrer ASP.NET-Modulanwendung funktionieren würde.
• Kopieren Sie einfach diesen Codeausschnitt und fügen Sie ihn an der gewünschten Stelle ein, um auf die Benutzerattribute zuzugreifen.

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

• Verwenden Sie die folgende URL als Link in der Anwendung, von der aus Sie SSO durchführen möchten:

• Sie können es beispielsweise wie folgt verwenden:

• Verwenden Sie die folgende URL als Link zu Ihrer Anwendung, von der aus Sie SLO durchführen möchten:

• Sie können es beispielsweise wie folgt verwenden: