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
- Daten von festiware in eurem Identity Provider eintragen
- Daten eures Identity Providers in festiware eintragen
- E-Mail-Domains per DNS bestätigen
- Testanmeldung durchführen
- 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/metadataendet, z.B.test.festiwa.re/auth/saml/metadata - ACS-URL / Antwort-URL: die Adresse, die auf
/auth/saml/acsendet, z.B.test.festiwa.re/auth/saml/acs - NameID-Format: E-Mail-Adresse (
emailAddress) - Start-URL / Anmelde-URL: die Adresse, die auf
/auth/saml/loginendet, 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
projectsausschließ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.
- Clients > Create client: Client type SAML, Client ID = Entity ID von festiware (endet auf
/auth/saml/metadata), Name z. B.festiware. - Unter Login settings bei Valid redirect URIs die ACS-URL von festiware eintragen, bei Home URL die Start-URL.
- Im Tab Settings: Name ID format =
email, Force name ID format an, Force POST binding an, Sign documents an. - Im Tab Keys: Client signature required aus.
- Im Tab Advanced bei Assertion Consumer Service POST Binding URL die ACS-URL eintragen.
- Im Tab Client scopes den Scope
…-dedicatedöffnen und mit Add mapper > By configuration > User Property drei Mapper anlegen: Propertyemail→ SAML Attribute Nameemail,firstName→firstName,lastName→lastName.
Rollen und Projekte mitschicken (optional):
- Realm settings > General > Unmanaged attributes auf Enabled stellen, damit Benutzer eigene Attribute bekommen können.
- Im Scope
…-dedicatedzwei Mapper vom Typ User Attribute anlegen: User Attributefestiware_roles→ SAML Attribute Namerolesundfestiware_projects→projects, jeweils mit Aggregate attribute values an. - Beim Benutzer unter Users > Tab Attributes die Werte eintragen, z. B. Key
festiware_roles, ValueCrew-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.
- Customization > Property Mappings > Create > SAML Provider Property Mapping: Name
festiware email, SAML Attribute Nameemail, Expressionreturn request.user.email. Optional ein zweites MappingdisplayNamemitreturn request.user.name. - Applications > Providers > Create > SAML Provider: Name
festiware, Authorization flowdefault-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. - Im selben Formular unter Advanced protocol settings: bei Property mappings die eigenen Mappings auswählen, bei NameID Property Mapping
festiware email. - Applications > Create: Name
festiware, Providerfestiware, 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, Expressionreturn request.user.attributes.get("festiware_roles", []) - SAML Attribute Name
projects, Expressionreturn 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.
- 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. - In der neuen Anwendung unter Benutzer und Gruppen festlegen, wer festiware nutzen darf. Gruppen zuweisen geht erst ab Entra ID P1, einzelne Benutzer immer.
- 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.
- Kasten Attribute & Ansprüche: Die Standardwerte reichen. Entra schickt E-Mail-Adresse und Anzeigenamen von sich aus mit.
- 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):
- 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.Leitungein. - 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.
- Einmaliges Anmelden > Attribute & Ansprüche > Bearbeiten > Neuen Anspruch hinzufügen: Name
roles, Namespace leer lassen, Quelle Attribut, Quellattributuser.assignedroles.
Google Workspace
Alle Schritte in der Google Admin-Konsole mit einem Super-Admin-Konto.
- Apps > Web- und mobile Apps > App hinzufügen > Benutzerdefinierte SAML-App hinzufügen. App-Name z. B.
festiware, dann Weiter. - Seite Google-IdP-Details: Metadaten herunterladen (Datei
GoogleIDPMetadata.xml), dann Weiter. - 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. - Seite Attributzuordnung: Primary email →
email, First name →firstName, Last name →lastName. Dann Fertigstellen. - 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.
- Applications > Applications > Create App Integration > SAML 2.0 > Next. App name z. B.
festiware. - 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. - 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 Werteuser.email,user.firstNameunduser.lastName. - Next > This is an internal app that we have created > Finish.
- 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:
- LDAP-Attribute als Ansprüche senden: Attributspeicher Active Directory,
E-Mail-Addresses→E-Mail-Adresse,Display-Name→Name. - 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.