Konfigurieren des einmaligen Anmeldens (SSO) für Zammad Single Sign-On

Konfigurieren Sie Zammad SSO in wenigen einfachen Schritten mit dieser Einrichtungsanleitung. miniOrange Single Sign-On (SSO) hilft Ihnen, sich mit einem einzigen Satz Anmeldeinformationen bei Zammad und anderen Anwendungen anzumelden. Nach der Aktivierung von SSO für Zammad kann eine Person mit einem Klick sicher auf Zammad zugreifen, ohne ihren Benutzernamen und ihr Passwort erneut eingeben zu müssen.

Mit miniOrange Zammad SSO können Sie:

Ermöglichen Sie Ihren Benutzern die automatische Anmeldung bei Zammad
Zentralisierte und einfache Zugriffskontrolle der Benutzer
Einfache Verbindung mit jeder externen Identitätsquelle wie Azure AD, ADFS, Cognito usw.

Kostenlose Installationshilfe

miniOrange bietet Ihnen kostenlose Unterstützung durch ein Beratungsgespräch mit unseren Systemingenieuren zur Installation oder Einrichtung der Zammad SSO-Lösung in Ihrer Umgebung mit einer 30-tägigen kostenlosen Testphase.

Hierfür müssen Sie uns lediglich eine E-Mail an idpsupport@xecurify.com senden , um einen Termin zu vereinbaren, und wir helfen Ihnen umgehend weiter.

Support

miniOrange Zammad Single Sign-On (SSO) unterstützt die folgenden Funktionen:

Vom SP (Service Provider) initiiertes Single Sign-On (SSO):
In diesem Ablauf versucht eine Person, sich direkt beim Dienstanbieter (Zammad-Konto) anzumelden. Die Anfrage wird zur Authentifizierung an den Identitätsanbieter weitergeleitet. Nach erfolgreicher Authentifizierung durch den Identitätsanbieter erhält die Person Zugriff auf die Anwendung (Zammad-Konto).
Vom IdP (Identity Provider) initiiertes Single Sign-On (SSO):
In diesem Ablauf meldet sich eine Person mit ihren Anmeldeinformationen beim Identitätsanbieter an. Jetzt kann die Person über das Dashboard des Identitätsanbieters auf alle konfigurierten Dienstanbieter (Zammad-Konto usw.) zugreifen, ohne die Anmeldeinformationen erneut eingeben zu müssen.
Just-in-Time-Bereitstellung:
Dadurch wird die Erstellung von Benutzerkonten automatisiert und Informationen in Ihren Anwendungen werden über den Identitätsanbieter weitergegeben. Wenn sich ein neuer Benutzer also zum ersten Mal bei einer autorisierten App anmeldet, löst er den Informationsfluss vom Identitätsanbieter zur App aus, der zum Erstellen seines Kontos erforderlich ist.

Mit externer Benutzerquelle verbinden

miniOrange bietet Benutzerauthentifizierung aus verschiedenen externen Quellen, darunter Verzeichnisse (wie ADFS, Microsoft Active Directory, OpenLDAP, AWS usw.), Identitätsanbieter (wie Microsoft Entra ID, Okta, AWS) und viele mehr. Sie können Ihr bestehendes Verzeichnis/Ihren Benutzerspeicher konfigurieren oder Benutzer in miniOrange hinzufügen.

Folgen Sie der Schritt-für-Schritt-Anleitung zur Einrichtung von Zammad Single Sign-On (SSO)

1. Konfigurieren Sie Zammad in miniOrange

Melden Sie sich bei miniOrange an Admin-Konsole.
Zurück Nach Apps und klicken Sie auf Anwendung hinzufügen .

Zammad Single Sign-On (SSO) App hinzufügen

In Wählen Sie AnwendungstypWählen SAML/WS-FED von der Alle Apps Dropdown-Liste.

Zammad Single Sign-On (SSO) App-Typ auswählen

Suchen Sie nach Zammad in der Liste, wenn Sie Zammad nicht in der Liste finden, suchen Sie nach Original und Sie können Ihre Anwendung einrichten in Benutzerdefinierte SAML-App.

Zammad Single Sign-On (SSO) Apps verwalten

Klicken Sie auf SP-Metadaten importieren Taste. Eingeben App Name und wählen Sie URL as SP-Metadaten Format. Fügen Sie die Zammad-Metadaten-URL ein: https://your.zammad.domain/auth/saml/metadata (Ersetzen Sie „Ihre.zammad.domain“ durch Ihre Zammad-Domain).

Zammad Single Sign-On (SSO) SP-Metadatendatei im miniOrange Dashboard hochladen

Klicken Sie auf Gespeichert.

Holen Sie sich IdP-Metadatendetails zum Hochladen auf Zammad:

Zurück Nach Apps >> Apps verwalten.
Suchen Sie nach Ihrer App und klicken Sie auf das Auswählen im Aktionsmenü für Ihre App.
Klicken Sie auf Metadaten um Metadatendetails abzurufen, die später benötigt werden. Klicken Sie auf SSO-Link anzeigen um den vom IDP initiierten SSO-Link für Zammad anzuzeigen.

Zammad Creator SSO (Single Sign-On) Metadaten-Link

Hier sehen Sie 2 Optionen, wenn Sie einrichten miniOrange als IDP Kopieren Sie die Metadatendetails zu miniOrange, wenn Sie eine Authentifizierung benötigen über externe IDPs (OKTA, AZURE AD, ADFS, ONELOGIN, Zoho) Sie können Metadaten aus dem 2. Abschnitt abrufen, wie unten gezeigt.

Zammad Creator Single Sign-On (SSO) SAML-Anwendung hinzufügen

Behalten SAML-Anmelde-URL, SAML-Abmelde-URL und klicken Sie auf Zertifikat herunterladen , um das Zertifikat herunterzuladen, das Sie benötigen in Schritt 2:.

Zammad Creator Single Sign-On (SSO) Wählen Sie Metadatendetails externer IDP oder miniOrange als IDP

2. SSO in Zammad konfigurieren

Melden Sie sich mit dem Link, der Ihnen bei der Kontoerstellung per E-Mail zugesandt wurde, bei Ihrem Zammad-Administratorkonto an.
Klicken Sie auf Symbol „Einstellungen“ >> „Sicherheit“ >> „Anwendungen von Drittanbietern“. Scrollen Sie nach unten, um die zu finden Authentifizierung über SAML und aktivieren Sie den Umschaltknopf.

Zammad SAML Single Sign On (SSO) SAML-Einstellungen

Tragen Sie nun die Metadatenwerte in die entsprechenden Felder ein, die Sie aus Schritt 1:.
Enter ANZEIGENAME.
Enter SAML-Anmelde-URL in IDP SSO-ZIEL-URL Feld.
Enter SAML-Abmelde-URL in IDP SINGLE LOGOUT-ZIEL-URL Feld.
Fügen Sie das ein X.509-Zertifikat in Feld „IDP-Zertifikat“.
Klicken Sie auf Absenden um den Vorgang abzuschließen. miniOrange ist erfolgreich als IDP konfiguriert.

3. SSO-Konfiguration testen

Testen Sie die SSO-Anmeldung bei Ihrem Zammad-Konto mit miniOrange IdP:

Verwenden der SP-initiierten Anmeldung

Gehen Sie zu Ihrer Zammad-URL. Hier werden Sie entweder aufgefordert, den Benutzernamen einzugeben oder auf den SSO-Link zu klicken, der Sie zur Anmeldeseite von miniOrange IdP weiterleitet.

Geben Sie Ihre miniOrange-Anmeldedaten ein und klicken Sie auf Anmelden. Sie werden automatisch bei Ihrem Zammad-Konto angemeldet.

Verwenden der IDP-initiierten Anmeldung

Melden Sie sich mit Ihren Anmeldeinformationen bei miniOrange IdP an.

Klicken Sie im Dashboard auf Zammad Anwendung, die Sie hinzugefügt haben, um die SSO-Konfiguration zu überprüfen.

Sie können SSO nicht konfigurieren oder testen?

Kontaktieren Sie uns oder senden Sie uns eine E-Mail an idpsupport@xecurify.com , und wir helfen Ihnen umgehend bei der Einrichtung.

4. Konfigurieren Sie Ihr Benutzerverzeichnis (optional)

miniOrange bietet Benutzerauthentifizierung aus verschiedenen externen Quellen, darunter Verzeichnisse (wie ADFS, Microsoft Active Directory, Microsoft Entra ID, OpenLDAP, Google, AWS Cognito usw.), Identitätsanbieter (wie Okta, Shibboleth, Ping, OneLogin, Keycloak), Datenbanken (wie MySQL, MariaDB, PostgreSQL) und viele mehr . Sie können Ihr bestehendes Verzeichnis/Ihren Benutzerspeicher konfigurieren oder Benutzer in miniOrange hinzufügen.

Richten Sie miniOrange als IDP ein
AD als Benutzerverzeichnis einrichten
Externen IDP einrichten

Um Ihre Benutzer in miniOrange hinzuzufügen, gibt es zwei Möglichkeiten:

Benutzer in miniOrange erstellen
Benutzer für Massen-Upload

1. Benutzer in miniOrange erstellen

Klicken Sie auf Benutzer >> Benutzerliste >> Benutzer hinzufügen.

Zammad: Benutzer in miniOrange hinzufügen

Füllen Sie hier die Benutzerdaten ohne Passwort aus und klicken Sie anschließend auf Benutzer erstellen .

Nach erfolgreicher Benutzererstellung wird eine Benachrichtigungsmeldung angezeigt „Ein Endbenutzer wurde erfolgreich hinzugefügt“ wird oben im Dashboard angezeigt.

Klicken Sie auf Registerkarte „Onboarding-Status“. Überprüfen Sie die E-Mail mit der registrierten E-Mail-ID und wählen Sie Aktion Aktivierungsmail mit Link zum Zurücksetzen des Passworts senden ab Aktion auswählen Dropdown-Liste und klicken Sie dann auf Tragen Sie .

Öffnen Sie nun Ihre E-Mail-ID. Öffnen Sie die E-Mail, die Sie von miniOrange erhalten haben, und klicken Sie dann auf Link um Ihr Kontopasswort festzulegen.
Geben Sie auf dem nächsten Bildschirm das Passwort ein und bestätigen Sie das Passwort. Klicken Sie dann auf Single Sign-On (SSO) Kennwort zurücksetzen .

Jetzt können Sie sich durch Eingabe Ihrer Anmeldeinformationen beim MiniOrange-Konto anmelden.

2. Massenupload von Benutzern in miniOrange durch Hochladen einer CSV-Datei.

Navigieren Benutzer >> Benutzerliste. Klicken Sie auf Benutzer hinzufügen .

Zammad: Benutzer per Massenupload hinzufügen

Massenregistrierung von Benutzern Beispiel-CSV-Format herunterladen von unserer Konsole aus und bearbeiten Sie diese CSV-Datei gemäß den Anweisungen.

Zammad: Beispiel-CSV-Datei herunterladen

Um Benutzer in großen Mengen hochzuladen, wählen Sie die Datei aus und stellen Sie sicher, dass sie in Komma-getrenntes CSV-Dateiformat Klicken Sie dann auf Hochladen.

Nach dem erfolgreichen Hochladen der CSV-Datei wird Ihnen eine Erfolgsmeldung mit einem Link angezeigt.
Klicken Sie auf diesen Link. Sie sehen eine Liste der Benutzer, denen eine Aktivierungsmail gesendet werden soll. Wählen Sie Benutzer aus, denen eine Aktivierungsmail gesendet werden soll, und klicken Sie auf „Aktivierungsmail senden“. Eine Aktivierungsmail wird an die ausgewählten Benutzer gesendet.

Klicken Sie auf Identitätsanbieter >> Identitätsanbieter hinzufügen im linken Menü des Dashboards

Zammad: AD als externes Verzeichnis konfigurieren

Wählen Sie unter „Identitätsanbieter auswählen“ AD/LDAP-Verzeichnisse aus dem Dropdown.

Zammad: Wählen Sie den Verzeichnistyp als AD/LDAP

Dann suchen Sie nach AD/LDAP und klicke es an.

LDAP-KONFIGURATION IN MINIORANGE SPEICHERN: Wählen Sie diese Option, wenn Sie Ihre Konfiguration in miniOrange behalten möchten. Befindet sich das Active Directory hinter einer Firewall, müssen Sie die Firewall öffnen, um eingehende Anfragen an Ihr AD zuzulassen.
SPEICHERN SIE DIE LDAP-KONFIGURATION VOR ORT: Wählen Sie diese Option, wenn Sie Ihre Konfiguration in Ihrem Gebäude behalten und nur den Zugriff auf AD innerhalb des Gebäudes zulassen möchten. Sie müssen herunterladen und installieren miniOrange-Gateway auf Ihrem Gelände.

Zammad: Wählen Sie den AD/LDAP-Benutzerspeichertyp

AD/LDAP eingeben Display Name und Identifizieren Namen.
Auswählen Verzeichnistyp as Active Directory.
Geben Sie die LDAP-Server-URL oder IP-Adresse für das LDAP ein Server-URL Feld.
Klicken Sie auf Verbindung testen Klicken Sie auf die Schaltfläche, um zu überprüfen, ob die Verbindung mit Ihrem LDAP-Server.

Zammad: Konfigurieren Sie die URL-Verbindung zum LDAP-Server

Gehen Sie in Active Directory zu den Eigenschaften von Benutzercontainern/OUs und suchen Sie nach dem Distinguished Name-AttributDas Bind-Konto sollte über die erforderlichen Mindestleseberechtigungen in Active Directory verfügen, um Verzeichnissuchen zu ermöglichen. Wenn der Anwendungsfall die Bereitstellung umfasst (z. B. Erstellen, Aktualisieren oder Löschen von Benutzern oder Gruppen), muss dem Konto auch die entsprechenden Schreibberechtigungen erteilt werden.

Zammad: Konfigurieren Sie den Domänennamen des Benutzerbindungskontos

Geben Sie das gültige Kennwort für das Bind-Konto ein.
Klicken Sie auf Testen der Anmeldeinformationen für das Bind-Konto Schaltfläche, um Ihre LDAP-Bind-Anmeldeinformationen für die LDAP-Verbindung zu überprüfen.

Zammad: Überprüfen Sie die Anmeldeinformationen des Bind-Kontos

Suchbasis ist die Stelle im Verzeichnis, an der die Suche nach einem Benutzer beginnt. Sie erhalten diese von derselben Stelle, an der Sie Ihren Distinguished Name haben.

Wählen Sie einen geeigneten Suchfilter aus dem Dropdown-Menü. Wenn Sie Benutzer im Einzelgruppenfilter or Benutzer im Mehrfachgruppenfilter, ersetze dasGruppen-DN> im Suchfilter mit dem Distinguished Name der Gruppe, in der Ihre Benutzer vorhanden sind. Um benutzerdefinierte Suchfilter zu verwenden, wählen Sie „Schreiben Sie Ihren benutzerdefinierten Filter“ Option und passen Sie sie entsprechend an.

Klicken Sie auf Weiter oder gehen Sie zum Anmeldeoptionen Tab.
Sie können beim Einrichten von AD auch folgende Optionen konfigurieren. Aktivieren Aktivieren Sie LDAP um Benutzer von AD/LDAP zu authentifizieren. Klicken Sie auf das Weiter Schaltfläche, um einen Benutzerspeicher hinzuzufügen.

Hier ist die Liste der Attribute und was sie bewirken, wenn wir sie aktivieren. Sie können sie entsprechend aktivieren/deaktivieren.

Attribut	Beschreibung
Aktivieren Sie LDAP	Alle Benutzerauthentifizierungen werden mit LDAP-Anmeldeinformationen durchgeführt, wenn Sie es aktivieren
Fallback-Authentifizierung	Wenn die LDAP-Anmeldeinformationen fehlschlagen, wird der Benutzer über miniOrange authentifiziert.
Administratoranmeldung aktivieren	Wenn Sie dies aktivieren, wird Ihr miniOrange Administrator-Login über Ihren LDAP-Server authentifiziert.
Benutzern IdP anzeigen	Wenn Sie diese Option aktivieren, ist dieser IdP für Benutzer sichtbar
Benutzer in miniOrange synchronisieren	Benutzer werden in miniOrange nach der Authentifizierung mit LDAP erstellt

Klicken Sie auf Weiter oder gehen Sie zum Attribute Tab.

Attributzuordnung aus AD

Standardmäßig sind Benutzername, Vorname, Nachname und E-Mail konfiguriert. Scrollen Sie nach unten und klicken Sie auf Gespeichert Schaltfläche. Um zusätzliche Attribute aus Active Directory abzurufen, aktivieren Sie Konfigurierte Attribute sendenGeben Sie links den Namen ein, den Sie für die Anwendungen freigeben möchten. Geben Sie rechts den Attributnamen aus Active Directory ein. Wenn Sie beispielsweise ein Firmenattribut aus Active Directory abrufen und als Organisation an konfigurierte Anwendungen senden möchten, geben Sie Folgendes ein:
An SP gesendeter Attributname = Organisation
Attributname vom IDP = Unternehmen

Zammad: Aktivieren Sie das Senden konfigurierter Attribute

Klicken Sie auf Weiter oder gehen Sie zum Provisioning Tab.

Benutzerimport und Provisionierung aus AD

Wenn Sie die Bereitstellung einrichten möchten, hier klicken für detaillierte Informationen. Wir werden diesen Schritt vorerst überspringen.

Zammad: Provisioning vorerst überspringen

Kennwortrichtlinie aus AD importieren

Wenn Sie Ihre Active Directory-Kennwortrichtlinie in miniOrange importieren möchten, hier klicken für detaillierte Informationen. Wir werden diesen Schritt vorerst überspringen.

Zammad: Überspringen Sie vorerst den Import der Passwortrichtlinie.

Testverbindungen

Sie sehen eine Liste der Verzeichnisse unter Identitätsanbieter. Wählen Sie im Dropdown-Menü aus AD/LDAP-Verzeichnisse, suchen Sie nach Ihrem konfigurierten Verzeichnis, klicken Sie auf die drei Punkte daneben und wählen Sie Verbindung testen.

Es wird ein Popup-Fenster angezeigt, in dem Sie aufgefordert werden, einen Benutzernamen und ein Kennwort einzugeben, um Ihre LDAP-Konfiguration zu überprüfen.

Zammad: Geben Sie Benutzernamen und Passwort ein, um die LDAP-Verbindung zu testen

On Erfolgreich Bei der Verbindung mit dem LDAP-Server wird eine Erfolgsmeldung angezeigt.

Zammad: Erfolgreiche Verbindung mit LDAP-Server

Testen Sie die Attributzuordnung

Sie sehen eine Liste der Verzeichnisse unter Identitätsanbieter. Wählen Sie im Dropdown-Menü aus AD/LDAP-Verzeichnisse, suchen Sie nach Ihrem konfigurierten Verzeichnis, klicken Sie auf die drei Punkte daneben und wählen Sie Testen Sie die Attributzuordnung.

Zammad: Klicken Sie in den externen Verzeichnissen auf Auswählen und dann auf Attributzuordnung testen

Ein Popup wird angezeigt, in dem Sie einen Benutzernamen eingeben und auf klicken können. Test.

Zammad: Geben Sie den Benutzernamen ein, um die Attributzuordnungskonfiguration zu testen

Das Ergebnis der Testattributzuordnung wird angezeigt.

Zammad: Zugeordnete Attribute für Benutzer abrufen

Die Konfiguration „AD als externes Verzeichnis einrichten“ ist abgeschlossen.

Hinweis: In unserer Anleitung erfahren Sie , wie Sie LDAP auf einem Windows-Server einrichten.

miniOrange lässt sich in verschiedene externe Benutzerquellen wie Verzeichnisse, Identitätsanbieter usw. integrieren.

Sie können Ihren IdP nicht finden oder benötigen Hilfe bei der Einrichtung?

Kontaktieren Sie uns oder senden Sie uns eine E-Mail an idpsupport@xecurify.com , und wir helfen Ihnen umgehend bei der Einrichtung.

Problemlösung

Wie kann ich die SAML-Tracer-Protokolle verfolgen und exportieren?

Installieren Sie SAML Tracer in Ihrem bevorzugten Browser:
Für Firefox: Fügen Sie das SAML-Tracer-Add-on aus dem Firefox Marketplace hinzu.
Für Chrome / Edge oder Chromium-basierte Browser: Installieren Sie die SAML-Tracer-Erweiterung aus dem Chrome Webstore.
Schritte zum Erfassen von Protokollen:
- Stellen Sie sicher, dass das SAML Tracer-Fenster geöffnet ist, bevor Sie den SSO-Flow starten. (Sie können es öffnen, indem Sie in der Browser-Symbolleiste in Ihrer Erweiterungsliste auf das SAML Tracer-Symbol klicken.)
- Führen Sie den SSO-Flow aus, um das Problem zu reproduzieren. Sie werden sehen, wie SAML Tracer mit allen URLs gefüllt wird.
- Hit Pause auf SAML Tracer, sobald das Problem reproduziert wird, um zusätzliche Protokolle zu vermeiden.
- Sie erhalten im SAML-Tracer etwas Ähnliches wie das folgende Bild.
Schritte zum Exportieren von Protokollen:
- Um Protokolle zu exportieren, klicken Sie oben im SAML Tracer auf die Exportoption. (Siehe Screenshot unten).
- Sie werden mit dem aufgefordert SAML-Trace-Einstellungen exportieren Fenster wählen Sie die Keine Präsentation und klicken Sie dann auf die Option „Exportieren“. (Mit dieser Option können die Werte im Originalzustand beibehalten werden, was zur weiteren Untersuchung des Problems erforderlich ist.)
- Klicken Sie auf Exportieren. Dadurch wird eine JSON-Datei auf Ihr System heruntergeladen.
- Senden Sie die Protokolldatei an den Entwickler, mit dem Sie in Kontakt stehen, oder an idpsupport@xecurify.com. Bitte fügen Sie auch einen Screenshot des Fehlers bei. Dies würde uns helfen, das Problem zu beheben.
- Wenn Sie die Protokolle immer noch nicht abrufen können, lassen Sie es uns bitte wissen.

Häufig gestellte Fragen (FAQs)

Was ist SAML SSO?

SAML Single Sign-On (SSO) ist ein Authentifizierungsprozess, bei dem ein Benutzer mit nur einem einzigen Satz Anmeldeinformationen (z. B. Benutzername und Passwort) Zugriff auf mehrere Anwendungen und/oder Websites erhält. Dadurch muss sich der Benutzer nicht mehr separat bei den verschiedenen Anwendungen anmelden.

Wie hoch sind die Preise für die SSO-Lösung von miniOrange?

Klicken Sie hier , um die Preise der miniOrange SSO-Lösung einzusehen.

Inhalte