Single Sign-on (SAML) einrichten

Mit Single Sign-on (SSO) melden sich eure Mitarbeitenden mit dem Konto eurer Organisation im festiware-Backend an, zum Beispiel mit Microsoft Entra ID (früher Azure AD), Google Workspace, Authentik, Okta oder Keycloak. Passwörter für festiware braucht dann niemand mehr. Wer euer Unternehmen verlässt und dort gesperrt wird, kommt auch nicht mehr ins Backend.

Single Sign-on ist in der BETA-Phase. Wendet euch an unseren Support unter support@festiware.eu, damit ihr das Feature freigeschaltet bekommt. Eingerichtet wird es von einem Account mit Zugriff auf die Systemeinstellungen, zusammen mit der Person, die bei euch den Identity Provider verwaltet.

So läuft die Einrichtung ab

  1. Daten von festiware in eurem Identity Provider eintragen
  2. Daten eures Identity Providers in festiware eintragen
  3. E-Mail-Domains per DNS bestätigen
  4. Testanmeldung durchführen
  5. SSO einschalten und bei Bedarf erzwingen

Alle Schritte findest du auf der Seite SSO-Einrichtung. Du erreichst sie über Einstellungen > Tab Single Sign-on > Link SSO-Einrichtung öffnen, oder direkt unter https://DEINE-INSTANZ.festiwa.re/auth/saml/setup .

1. Daten für euren Identity Provider

Lege in eurem Identity Provider eine neue SAML-Anwendung an und trage dort die Werte aus dem Abschnitt 1. Daten für euren Identity Provider ein:

  • Entity ID / Bezeichner: die Adresse, die auf /auth/saml/metadata  endet, z.B. test.festiwa.re/auth/saml/metadata
  • ACS-URL / Antwort-URL: die Adresse, die auf /auth/saml/acs  endet, z.B. test.festiwa.re/auth/saml/acs
  • NameID-Format: E-Mail-Adresse (emailAddress )
  • Start-URL / Anmelde-URL: die Adresse, die auf /auth/saml/login  endet, z.B. test.festiwa.re/auth/saml/login

Viele Identity Provider können die Werte auch direkt aus der Metadaten-Adresse lesen. festiware signiert seine Anmeldeanfragen nicht. Verlangt euer Identity Provider signierte Anfragen, schalte das dort aus.

Welche Attribute festiware erwartet

Attribut Pflicht Inhalt
NameID oder email ja die E-Mail-Adresse der Person
displayName oder firstName + lastName nein Name für neu angelegte Benutzer
roles nein Rollen in festiware, siehe Rollen und Projekte aus dem Identity Provider
projects nein Projekte in festiware, siehe Rollen und Projekte aus dem Identity Provider

2. Daten eures Identity Providers in festiware eintragen

Unter Einstellungen > Tab Single Sign-on trägst du aus eurem Identity Provider ein:

  • Entity ID des Identity Providers (bei Entra ID „Microsoft Entra-Bezeichner“, bei Google „Entitäts-ID“, bei Okta „Identity Provider Issuer“)
  • SSO-URL des Identity Providers (bei Entra ID „Anmelde-URL“, bei Google „SSO-URL“, bei Okta „Identity Provider Single Sign-On URL“)
  • Signaturzertifikat (X.509), mit oder ohne die Zeilen BEGIN/END
  • E-Mail-Domains, deren Benutzer sich per SSO anmelden, z. B. beispiel.de, beispiel.com

3. Domains bestätigen

Damit niemand fremde Adressen anmelden kann, muss jede Domain einmal bestätigt werden. Die SSO-Einrichtung zeigt für jede Domain einen Wert, der mit festiware-sso-verification=  beginnt. Lege ihn als TXT-Eintrag im DNS der Domain an und klicke auf DNS-Einträge prüfen. Änderungen im DNS können eine Weile brauchen, bis sie sichtbar sind.

Nur Personen mit einer bestätigten Domain können sich per SSO anmelden.

4. Testanmeldung

Klicke auf Testanmeldung starten. Du meldest dich beim Identity Provider an, wirst in festiware aber nicht umgemeldet. Stattdessen siehst du, was zurückkommt: die E-Mail-Adresse, ob es dazu schon einen Benutzer gibt, welche Rollen und Projekte eine Anmeldung setzen würde und alle übermittelten Attribute. Die Testanmeldung funktioniert auch, solange SSO noch ausgeschaltet ist.

5. SSO einschalten und erzwingen

Aktiviere Anmeldung per SSO (SAML) aktiv. Auf der Login-Seite erscheint dann der Button Mit SSO anmelden.

Mit SSO erzwingen können sich Personen mit einer bestätigten Domain nicht mehr mit Passwort im Backend anmelden. Führe vorher eine Testanmeldung durch. Die Check-in-App ist davon nicht betroffen.

Neue Benutzer automatisch anlegen

Standardmäßig können sich nur Personen anmelden, für die es in festiware schon einen Benutzer mit derselben E-Mail-Adresse gibt. Mit Neue Benutzer automatisch anlegen wird beim ersten Login ein Benutzer angelegt. Dafür legst du fest:

  • Rollen für neue Benutzer: Bleibt das Feld leer, bekommt der Benutzer keine Rollen. Er sieht dann nur das Dashboard mit dem Hinweis, sich an die Administration zu wenden.
  • Projekte für neue Benutzer: Bleibt das Feld leer, hat der Benutzer Zugriff auf alle Projekte.

Alle Accounts mit Benutzerverwaltung bekommen bei jedem neu angelegten Benutzer eine Benachrichtigung in festiware.

Wer im Identity Provider Zugriff auf die festiware-Anwendung hat, kann sich anmelden. Lege deshalb dort fest, welche Personen oder Gruppen die Anwendung nutzen dürfen.

Rollen und Projekte aus dem Identity Provider

Wenn ihr Rechte lieber zentral in eurem Identity Provider pflegt, kann er sie bei jeder Anmeldung mitschicken. Schalte dafür in den Einstellungen Rollen und Projekte aus dem Identity Provider übernehmen ein und lege in der SAML-Anwendung zusätzliche Attribute an:

Attribut Werte Beispiel
roles Rollennamen wie in festiware unter Einstellungen > Rollen. Groß- und Kleinschreibung, Leerzeichen, Punkte, Unterstriche und Bindestriche spielen keine Rolle. Universal Manager, Order Observer
projects Kurznamen der Projekte (Feld Kurzname im Projekt). Leer bedeutet: alle Projekte. fest26

Mehrere Werte kannst du als mehrere Attributwerte oder durch Komma getrennt in einem Wert übermitteln. Weil Leerzeichen und Trennzeichen nicht zählen, passt zum Beispiel crew.leitung  auf die Rolle Crew Leitung. Das ist bei Identity Providern wichtig, die keine Leerzeichen in Rollenwerten erlauben, wie Entra ID.

So wertet festiware die Attribute aus:

  • Schickt der Identity Provider ein Attribut mit, gilt es bei jeder Anmeldung und ersetzt, was im Backend für diese Person eingestellt ist. Rollen oder Projekte, die du in festiware von Hand vergibst, werden dann beim nächsten Login überschrieben.
  • Fehlt ein Attribut, bleiben Rollen bzw. Projekte so, wie sie im Backend eingestellt sind. Bei neuen Benutzern gelten dann die Standardwerte aus den Einstellungen.
  • Ist der Schalter aus, ignoriert festiware beide Attribute. Die Testanmeldung weist darauf hin, wenn sie trotzdem mitgeschickt werden.
  • Unbekannte Rollen und Projekte werden übersprungen. Nennt das Attribut projects  ausschließlich unbekannte Projekte, wird die Anmeldung abgelehnt, damit niemand versehentlich Zugriff auf alle Projekte bekommt.
  • Die Rolle Super Admin kann nie über SSO vergeben werden.

Prüfe die Zuordnung vor dem Einschalten mit der Testanmeldung. Sie zeigt, welche Rollen und Projekte eine Anmeldung setzen würde und welche Namen unbekannt sind.

Benutzerlizenz

Ist in eurem Vertrag eine Anzahl an Benutzern vereinbart, lassen sich im Backend keine weiteren Benutzer anlegen, sobald sie erreicht ist. Das Dashboard zeigt den Accounts mit Benutzerverwaltung dann einen Hinweis. Anmeldungen per SSO werden auch darüber hinaus angenommen, damit niemand am Veranstaltungstag ausgesperrt ist. Die Benachrichtigung zum neuen Benutzer weist in diesem Fall auf die Überschreitung hin. Für mehr Benutzer meldet euch bei support@festiware.eu.

Gut zu wissen

  • Anmeldung immer über festiware starten: Eine Kachel im Portal eures Identity Providers muss auf die Start-URL (/auth/saml/login ) zeigen. Eine direkt beim Identity Provider gestartete Anmeldung lehnt festiware ab.
  • Zwei-Faktor-Authentifizierung: Bei einer SSO-Anmeldung fragt festiware keinen eigenen Code ab. Den zweiten Faktor prüft euer Identity Provider.
  • Check-in-App: Die Check-in-App meldet sich weiter mit ihren eigenen Zugangsdaten an.
  • Gelöschte Benutzer: Ein in festiware gelöschter Benutzer wird durch SSO nicht wiederhergestellt.

Einrichtung bei den einzelnen Anbietern

Keycloak

Getestet mit Keycloak 26. Alle Schritte in der Admin-Konsole im Realm eurer Mitarbeitenden.

  1. Clients > Create client: Client type SAML, Client ID = Entity ID von festiware (endet auf /auth/saml/metadata ), Name z. B. festiware .
  2. Unter Login settings bei Valid redirect URIs die ACS-URL von festiware eintragen, bei Home URL die Start-URL.
  3. Im Tab Settings: Name ID format = email , Force name ID format an, Force POST binding an, Sign documents an.
  4. Im Tab Keys: Client signature required aus.
  5. Im Tab Advanced bei Assertion Consumer Service POST Binding URL die ACS-URL eintragen.
  6. Im Tab Client scopes den Scope …-dedicated  öffnen und mit Add mapper > By configuration > User Property drei Mapper anlegen: Property email  → SAML Attribute Name email , firstName  → firstName , lastName  → lastName .

Rollen und Projekte mitschicken (optional):

  1. Realm settings > General > Unmanaged attributes auf Enabled stellen, damit Benutzer eigene Attribute bekommen können.
  2. Im Scope …-dedicated  zwei Mapper vom Typ User Attribute anlegen: User Attribute festiware_roles  → SAML Attribute Name roles  und festiware_projects  → projects , jeweils mit Aggregate attribute values an.
  3. Beim Benutzer unter Users > Tab Attributes die Werte eintragen, z. B. Key festiware_roles , Value Crew-Leitung . Für mehrere Rollen den Key mehrfach anlegen.

Daten für festiware: unter Realm settings > Endpoints > SAML 2.0 Identity Provider Metadata. Entity ID ist https://KEYCLOAK/realms/REALM , SSO-URL ist https://KEYCLOAK/realms/REALM/protocol/saml , das Zertifikat steht im Feld X509Certificate .

Keycloak schickt zusätzlich eine eigene Rollenliste (Attribut Role ) mit. festiware ignoriert sie.


Authentik

Getestet mit Authentik 2025.6. Alle Schritte in der Admin-Oberfläche.

  1. Customization > Property Mappings > Create > SAML Provider Property Mapping: Name festiware email , SAML Attribute Name email , Expression return request.user.email . Optional ein zweites Mapping displayName  mit return request.user.name .
  2. Applications > Providers > Create > SAML Provider: Name festiware , Authorization flow default-provider-authorization-implicit-consent , ACS URL = ACS-URL von festiware, Audience = Entity ID von festiware, Service Provider Binding Post, Signing Certificate auswählen, Sign assertions an.
  3. Im selben Formular unter Advanced protocol settings: bei Property mappings die eigenen Mappings auswählen, bei NameID Property Mapping festiware email .
  4. Applications > Create: Name festiware , Provider festiware , Launch URL = Start-URL von festiware. Über Policy / Group / User Bindings festlegen, wer die Anwendung nutzen darf.

Rollen und Projekte mitschicken (optional): zwei weitere SAML Provider Property Mappings anlegen und dem Provider zuordnen:

  • SAML Attribute Name roles , Expression return request.user.attributes.get("festiware_roles", [])
  • SAML Attribute Name projects , Expression return request.user.attributes.get("festiware_projects", [])

Beim Benutzer unter Directory > Users > Edit > Attributes eintragen, z. B.:

festiware_roles:
  - Universal Observer
festiware_projects:
  - fest26

Wer Rollen lieber über Gruppen steuert, nimmt für roles  die Expression return [group.name for group in request.user.ak_groups.all()] . Dann müssen die Gruppen in Authentik so heißen wie die Rollen in festiware.

Daten für festiware: auf der Seite des Providers unter Related objects > Metadata. Entity ID ist das Feld entityID , SSO-URL ist die Adresse mit /sso/binding/redirect/ , das Zertifikat lädst du über Download signing certificate herunter.


Microsoft Entra ID

Alle Schritte im Microsoft Entra Admin Center mit der Rolle Globaler Administrator oder Anwendungsadministrator. Eigene SAML-Anwendungen gehen auch mit Entra ID Free.

  1. Anwendungen > Unternehmensanwendungen > Neue Anwendung > Eigene Anwendung erstellen. Name z. B. festiware , Option Beliebige andere Anwendung integrieren, die nicht im Katalog zu finden ist, dann Erstellen.
  2. In der neuen Anwendung unter Benutzer und Gruppen festlegen, wer festiware nutzen darf. Gruppen zuweisen geht erst ab Entra ID P1, einzelne Benutzer immer.
  3. Einmaliges Anmelden > SAML > Kasten Grundlegende SAML-Konfiguration > Bearbeiten: Bezeichner (Entitäts-ID) = Entity ID von festiware, Antwort-URL = ACS-URL, Anmelde-URL = Start-URL. Speichern.
  4. Kasten Attribute & Ansprüche: Die Standardwerte reichen. Entra schickt E-Mail-Adresse und Anzeigenamen von sich aus mit.
  5. Kasten SAML-Zertifikate: Zertifikat (Base64) herunterladen.

Daten für festiware: im Kasten festiware einrichten. Microsoft Entra-Bezeichner ist die Entity ID, Anmelde-URL die SSO-URL. Die Zertifikatsdatei öffnest du mit einem Texteditor und kopierst den Inhalt in das Feld Signaturzertifikat.

Hat ein Benutzer kein Postfach, schickt Entra keine E-Mail-Adresse. festiware nimmt dann den Anmeldenamen (UPN, z. B. name@beispiel.de ). Er muss auf einer bestätigten Domain liegen.

Rollen mitschicken (optional):

  1. Anwendungen > App-Registrierungen > Alle Anwendungen > eure festiware-Anwendung > App-Rollen > App-Rolle erstellen. Anzeigename beliebig, zulässige Mitgliedstypen Benutzer/Gruppen, Wert = Name der Rolle in festiware. Der Wert darf keine Leerzeichen enthalten: Für die Rolle Crew Leitung trägst du Crew.Leitung  ein.
  2. Unter Unternehmensanwendungen > festiware > Benutzer und Gruppen beim Zuweisen die Rolle auswählen. Pro Zuweisung gibt es eine Rolle. Für mehrere Rollen weist du die Person mehrfach zu oder nutzt Gruppen.
  3. Einmaliges Anmelden > Attribute & Ansprüche > Bearbeiten > Neuen Anspruch hinzufügen: Name roles , Namespace leer lassen, Quelle Attribut, Quellattribut user.assignedroles .

Google Workspace

Alle Schritte in der Google Admin-Konsole mit einem Super-Admin-Konto.

  1. Apps > Web- und mobile Apps > App hinzufügen > Benutzerdefinierte SAML-App hinzufügen. App-Name z. B. festiware , dann Weiter.
  2. Seite Google-IdP-Details: Metadaten herunterladen (Datei GoogleIDPMetadata.xml ), dann Weiter.
  3. Seite Dienstanbieter-Details: ACS-URL = ACS-URL von festiware, Entitäts-ID = Entity ID von festiware, Start-URL = Start-URL. Signierte Antwort aus lassen. Name-ID-Format = EMAIL , Name-ID = Basic Information > Primary email. Dann Weiter.
  4. Seite Attributzuordnung: Primary email → email , First name → firstName , Last name → lastName . Dann Fertigstellen.
  5. In der App den Kasten Nutzerzugriff öffnen und den Dienst für alle oder für ausgewählte Organisationseinheiten bzw. Gruppen auf AN stellen. Standardmäßig ist die App AUS. Dann zeigt Google beim Login den Fehler app_not_enabled_for_user . Die Änderung kann ein paar Minuten dauern.

Daten für festiware: aus der Datei GoogleIDPMetadata.xml  oder von der Seite Google-IdP-Details. Entitäts-ID (beginnt mit https://accounts.google.com/o/saml2?idpid= ) ist die Entity ID, SSO-URL (beginnt mit https://accounts.google.com/o/saml2/idp?idpid= ) die SSO-URL. Dazu kommt das Zertifikat.

Rollen über Google-Gruppen (optional): In der App unter SAML-Attributzuordnung > Gruppenmitgliedschaft die Gruppen auswählen, die als Rollen gelten sollen, App-Attribut roles . Google schickt nur die ausgewählten Gruppen, in denen die Person Mitglied ist. Die Gruppen müssen so heißen wie die Rollen in festiware.


Okta

Alle Schritte in der Okta Admin Console.

  1. Applications > Applications > Create App Integration > SAML 2.0 > Next. App name z. B. festiware .
  2. Unter Configure SAML: Single sign-on URL = ACS-URL von festiware, Haken bei Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID) = Entity ID von festiware. Name ID format = EmailAddress , Application username = Email .
  3. Unter Attribute statements mit Add expression drei Einträge anlegen: email  → user.profile.email , firstName  → user.profile.firstName , lastName  → user.profile.lastName . In der älteren Oberfläche heißen die Werte user.email , user.firstName  und user.lastName .
  4. Next > This is an internal app that we have created > Finish.
  5. Im Tab Assignments die Personen oder Gruppen zuweisen, die festiware nutzen dürfen.

Daten für festiware: im Tab Sign On unter View SAML setup instructions. Identity Provider Issuer ist die Entity ID, Identity Provider Single Sign-On URL die SSO-URL, dazu das X.509 Certificate.

Rollen über Okta-Gruppen (optional): In der App unter Show legacy configuration > Group attribute statements > Edit einen Eintrag mit Name roles  anlegen, Filter Matches regex, Wert .* . Achtung: Mit dem Filter Starts with wird .*  als fester Text gelesen, dann kommt keine Gruppe an. Die Gruppen in Okta müssen so heißen wie die Rollen in festiware. Die Okta-Standardgruppe Everyone wird mitgeschickt und von festiware ignoriert.

Je nach Richtlinie verlangt Okta beim ersten Login einen zweiten Faktor, zum Beispiel Okta Verify oder einen Passkey.


Weitere Anbieter

Jeder Identity Provider mit SAML 2.0 funktioniert, zum Beispiel Microsoft ADFS, JumpCloud, OneLogin oder Ping Identity. Richte ihn nach den allgemeinen Schritten oben ein. Wichtig sind drei Punkte: Die E-Mail-Adresse kommt als NameID im Format emailAddress  an, die Antwort oder die Assertion ist signiert, und der Identity Provider erwartet keine signierten Anmeldeanfragen.

Microsoft ADFS: Lege eine Vertrauensstellung der vertrauenden Seite (Relying Party Trust) an, am einfachsten über die Metadaten-Adresse von festiware. Unter Anspruchsausstellungsrichtlinie bearbeiten (Edit Claim Issuance Policy) brauchst du zwei Regeln:

  1. LDAP-Attribute als Ansprüche senden: Attributspeicher Active Directory, E-Mail-Addresses  → E-Mail-Adresse , Display-Name  → Name .
  2. Eingehenden Anspruch transformieren: eingehend E-Mail-Adresse , ausgehend Namens-ID (Name ID) mit dem Format E-Mail.

Fehlt die zweite Regel, bricht ADFS die Anmeldung mit einem Fehler zur NameID-Richtlinie ab.

Hakt es bei einem Anbieter, schick uns das Ergebnis der Testanmeldung an support@festiware.eu.

Hat das Deine Frage beantwortet? Danke für Dein Feedback Es gab ein Problem beim Absenden Deines Feedbacks

Brauchst Du weitere Hilfe? Schreib uns! Schreib uns!