​

Übersicht

​

Funktionalität

​

Zielgruppe

​

Zentrale Funktionen und Vorteile

• Zentralisierte Authentifizierung: Einmal anmelden, um auf mehrere Anwendungen zuzugreifen, ohne die Zugangsdaten erneut eingeben zu müssen.
• Höhere Sicherheit: Weniger Passwörter reduzieren Passwortwiederverwendung und das Phishing-Risiko.
• Verbesserte Benutzererfahrung: Vereinfacht den Anmeldeprozess und reduziert die Zeit und den Aufwand, der für den Zugriff auf verschiedene Dienste erforderlich ist.

​

Zugriffsanweisungen

​

SAML-Konfigurationsanweisungen

​

SAML-Anwendung beim SSO-Provider einrichten

1. Melden Sie sich bei Ihrem SSO-Provider an und richten Sie die SAML-Anwendung mit folgenden Parametern ein:

• Single Sign-On URL: https://www.corgea.app/saml/acs/
• Audience URI (SP Entity ID): https://www.corgea.app/saml/metadata/
• Default RelayState: https://www.corgea.app/projects/
• Name ID Format: EmailAddress
• Application Username: Email
• Update Application Username On: Create and update

2. Verwenden Sie unter “Attribute Statement” folgende Zuordnungen:

• email (user.profile.email)

• firstName (user.profile.firstName)
• lastName (user.profile.lastName)
  

user.getGroups({'group.type': {'BUILT_IN','OKTA_GROUP','APP_GROUP'}}).[profile.name]

​

IdP-Gruppen Corgea-Rollen zuordnen

• No project access weist die Rolle ohne Projektzugriff zu.
• All projects gewährt der Rolle Zugriff auf alle Projekte.
• Projects matching this group gewährt Zugriff anhand eines Werts im IdP-Gruppennamen. Wählen Sie Application, Line of business (LOB) oder Repository und verwenden Sie den entsprechenden Platzhalter im Gruppenmuster.

• {LOB}_{APPLICATION}_{REPOSITORY} entspricht einem Projekt mit dem Namen Finance_Payments_checkout-api.
• {LOB}-{APPLICATION} entspricht einem Projekt mit dem Namen Finance-Payments.

• Name -> Wert
  • email -> user.email
  • firstName -> user.firstName
  • lastName -> user.lastName
  

​

Integration von SAML mit Corgea

1

Integrations öffnen

Melden Sie sich bei Corgea an und öffnen Sie “Integrations”.

2

SAML SSO starten

Wählen Sie im Bereich “SAML SSO” die Option “Add”.

3

SAML-Konfiguration

• Geben Sie die SAML-Metadaten-URL in das Feld “Metadata URL” ein.
• Klicken Sie auf “Fetch and Populate”, um Entity ID, SSO URL und X.509 Certificate automatisch aus den Metadaten zu übernehmen.
• Configuration Name: Geben Sie einen Namen für die SAML-Konfiguration ein.
• Email Domain: Geben Sie die E-Mail-Domain für SSO an. Der Abgleich erfolgt ohne Berücksichtigung der Groß- und Kleinschreibung; neue und geänderte Domains werden kleingeschrieben gespeichert.

Manuelle Eingabe (falls erforderlich):

• Falls eine manuelle Eingabe erforderlich ist, stellen Sie sicher, dass Sie die folgenden Informationen haben:
  • Entity-ID: Die eindeutige Kennung der SAML-Entität.
  • X509-Zertifikat: Das Zertifikat zum Signieren von SAML-Assertionen.
  • Single Sign-On-Service-Standort: Die URL für SAML IdP-Authentifizierungsantworten.

4

Konfiguration abschließen

• Überprüfen Sie die Richtigkeit der automatisch ausgefüllten Felder.
• Klicken Sie auf Connect, um die SAML-Konfiguration zu speichern.

​

Anmeldung über SSO

• Nach erfolgreicher SAML-Konfiguration können sich Benutzer über den SSO-Service anmelden.
• Benutzeranmeldung: Nach Eingabe der E-Mail-Adresse auf der ersten Anmeldeseite erscheint bei passender Domain im zweiten Schritt Login by SAML. Der SAML-IdP authentifiziert den Benutzer und leitet ihn mit einer SAML-Assertion zurück zur Anwendung.

1

Anfangs-Login-Seite

Geben Sie Ihre E-Mail-Adresse ein. Wenn die Domain für SSO konfiguriert ist, erscheint auf der nächsten Seite Login by SAML.

2

Login über SAML-Option

Klicken Sie auf Login by SAML, um die Authentifizierung über Ihren SAML Identity Provider (IdP) fortzusetzen.

3

SAML-Authentifizierung

Sie werden zur Authentifizierung zu Ihrem SAML-IdP weitergeleitet. Geben Sie Ihre Anmeldedaten wie von Ihrem IdP gefordert ein.

4

Zur Anwendung weiterleiten

Nach erfolgreicher Authentifizierung werden Sie mit einer SAML-Assertion zurück zur Anwendung weitergeleitet, die Ihnen Zugriff gewährt.

​

Schritt-für-Schritt-Anleitung zur Konfiguration von SSO SAML für Microsoft Entra

1

Auf Azure Active Directory zugreifen

Beginnen Sie, indem Sie sich in Ihrem Azure-Portal anmelden. Nach der Anmeldung navigieren Sie zum Bereich „Azure Active Directory“.

2

Eine neue Anwendung erstellen

• Gehen Sie zu „Enterprise-Anwendungen“ und wählen Sie „Neue Anwendung“.
• Wählen Sie „Erstellen Sie Ihre eigene Anwendung“ und geben Sie einen Namen für Ihre neue Anwendung ein.

3

SAML-basiertes Anmelden konfigurieren

• Wählen Sie in den Anwendungseinstellungen “Single Sign-On” und dann “SAML” aus.

4

SAML-Metadaten-URL kopieren

• Kopieren Sie die Federation Metadata XML-URL zur späteren Verwendung.

5

SAML-Konfiguration in Corgea eintragen

• Melden Sie sich bei Ihrem Corgea-Konto an und wechseln Sie zum Abschnitt “Integrationen”.
• Klicken Sie im Abschnitt SAML SSO auf die Schaltfläche „+ Hinzufügen”.
• Geben Sie die kopierte SAML-Metadaten-URL in das Feld „Metadata URL” ein und klicken Sie auf „Abrufen und ausfüllen”.
• Überprüfen Sie die automatisch ausgefüllten Felder auf Richtigkeit.

6

Konfiguration abschließen und testen

• Klicken Sie auf die Schaltfläche „Verbinden”, um Ihre SAML-Konfiguration zu speichern.

7

Aktualisierte Corgea-SSO-URLs kopieren

• Nach dem Speichern der SAML-Integration können Sie die aktualisierte Kennung und ACS-URL anzeigen, indem Sie im Abschnitt SAML SSO auf „Alle anzeigen” klicken.

8

SAML-Konfiguration in Entra vervollständigen

• Geben Sie die kopierten SSO-Felder in die entsprechenden Felder auf Ihrer SAML-Basiskonfigurationsseite in Entra ein.
• Überprüfen Sie alle Eingaben sorgfältig auf ihre Richtigkeit, um eine erfolgreiche SSO-Verbindung zu gewährleisten, und klicken Sie dann oben auf die Schaltfläche „Speichern“.

9

Test-Anmeldung über SSO

Jetzt sollten Sie sich über die konfigurierte Domain auf der Anmeldeseite anmelden können. Anmeldung per SSO

​

Voraussetzungen oder Abhängigkeiten

• Ein konfigurierter SAML-Identitätsanbieter (IdP).

​

Best Practices

• Regelmäßig Zertifikate aktualisieren: Stellen Sie sicher, dass Ihre x509-Zertifikate auf dem neuesten Stand sind, um sichere Verbindungen zu gewährleisten.
• Konfigurationen testen: Bevor Sie SSO für alle Benutzer ausrollen, testen Sie die Konfiguration mit einer kleinen Gruppe, um sicherzustellen, dass alles wie erwartet funktioniert.

​

Fehlerbehebung

• Fehlender Referer-Header: Wenn Sie einen Fehler “Fehlender Referer-Header” erhalten, prüfen Sie, ob HTTP_ORIGIN korrekt in den Anfrage-Headern konfiguriert ist.
• Keine SAML-Konfiguration gefunden: Wenn die Konfiguration fehlt, stellen Sie sicher, dass die korrekte Referer-URL oder die E-Mail-Domain verwendet wird.
• Anmeldung wurde mit einem allgemeinen Fehler gestoppt: Mehr als eine SAML-Konfiguration kann dieselbe E-Mail-Domain mit unterschiedlicher Groß- und Kleinschreibung beanspruchen. Wenden Sie sich an den Corgea-Support, um die widersprüchlichen Konfigurationen zu lösen, bevor die Benutzer es erneut versuchen.
• Berechtigungsaktualisierung: Wenn ein Benutzer nicht auf die SAML-Anwendung zugreifen kann, überprüfen Sie, ob seine Berechtigungen korrekt konfiguriert und aktualisiert sind.

​

Konflikte beim Domainbesitz

• Ihr Team bereits einen bestehenden Corgea-Workspace hat, der mit derselben E-Mail-Domain verknüpft ist
• Ein anderer Administrator in Ihrer Organisation hat zuerst die domänenbasierte Benutzeranmeldung aktiviert
• SSO oder der Domain-basierte Workspace-Beitritt wurde zuvor in einem anderen Workspace konfiguriert

​

Was als Nächstes zu tun ist

1. Prüfen Sie, ob Ihre Organisation bereits einen Corgea-Workspace für diese Domain besitzt.
2. Wenn der bestehende Workspace korrekt ist, verwalten Sie Benutzer und SSO dort weiter, statt einen zweiten Workspace für dieselbe Domain zu erstellen.
3. Wenn die Domain in einen anderen Arbeitsbereich verschoben werden muss, wenden Sie sich an den Corgea-Support (support@corgea.com), damit wir den korrekten Eigentümer bestätigen und die Konfiguration sicher aktualisieren können.

​

Zusätzliche Ressourcen

• SAML-Protokollübersicht
• Fehlerbehebung bei SAML-Problemen
• Hinzufügen einer Okta-SAML-Anwendung

​

SCIM als optionale Funktion

​

Übersicht

​

Funktionalität

​

Zielgruppe

​

Hauptmerkmale und Vorteile

• Automatisierte Benutzerbereitstellung: Benutzerkonten in verbundenen Anwendungen automatisch erstellen, aktualisieren und deaktivieren, wodurch manueller Aufwand und Fehler reduziert werden.
• Konsistente Benutzerdaten: Stellt sicher, dass Benutzerinformationen in allen integrierten Anwendungen konsistent sind, wodurch die Datenqualität und Compliance verbessert werden.
• Skalierbarkeit: Ermöglicht die einfache Verwaltung einer großen Anzahl von Benutzern über mehrere Plattformen hinweg, was es für wachsende Organisationen geeignet macht.
• Sicherheit: Erhöht die Sicherheit, indem sichergestellt wird, dass Benutzerzugriffe bei Bedarf unverzüglich aktualisiert oder widerrufen werden.

​

Vorteile von SCIM

• Effizienz: Automatisiert sich wiederholende Aufgaben und stellt IT-Ressourcen für strategischere Initiativen frei.
• Genauigkeit: Verringert das Risiko menschlicher Fehler bei der Benutzerverwaltung und stellt sicher, dass Benutzerdaten stets aktuell sind.
• Compliance: Hilft, die Einhaltung von Datenschutzvorschriften sicherzustellen, indem gewährleistet wird, dass Benutzerdaten konsequent verwaltet und geschützt werden.
• Integration: Lässt sich nahtlos in bestehende SSO-Lösungen integrieren und bietet ein umfassendes Identitätsmanagementsystem.

​

SCIM beim SSO-Provider konfigurieren

• Stellen Sie sicher, dass SCIM aktiviert ist.
• Richten Sie die Anwendung SCIM-Integration ein mit:
  • SCIM-Connector Basis-URL: https://www.corgea.app/scim/v2/
  • Eindeutiges Benutzerkennungsfeld: E-Mail
  • Unterstützte Bereitstellungsaktionen:
    • Neue Benutzer bereitstellen
    • Profilaktualisierungen pushen
  • Authentifizierungsmodus: HTTP-Header