> ## Documentation Index > Fetch the complete documentation index at: https://docs.cocoondata.com/llms.txt > Use this file to discover all available pages before exploring further. # LDAP-Konfiguration Ein Covata-Plattform-Administrator kann [Covata-Benutzer](/2.16/de/admin/administering-users.md) über einen LDAP-Server/ein LDAP-Benutzerverzeichnis hinzufügen, indem er auf der betreffenden Covata-Plattform-Instanz eine LDAP-Verbindung konfiguriert. Die Covata-Plattform lässt die Konfiguration mehrerer LDAP-Verbindungen zu, d. h. Benutzer können von mehreren LDAP-Servern/-Benutzerverzeichnissen hinzugefügt werden. > [!NOTE] > > LDAP-Verbindungen werden nur für Vor-Ort-Installationen der Covata-Plattform empfohlen. Covata unterstützt keine LDAP-Verbindungen für Cloud-basierte Instanzen der Covata-Plattform. Für [LDAP](/2.16/de/admin/administering-users.md#account-type)-Benutzer gelten - im Unterschied zu [lokalen und externen (d. h. Ad-hoc)](/2.16/de/admin/administering-users.md#account-type)-Benutzern - die folgenden Eigenschaften: * Die Authentifizierung eines LDAP-Benutzers auf der Covata-Plattform ist an den betreffenden LDAP-Server delegiert (und wird von diesem gehandhabt). Passwörter für LDAP-Benutzer-Accounts werden daher über den LDAP-Server/das LDAP-Benutzerverzeichnis des betreffenden Accounts geändert oder zurückgesetzt. * LDAP-Benutzer-Accounts können nur über den LDAP-Server/das LDAP-Benutzerverzeichnis des Accounts deaktiviert oder reaktiviert werden. * Änderungen an den Feldern eines bestehenden Covata-Plattform-LDAP-Benutzers werden über den LDAP-Server/das LDAP-Benutzerverzeichnis des betreffenden Accounts vorgenommen. * Diese Änderungen werden vom LDAP-Server/-Benutzerverzeichnis des Accounts direkt an die Covata-Plattform weitergegeben, wenn die Covata-Plattform das nächste Mal mit dem LDAP-Server synchronisiert. Die LDAP-Synchronisierung findet standardmäßig alle fünf Minuten statt. * Es ist daher nicht möglich, irgendwelche [Felder](/2.16/de/admin/administering-users.md#a-users-fields) eines LDAP-Benutzers außer den **Rollen** über die Covata-Plattform zu bearbeiten. * Überprüfen Sie, dass die jeweiligen LDAP-Verbindungen der Benutzer-Accounts [aktiviert sind](/2.16/de/admin/configuring-ldap.md#disabling-or-re-enabling-an-ldap-connection) um sicherzustellen, dass an den Feldern von LDAP-Benutzer-Accounts vorgenommene Änderungen über die Covata-Plattform weitergegeben werden. * Die [Rollen](/2.16/de/admin/administering-users.md#a-users-roles) und [gültigen Zugriffs-/Aktualisierungs-Token (d. h. Sitzungen)](/2.16/de/admin/administering-users.md#expiring-users-tokens-sessions) eines LDAP-Benutzers werden jedoch vom Covata-Plattform-Administrator direkt über die Covata-Verwaltung geändert. ![Seite LDAP-Verbindungen](https://mintcdn.com/cocoondata/nH8pbjLreDSHB6fD/images/76cb62a4bb05-ldap-connections-page.png?fit=max\&auto=format\&n=nH8pbjLreDSHB6fD\&q=85\&s=53909a8c91f559160a3f72994996a11d) ## Konfiguration einer LDAP-Verbindung Die Seite **LDAP-Verbindungen** der Covata-Verwaltung (oben) ermöglicht Folgendes: * Hinzufügen neuer [LDAP](/2.16/de/admin/administering-users.md#account-type)-Benutzer zur Covata-Plattform anhand von [neuen Verbindungen zu LDAP-Servern/-Benutzerverzeichnissen](/2.16/de/admin/configuring-ldap.md#adding-a-new-ldap-connection) * [Bearbeitung](/2.16/de/admin/configuring-ldap.md#editing-an-existing-ldap-connection) bestehender LDAP-Verbindungen * [Deaktivierung oder Reaktivierung](/2.16/de/admin/configuring-ldap.md#disabling-or-re-enabling-an-ldap-connection) bestehender LDAP-Verbindungen ### Hinzufügen einer neuen LDAP-Verbindung **Hinzufügen einer neuen Verbindung zu einem LDAP-Server/-Benutzerverzeichnis auf der Covata-Plattform:** 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die **LDAP**-Option links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **LDAP-Verbindungen** aufzurufen. 3. Klicken Sie auf die Schaltfläche **LDAP-Verbindung hinzufügen**. 4. Füllen Sie im Dialogfeld **LDAP-Verbindung hinzufügen** die in der [Tabelle](/2.16/de/admin/configuring-ldap.md#ldap-connection-fields) (unten) beschriebenen Felder für die LDAP-Verbindung aus. 5. ( *Optional* ) Testen Sie die Verbindung, indem Sie die Schaltfläche **Testverbindung** anklicken. \ **Hinweis:** Eine Meldung zeigt an, ob eine erfolgreiche Verbindung zum LDAP-Server aufgebaut werden konnte. 6. Klicken Sie auf **Speichern**, und die LDAP-Verbindung erscheint als neue Eintragung auf der Seite **LDAP-Verbindungen**. \ **Hinweis:** * Alle Accounts im LDAP-Benutzerverzeichnis erscheinen auf der Covata-Plattform als neue Benutzer-Accounts, sobald die Covata-Plattform das nächste Mal mit dem LDAP-Server synchronisiert. * Alle neuen LDAP-Benutzer-Accounts, die der Covata-Plattform über einen LDAP-Server/ein LDAP-Benutzerverzeichnis hinzugefügt wurden, erhalten automatisch die [Ersteller-Rolle](/2.16/de/admin/administering-users.md#originator-role). * Entspricht die E-Mail-Adresse eines bestehenden Benutzer-Accounts auf der Covata-Plattform dem **E-Mail-Feld** eines Benutzers im LDAP-Benutzerverzeichnis, wird für den betreffenden Account (während der Synchronisierung) auf der Covata-Plattform kein neuer Account hinzugefügt. ### Bearbeitung einer bestehenden LDAP-Verbindung **Bearbeitung einer bestehenden Verbindung zu einem LDAP-Server/-Benutzerverzeichnis auf der Covata-Plattform:** 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die **LDAP**-Option links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **LDAP-Verbindungen** aufzurufen. 3. Blättern Sie zur gewünschten LDAP-Verbindung und klicken Sie auf den Link **Bearbeiten**. 4. Ändern Sie im Dialogfeld **LDAP-Verbindung bearbeiten** die in der [Tabelle](/2.16/de/admin/configuring-ldap.md#ldap-connection-fields) (unten) beschriebenen Felder für die LDAP-Verbindung. 5. ( *Optional* ) Testen Sie die Verbindung, indem Sie die Schaltfläche **Testverbindung** anklicken. \ **Hinweis:** Eine Meldung zeigt an, ob eine erfolgreiche Verbindung zum LDAP-Server aufgebaut werden konnte. 6. Klicken Sie auf **Speichern**, und die LDAP-Verbindung wird aktualisiert. \ **Hinweise:** * Überprüfen Sie, dass die jeweilige LDAP-Verbindung [aktiviert ist](/2.16/de/admin/configuring-ldap.md#disabling-or-re-enabling-an-ldap-connection) um sicherzustellen, dass an Benutzer-Accounts im LDAP-Benutzerverzeichnis vorgenommene Änderungen über die Covata-Plattform weitergegeben werden. * Da das **E-Mail**-Adressfeld aller Benutzer-Accounts auf der Covata-Plattform eindeutig ist (da die E-Mail-Adressen der einzelnen Accounts die Identität ihrer Benutzer eindeutig beschreiben und auch für [Prüfzwecke](/2.16/de/admin/generating-reports.md) verwendet werden), gilt Folgendes: 1. Wird die E-Mail-Adresse eines LDAP-Benutzers über seinen LDAP-Server/-Benutzerverzeichnis geändert, wird für den betreffenden Benutzer bei der nächsten Synchronisierung ein neuer Covata-Benutzer-Account angelegt (und sein ursprünglicher Covata-Benutzer-Account nicht mehr verwendet). 2. Wird die E-Mail-Adresse dieses LDAP-Benutzers in seine ursprüngliche Adresse zurück geändert, wird für den betreffenden Benutzer bei der nächsten Synchronisierung wieder sein ursprünglicher Covata-Benutzer-Account verwendet (und nicht mehr sein vorheriger Covata-Benutzer-Account). Die folgende Tabelle beschreibt alle für LDAP relevanten Felder, die die Covata-Plattform benötigt, um eine erfolgreiche Verbindung zu einem LDAP-Server/-Benutzerverzeichnis herzustellen. Alle dieser Felder sind Pflichtfelder. > [!NOTE] > > Der Inhalt der [folgenden Tabelle](/2.16/de/admin/configuring-ldap.md#ldap-connection-fields) erscheint in den Dialogfeldern für **LDAP-Verbindung hinzufügen/bearbeiten**. Diese Informationen sind unten zur Unterstützung von LDAP-Administratoren zusammengefasst, die selbst keine Covata-Plattform-Administratoren sind, aber die Werte dieser Felder ihren Plattform-Administratoren zur Verfügung stellen müssen. | Feld | Beschreibung | Maximale Länge (sofern anwendbar) | | - | - | - | | Server-URL | Die Adresse des Servers, auf dem [LDAP](http://tools.ietf.org/html/rfc4511) ausgeführt wird. LDAP über [TLS](http://tools.ietf.org/html/rfc5246) wird ebenfalls unterstützt. **Beispiel:** `ldap://ldap.xy-firma.de` | | | Server-Timeout | Die Wartezeit der Covata-Plattform (in Millisekunden) beim Versuch, mit dem LDAP-Server eine Verbindung aufzubauen oder von ihm Daten zu lesen. | | | Manager-DN | Der definierte Name (DN) des „Manager“-Benutzers, der zur Ausführung der LDAP-Authentifizierung und Synchronisierung sowie zum Durchsuchen des **Basis-DN** befugt ist. | 512 | | Manager-Passwort | Das Passwort des „Manager“-Benutzers, der zur Ausführung der LDAP-Authentifizierung und Synchronisierung sowie zum Durchsuchen des **Basis-DN** befugt ist. | 128 | | Basis-DN | Der Stammknoten in LDAP, von dem die Covata-Plattform Benutzer und Gruppen findet. **Beispiel:** `ou=Benutzer,dc=xy-firma,dc=de` | 512 | | Filter synchronisieren | Der Filter, mit dem die zu synchronisierenden Covata-Benutzer aufgrund ihres LDAP-Pfades und ihrer Attribute angegeben werden. **Beispiele:** • Synchronisierung von Benutzern einer Gruppe: `(memberOf=CN=GruppenName,OU=Benutzer,DC=xy-firma,DC=de)` • Alle Benutzer: `(&(objectclass=user)(objectcategory=person))` • Benutzer, deren E-Mail einer bestimmten Domäne entspricht: `(&(&(objectclass=user)(objectcategory=person))(mail=*@xy-firma.de))` | 512 | | Auth-Filter | Das LDAP-Feld, mit dem die Covata-Plattform die E-Mail-Adresse eines Covata-Benutzers bei der Authentifizierung abgleicht. **Beispiel:** `userPrincipalName={0}` | 512 | | Domäne | Die Domäne für das LDAP-Benutzerverzeichnis | 64 | | Account-Name | Das zur Angabe eines zusätzlichen/anderen Namens für Covata-Benutzer verwendete LDAP-Feld. **Beispiel:** `sAMAccountName` **Hinweis:** Dieses Feld wird für die interne Funktionalität der Covata-Plattform benötigt. | 64 | | E-Mail-Feld | Das zur Angabe der [E-Mail-Adresse](/2.16/de/admin/administering-users.md#email) für Covata-Benutzer verwendete LDAP-Feld. **Beispiel:** `mail` **Hinweis:** Jede E-Mail-Adresse aus diesem Feld definiert die Identität eines Covata-Benutzers und bildet Bestandteil seiner Anmeldeinformationen. | 64 | | Benutzerprinzipalname | Das zur Angabe der externen Benutzer-ID für Covata-Benutzer verwendete LDAP-Feld. **Beispiel:** `userPrincipalName` **Hinweis:** Dieses Feld wird für die interne Funktionalität der Covata-Plattform benötigt. | 64 | | Feld Voller Name | Das zur Angabe des [Vornamens](/2.16/de/admin/administering-users.md#first-name) für Covata-Benutzer verwendete LDAP-Feld. **Beispiel:** `Name` | 64 | | Status-Feld | Das LDAP-Feld, anhand dessen die Covata-Plattform feststellt, ob ein Benutzer deaktiviert ist oder nicht **Beispiel:** `userAccountControl` | 64 | | Status deaktiviert | Der Wert des **Statusfelds** (im LDAP-Verzeichnis), der angibt, dass ein Benutzer deaktiviert ist. | 64 | ## Deaktivierung und Reaktivierung einer LDAP-Verbindung Die Deaktivierung einer LDAP-Verbindung beendet die Synchronisierung der Covata-Plattform mit dem Server/Benutzerverzeichnis der betreffenden LDAP-Verbindung. Wenn eine LDAP-Verbindung deaktiviert wurde, können sich die [LDAP](/2.16/de/admin/administering-users.md#account-type)-Benutzer (die vorher über diese LDAP-Verbindung hinzugefügt wurden) anhand einer delegierten Authentifizierung jedoch weiterhin bei der Covata-Plattform anmelden. Dies gilt unter der Annahme, dass die betreffenden Benutzer-Accounts in ihrem LDAP-Benutzerverzeichnis nicht deaktiviert wurden. Die Deaktivierung einer LDAP-Verbindung ist hilfreich, wenn die Synchronisierung zwischen der Covata-Plattform und dem LDAP-Server den Netzwerkdatenverkehr beeinträchtigt. Die Deaktivierung einer LDAP-Verbindung verhindert jedoch auch, dass Aktualisierungen von [LDAP](/2.16/de/admin/administering-users.md#account-type)-Benutzer-Accounts (in ihrem Benutzerverzeichnis) über die Covata-Plattform weitergegeben werden. **Deaktivierung, Aktivierung und Reaktivierung von LDAP-Verbindungen auf der Covata-Plattform:** 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die **LDAP**-Option links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **LDAP-Verbindungen** aufzurufen, und blättern Sie zur betreffenden LDAP-Verbindung. 3. Gehen Sie anschließend wie folgt vor: * *Zur Deaktivierung der LDAP-Verbindung* - klicken Sie auf die (grüne) Schaltfläche **Aktiviert** der betreffenden LDAP-Verbindung (am linken Seitenrand), um sie auf **Deaktiviert** umzuschalten. * *Zur Aktivierung oder Reaktivierung der LDAP-Verbindung* - klicken Sie auf die (rote) Schaltfläche **Deaktiviert** der betreffenden LDAP-Verbindung (am linken Seitenrand), um sie auf **Aktiviert** umzuschalten. *** #### Bitte hinterlassen Sie uns hier Ihr Feedback. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.