Zum Inhalt springen
Bexxo Hilfe

Hilfe Die Plattform Import und SSO

Active Directory oder LDAP verbinden

Für Administratoren Aktualisiert am 13. November 2026

Ein Active-Directory- oder OpenLDAP-Verzeichnis, das in Ihren Räumlichkeiten installiert ist, verbinden, um die Personen und Gruppen der Organisation zu synchronisieren.
Auf dieser Seite
  1. Überblick
  2. Netzwerkzugriff: wer das Verzeichnis abfragt
  3. Den Abschnitt Verbindung ausfüllen
  4. Gelesene Attribute und Gruppen
  5. Testen und Fehler beheben

Überblick

Dieser Artikel behandelt den Abschnitt Verbindung eines Imports LDAP / Active Directory und was LDAP-spezifisch ist; die übrigen Einstellungen sind bei allen Importen gleich. Diese Quelle bietet kein SSO.

Die bei allen Importen gemeinsamen EinstellungenPersonen importieren und SSO einrichten

Netzwerkzugriff: wer das Verzeichnis abfragt

Ihre OrganisationWas Sie einplanen müssen
Ohne die VerschlüsselungsoptionUnsere Server verbinden sich aus dem Internet: Der Servername muss sich ausschliesslich zu öffentlichen Adressen auflösen (eine private oder reservierte Adresse wird abgelehnt), und Port 636 (LDAPS) oder 389 (StartTLS) muss zu ihm offen sein. Ein Verzeichnis, das nur aus Ihrem internen Netzwerk erreichbar ist, kann so nicht gelesen werden.
Mit clientseitiger VerschlüsselungIhr Bexxo Protected Agent liest das Verzeichnis: Sein Rechner muss den LDAP-Server erreichen. Das ist die einzige Möglichkeit, ein aus dem Internet nicht erreichbares Verzeichnis zu synchronisieren.

TLS ist obligatorisch (ldaps oder starttls): Eine unverschlüsselte Verbindung wird abgelehnt. Das Zertifikat wird anhand des eingegebenen Namens geprüft: Verwenden Sie den Namen, der im Zertifikat steht, keine IP-Adresse.

Der Agent, der das Verzeichnis aus Ihrem Netzwerk liestDen Bexxo Protected Agent installieren

Den Abschnitt Verbindung ausfüllen

Sehen Sie ein Dienstkonto mit Lesezugriff vor, das unter den Basis-DNs die Personen, Gruppen und die weiter unten aufgeführten Attribute lesen kann; eine anonyme Verbindung wird abgelehnt. Die leer gelassenen optionalen Felder (Zweige und Filter der Benutzer und Gruppen, Port, Kennungsattribut) nehmen den Standardwert an: den Basis-DN für die Zweige und den Wert des Verzeichnistyps für den Rest. Die sorgfältig auszufüllenden Felder:

FeldInhalt
Server (host)Servername, ohne ldap://, zum Beispiel ldap.exemple.ch.
Port und Verschlüsselungldaps (standardmässig 636) oder starttls (standardmässig 389).
Verbindungs-DN (bind DN)Vollständiger DN des Dienstkontos, zum Beispiel CN=svc-bexxo,OU=Services,DC=exemple,DC=ch.
Basis-DN (base DN)Ausgangspunkt der Suchen, zum Beispiel DC=exemple,DC=ch.
Verzeichnistypad (Active Directory) oder openldap: Es legt die Standardwerte unten fest.
KennungsattributEin stabiles Attribut, das eine Person oder eine Gruppe von einer Synchronisierung zur nächsten wiedererkennt.

Verzeichnistyp und Standardwerte

Einstellungadopenldap
Benutzerfilter(&(objectClass=user)(objectCategory=person))(objectClass=inetOrgPerson)
Gruppenfilter(objectClass=group)(objectClass=groupOfNames)
KennungsattributobjectGUIDentryUUID
Deaktiviertes KontoAls inaktiv importiert (Attribut userAccountControl).Alle Personen werden als aktiv importiert.

Ein benutzerdefinierter LDAP-Filter ersetzt den Standardfilter: Übernehmen Sie darin die Objektklasse, zum Beispiel (&(objectClass=user)(objectCategory=person)(department=Vente)). Er wird vor den Filtern des Abschnitts Filter angewendet.

Ändern Sie das Kennungsattribut nach einer ersten Synchronisierung nicht: Die bereits importierten Personen würden nicht mehr wiedererkannt. Ein Eintrag ohne dieses Attribut wird ignoriert und in einer Warnung des Protokolls gezählt.

Gelesene Attribute und Gruppen

Nur diese Attribute und das Kennungsattribut werden gelesen: Sie sind die einzigen, die in der Feldzuordnung und in den Filtern verwendbar sind.

ObjektAttribute
Personsn, givenName, cn, displayName, mail, mobile, telephoneNumber, preferredLanguage, dn, und accountEnabled (berechneter Wert: true oder false)
Gruppecn, displayName, description, member, dn

Die Mitgliedschaften werden im Attribut member der Gruppen gelesen. Der Server muss die Paginierung der LDAP-Ergebnisse («paged results») unterstützen.

Ab etwa 1500 Mitgliedern gibt Active Directory member nur in Teilmengen zurück, und die Synchronisierung schlägt fehl, statt eine unvollständige Gruppe zu importieren. Wählen Sie kleinere Gruppen oder schränken Sie den Basis-DN der Gruppen ein.

Testen und Fehler beheben

Der Verbindungstest authentifiziert sich und sucht dann unter dem Basis-DN der Benutzer mit dem Benutzerfilter nach einer Person.

SituationZu prüfen
Test fehlgeschlagen, unverschlüsselte OrganisationLöst sich der Name zu einer öffentlichen Adresse auf, ist der Port aus dem Internet offen, stimmt das Zertifikat mit dem eingegebenen Namen überein?
Fehler bei korrektem PasswortPasst die Verschlüsselung zum Port (ldaps: 636, starttls: 389)? Ist der Verbindungs-DN vollständig?
Der Test gelingt, aber es wird niemand gefundenStimmen der Basis-DN und der Benutzerfilter mit Ihren Konten überein? Ist der Verzeichnistyp der richtige?
Einträge «mangels stabiler Kennung» ignoriertDas Kennungsattribut ist nicht lesbar: Leeren Sie das Feld, um den Standardwert zu übernehmen, oder geben Sie dem Dienstkonto das Recht, es zu lesen.
«Bereichsgruppe(n) nicht gefunden»Die Gruppe existiert nicht mehr unter dem Basis-DN der Gruppen oder wird von deren Filter nicht mehr erfasst: Entfernen Sie sie aus Importierte Gruppen.
Verschlüsselte Organisation: Der Agent antwortet nicht innerhalb von 10 MinutenIst der Agent gestartet, und erreicht sein Rechner den LDAP-Server?

Keine Antwort gefunden? Kontakt aufnehmen