Single-Sign-On (SSO) Setup Via Azure AD / ENTRA ID

Schritt 1: Enterprise Application erstellen

Melden Sie sich im Azure-Portal an.

Navigieren Sie zu Azure Active Directory / Microsoft Entra ID und fügen Sie eine neue Enterprise Application hinzu.

Wählen Sie „Create your own application“, benennen Sie diese „Stackgini“ und wählen Sie „Integrate any other application you don’t find in the gallery (Non-gallery)“.

Schritt 2: Single Sign-On konfigurieren

Öffnen Sie die erstellte Anwendung und navigieren Sie zum Menü „Single sign-on“.

Wählen Sie SAML als Anmeldemethode.

Schritt 3: SAML-Einstellungen ausfüllen

Sie können für die SAML Einstellung die vordefinierten Links verwenden. Dazu müssen Sie <TENANT> durch den Namen Ihres Stackgini Tenants ersetzen. (Sie finden ihn in Ihrer Stackgini-URL direkt nach app.softwaregini.com/. Falls Sie unsicher sind, fragen Sie uns gern.)

Identifier (Entity ID): urn:stackgini:sso:<TENANT>

Reply URL (Assertion Consumer Service URL): https://softwaregini.com/auth/realms/softwaregini/broker/<TENANT>/endpoint

Logout Url (optional): https://app.softwaregini.com/<TENANT>/logout

Hinweis: Wenn Sie SSO mit Stackgini vor dem 23.10.2026 eingerichtet haben, behalten Sie Ihren bisherigen Identifier. Ändern Sie ihn nicht.

Schritt 4: Attributes & Claims

Erforderlich:

Öffnen Sie „Unique User Identifier (Name ID)“ und setzen Sie das „Source attribute“ auf user.mail. Behalten Sie das Format „Email address“ bei.
Behalten Sie die Standard-Claims unter „Additional claims“ bei: emailaddress, givenname, surname, name. Stackgini liest daraus die E-Mail-Adresse und den Namen.
Falls Sie user.mail nicht verwenden können, teilen Sie uns mit, welchen Wert Sie stattdessen nutzen.

Optional: Rollenzuordnung

Nutzen Sie diese Option nur, wenn Entra ID festlegen soll, wer in Stackgini Admin oder Manager ist. Ohne Rollenzuordnung vergeben Ihre Stackgini-Admins die Rollen direkt in Stackgini.

Hinweis: Die Rollenzuordnung schaltet die Rollenverwaltung in Stackgini ab. Bei jeder Anmeldung erhält jede Person in Stackgini die Rolle, die Entra ID übermittelt. Übermittelt Entra ID keine Rolle, wird sie in Stackgini entfernt.

Öffnen Sie „App registrations“ > „All applications“ und wählen Sie „Stackgini“.
Öffnen Sie „App roles“ und klicken Sie auf „Create app role“:
- Display name: Stackgini Admin
- Allowed member types: Users/Groups
- Value: Stackgini.Admin (genau so geschrieben)
- Description: Admin in Stackgini
- Lassen Sie „Do you want to enable this app role?“ angehakt und klicken Sie auf „Apply“.
Optional: Erstellen Sie auf dieselbe Weise eine zweite App Role mit dem Value Stackgini.Manager.
Öffnen Sie „Enterprise applications“ > „Stackgini“ > „Users and groups“. Klicken Sie auf „Add user/group“, wählen Sie die Benutzer oder Gruppen und die Rolle aus und klicken Sie auf „Assign“.

Hinweise:

Nur direkte Mitglieder einer zugewiesenen Gruppe erhalten die Rolle. Mitglieder verschachtelter Gruppen erhalten sie nicht.
Um Gruppen zuzuweisen, benötigen Sie Microsoft Entra ID P1 oder P2.

Schritt 5: Konfigurationsdetails an Stackgini übermitteln

Um die Einrichtung abzuschließen, senden Sie bitte die folgenden Informationen per E-Mail an service@stackgini.de:

Die „App Federation Metadata Url“. Sie finden sie unter „Single sign-on“ > „SAML Certificates“. Sie enthält appid=. Bitte senden Sie ausschließlich die URL und nicht die heruntergeladene XML-Datei. Über die URL können wir Zertifikatsaktualisierungen automatisch übernehmen, sodass bei einem Zertifikatswechsel kein manueller Austausch nötig ist.
Falls Sie die Rollenzuordnung nutzen: welche App Roles Sie angelegt haben (Stackgini.Admin, Stackgini.Manager).
Falls Sie nicht user.mail als Unique User Identifier verwenden: den Wert, den Sie stattdessen nutzen.

Schritt 6: Zugang für relevante Benutzergruppen freigeben

Bitte stimmen Sie intern ab, welche Benutzer und Benutzergruppen Zugang zu Stackgini per SSO erhalten sollen.

Kontaktdaten

Bei Fragen wenden Sie sich bitte an Ihren Stackgini Ansprechpartner aus dem Kundenservice.