1. Einführung
Dieser Leitfaden soll Ihnen helfen, Single Sign-On (SSO) für die Anwendungen Ihrer Organisation mit Microsoft Entra einzurichten.
Wichtiger Hinweis: Bevor Sie beginnen, stellen Sie sicher, dass Sie die erforderlichen Berechtigungen haben. Wenn Sie sich nicht sicher sind, wenden Sie sich bitte an den IT-Support oder Administrator Ihres Unternehmens.
2. Inhaltsverzeichnis
- Wichtige Begriffe verstehen
- Erste Schritte
- Schritt-für-Schritt SSO-Einrichtung
- Testen und Bestätigung
- Fehlerbehebung & Support
- Zusätzliche Ressourcen
3. Wichtige Begriffe verstehen
Microsoft Entra: Früher bekannt als Azure Active Directory, ist Microsofts Online-Identitätsverzeichnis zur Verwaltung des Benutzerzugriffs auf Ressourcen. • SSO (Single Sign-On): Eine sichere Methode, die es Ihnen ermöglicht, mit einem Satz von Anmeldedaten (Benutzername und Passwort) auf verschiedene Apps zuzugreifen. • Anwendung: Jedes Online-Tool oder jeder Dienst, den Ihre Organisation nutzt (z. B. E-Mail, Kollaborationstools).
4. Erste Schritte
Bevor Sie mit der Konfiguration von SSO beginnen, stellen Sie bitte sicher:
• Sie haben Administratorzugriff auf Microsoft Entra erhalten (oder fragen Sie bei Bedarf Ihr IT-Team).
• Das Protokoll für SSO wird SAML2 sein
• Geben Sie den Wert an, der als Benutzername verwendet werden soll. Für den SSO-Zugang möchte Cyber Guru die Objekt-ID des Benutzers verwenden. Das bedeutet, wenn Sie den Benutzer in unserer Plattform vorladen, muss er die Objekt-ID als Benutzernamen haben.
• Überprüfen Sie das Vorhandensein der Pflichtfelder im Microsoft-Benutzerprofil: Benutzername, E-Mail, Vorname, Nachname
• Überprüfen Sie die Zugriffsrichtlinie für die SSO-Anwendung für die Benutzer. Die Verwendung von Gruppen wäre am besten.
• Stellen Sie einen Benutzer für Cyberguru in Microsoft Entra zur Fehlerbehebung bereit
5. Schritt-für-Schritt SSO-Einrichtung
5.1. Schritt 1:
Anmeldung bei Microsoft Entra
Gehen Sie zur Microsoft Entra-Anmeldeseite mit der Administratorrolle
5.2. Schritt 2: Navigieren zum Bereich Unternehmensanwendungen
Sobald Sie eingeloggt sind, suchen Sie nach einem Navigationsbereich (normalerweise links).
Klicken Sie auf die Option mit der Bezeichnung „Unternehmensanwendungen“ oder „Apps“.
Dieser Bereich zeigt alle Anwendungen, die für die SSO-Integration verfügbar sind.
5.3. Schritt 3: Hinzufügen einer neuen Anwendung
Oben auf der Seite „Unternehmensanwendungen“ gibt es normalerweise eine Schaltfläche, die „Neue Anwendung“ oder „Anwendung hinzufügen“ sagt.
Klicken Sie auf diese Schaltfläche.
Klicken Sie auf „Erstellen Sie Ihre eigene Anwendung“
Stellen Sie sicher, dass das Optionsfeld auf „Integrieren Sie jede andere Anwendung, die Sie nicht in der Galerie finden (Nicht-Galerie)“ ausgewählt ist
Geben Sie einen Namen für die Anwendung ein und klicken Sie auf „Speichern“
5.4. Schritt 4: Konfigurieren von SSO für die Anwendung
Auf der Übersichtsseite der Anwendung,
suchen Sie nach einem Button oder Link, der „Single Sign-On“ oder „Single Sign-On einrichten“ sagt.
Klicken Sie auf diesen Button. Sie werden zur SSO-Konfigurationsseite weitergeleitet.
Sie könnten verschiedene SSO-Methoden sehen (wie SAML, OpenID Connect, etc.). Klicken Sie auf „SAML“.
5.5. Schritt 5: IdP-Metadaten an Cyber Guru senden
Finden Sie das Panel Nr. 3 auf der App-Seite.
Kopieren Sie die App FederationMetadata URL und senden Sie sie an CSM Cyber Guru.
5.6. Schritt 6: Cyber Guru Konfiguration
Cyber Guru wird die Konfiguration auf seiner Seite abschließen und die SP-Metadaten-URL zurücksenden.
Hinweis: Öffnen Sie die erhaltene SP-Metadaten-URL in einem Browser und speichern Sie sie als XML-Datei
5.7. Schritt 7: SP-Metadaten hochladen
Klicken Sie auf „Metadatendatei aktualisieren“ in der oberen linken Ecke der App-Seite und
geben Sie die im vorherigen Schritt gespeicherte SP-Metadaten-XML-Datei an.
Sobald die Datei hochgeladen ist, gelangen Sie zur Metadaten-Überprüfungsseite
klicken Sie auf "Speichern"
5.8. Schritt 8: Hinzufügen von Cyber Guru-Ansprüchen zur SAML-Antwort
Cyber Guru fordert die folgenden obligatorischen Attribute in der SAML-Antwort an
• Benutzername
• Vorname
• Nachname
Für eine vollständige Liste der Attribute, die Cyber Guru in der Antwort erhalten kann, lesen Sie bitte den speziellen Artikel "Idp-Attribute"
Sobald die Anwendung erstellt ist, finden Sie die Standardansprüche wie folgt
Sie können die bestehenden zusätzlichen Ansprüche ändern oder alle entfernen und neue erstellen. Im Folgenden finden Sie die Details zu jedem obligatorischen Attribut:
Am Ende der Anspruchskonfiguration sollten Sie Folgendes sehen. Überprüfen Sie die Zuordnung sorgfältig und achten Sie auf die Attribute mit groß- und kleinschreibungssensitiven Namen (firstName, lastName)
5.9. Schritt 9 Überprüfung der Konfiguration
Nehmen Sie sich einen Moment Zeit, um die Informationen zu überprüfen. Wenn etwas nicht richtig aussieht, können Sie zurückgehen und Anpassungen vornehmen.
Hinweis: Es ist eine gute Idee, eine Notiz auf Papier oder eine digitale Kopie dieser Einstellungen für zukünftige Referenzen aufzubewahren.
6. Testen und Bestätigung
Sobald die SSO-Konfiguration abgeschlossen ist, testen Sie, ob sie ordnungsgemäß funktioniert:
Autorisieren Sie den Benutzer für den Test in der Anwendung. Der Benutzer muss bereits in der Cyber Guru Plattform vorab geladen sein.
Öffnen Sie ein neues Browserfenster (oder ein Inkognito-/Privatfenster).
Gehen Sie zur Anmelde-URL der Anwendung
https://<Kundendomain>.platform.cyberguru.eu
Klicken Sie auf die Schaltfläche „Anmelden mit SSO“ — Ihr Browser sollte Sie zur Anmeldeseite von Microsoft Entra weiterleiten.(*).
Geben Sie die Anmeldedaten ein.
Bestätigen Sie, dass Sie in die Anwendung eingeloggt sind, ohne zusätzliche Anmeldedaten eingeben zu müssen.
Wenn alles korrekt funktioniert, sehen Sie eine Erfolgsmeldung oder das Dashboard der Anwendung.
(*) Diese Schaltfläche kann von Cyber Guru entfernt werden, sodass die Plattform den Benutzer automatisch zur Microsoft-Anmeldeseite weiterleitet, sobald Sie Ihren Browser auf https://<Kundendomain>.platform.cyberguru.eu richten.
7. Fehlerbehebung & Support
Wenn Sie während der Konfiguration auf Probleme stoßen:
- Überprüfen Sie die in jedem Feld eingegebenen Informationen doppelt.
- Stellen Sie sicher, dass die URLs und Kennungen mit denen übereinstimmen, die von Ihrem IT-Team oder Anwendungsanbieter bereitgestellt wurden.
- Suchen Sie nach Fehlermeldungen auf dem Bildschirm – diese enthalten oft Hinweise darauf, was falsch ist.
- Verwenden Sie einen SAML-Tracer im Browser, um die Werte der Ansprüche in der SAML-Antwort nachzuverfolgen.
Wenn Sie weiterhin Probleme haben, notieren Sie die Fehlermeldung und kontaktieren Sie Ihren IT-Support und/oder den Cyberguru-Helpdesk.
8. Zusätzliche Ressourcen
Microsoft Entra Dokumentation:
Besuchen Sie die offizielle Microsoft-Website für detaillierte Anleitungen und FAQs:
https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-sso
Kontaktieren Sie den IT-Support: Wenden Sie sich an das IT-Team Ihrer Organisation, um Unterstützung bei spezifischen Konfigurationen zu erhalten.