Verbinden Sie ownCloud Infinite Scale mit LDAP für die Benutzeranmeldung.

Um ein vorhandenes LDAP-Verzeichnis mit ownCloud Infinite Scale (oCIS) zu verwenden, konfigurieren Sie den integrierten OpenID Connect Identity Provider (IDP) zur Benutzerauthentifizierung über LDAP. Anschließend verweisen Sie die Benutzer-, Gruppen- und Authentifizierungsdienste auf dasselbe Verzeichnis. Die LDAP-Konfiguration erfolgt nicht über einen klassischen Server-Assistenten. Die genauen Einstellungen hängen von Ihrer oCIS-Version und Ihrem Verzeichnisschema ab. Diese Anleitung basiert auf der ownCloud 8.2-Dienstdokumentation und Umgebungsvariablen im Docker Compose-Stil.

Verstehen Sie, was „LDAP-Authentifizierung“ in oCIS bedeutet.

oCIS trennt die Browseranmeldung von den Diensten, die Benutzer und Gruppen suchen. Der integrierte Identitätsanbieter (IDP) kann LDAP zur Benutzerauthentifizierung verwenden und OIDC-Token ausstellen. Dienste wie Graph und Users benötigen ebenfalls passende LDAP-Verbindungs- und Attributeinstellungen zur Identitätsauflösung. Der Dienst „Auth Basic“ übernimmt die HTTP-Basisauthentifizierung für Clients, die diese benötigen; dies ist ein separater Pfad. Empfehlung: Entscheiden Sie vor der Konfigurationsänderung, ob Sie die Browseranmeldung, die Basisauthentifizierung für einen bestimmten Client oder beides benötigen.

Die ownCloud-Dokumentation 8.2 beschreibt einen integrierten Identitätsanbieter (IDP) und Identitätsmanagement-Manager (IDM) für kleinere Umgebungen, empfiehlt jedoch für Unternehmenseinsätze einen externen Identitätsanbieter der Enterprise-Klasse. Wenn Sie bereits einen OIDC-Anbieter wie Keycloak oder Active Directory Federation Services (ADFS) verwenden, ist die Integration dieses Anbieters möglicherweise besser geeignet als die Verwendung von LDAP als direkte Anmeldeinstanz. Handlungsempfehlung: Prüfen Sie vor der Bereitstellung Ihre Architektur und die unterstützte Version anhand des entsprechenden ownCloud-Bereitstellungsleitfadens.

Sammeln Sie zuerst die Verzeichnisdetails.

Bitten Sie den LDAP-Administrator um Server-Hostname und -Port, TLS-Zertifikatskette, Bind-Account-DN und -Passwort, Benutzer-Suchbasis, Anmeldeattribut, eindeutiges Benutzer-ID-Attribut, E-Mail- und Anzeigename-Attribute, Benutzerobjektklasse sowie alle erforderlichen Benutzerfilter. Falls Gruppen in oCIS angezeigt werden sollen, erfassen Sie zusätzlich den Gruppen-Basis-DN, die Objektklasse, das Namensattribut, das Mitgliedschaftsattribut und die stabile Gruppen-ID.

  • Verwenden Sie für Abfragen ein dediziertes Bind-Konto mit minimalen Berechtigungen.
  • Verwenden Sie bevorzugt ldaps://LDAP mit StartTLS gemäß Ihrer Verzeichnisrichtlinie und installieren Sie das ausstellende CA-Zertifikat dort, wo der oCIS-Container es lesen kann.
  • Wählen Sie eine stabile, eindeutige Benutzerkennung. Ändern Sie das ID-Attribut nicht willkürlich, nachdem Benutzer die Instanz bereits verwenden.
  • Prüfen Sie, ob der oCIS-Host oder -Container den LDAP-Server auflösen und erreichen kann und ob die Firewall-Regeln den gewählten LDAP-TLS-Port zulassen.

Schemanamen variieren je nach Verzeichnis (OpenLDAP, Active Directory, benutzerdefinierte Verzeichnisse). Die Standardbeispiele von ownCloud (z. B. `<name>`, `<name>`, `<name>`) inetOrgPersonsind uidnicht ownCloudUUIDuniversell anwendbar. Empfehlung: Überprüfen Sie jedes Attribut anhand tatsächlicher Verzeichniseinträge und verwenden Sie repräsentative Testkonten, bevor Sie die Produktion starten.

Konfigurieren Sie den integrierten IDP.

Bei Docker Compose gehören Umgebungsvariablen zum ocisDienst. Die folgende Vorlage ist keine fertige Konfiguration: Ersetzen Sie jeden Beispielwert durch die tatsächlichen Einstellungen Ihres Verzeichnisses und binden Sie die CA-Datei im Container unter dem angegebenen Pfad ein.

services:
  ocis:
    environment:
      IDP_LDAP_URI: ldaps://ldap.example.org:636
      IDP_LDAP_TLS_CACERT: /etc/ocis/ldap-ca.pem
      IDP_LDAP_BIND_DN: cn=ocis-reader,ou=service-accounts,dc=example,dc=org
      IDP_LDAP_BIND_PASSWORD: ${OCIS_LDAP_BIND_PASSWORD}
      IDP_LDAP_BASE_DN: ou=people,dc=example,dc=org
      IDP_LDAP_LOGIN_ATTRIBUTE: uid
      IDP_LDAP_OBJECTCLASS: inetOrgPerson
      IDP_LDAP_UUID_ATTRIBUTE: entryUUID
      IDP_LDAP_EMAIL_ATTRIBUTE: mail
      IDP_LDAP_NAME_ATTRIBUTE: displayName
      IDP_USER_ENABLED_ATTRIBUTE: ownCloudUserEnabled

Die oben genannten Einstellungen regeln die LDAP-Abfrage und Anmeldung auf IDP-Seite. Das Passwort wird als Umgebungsvariable angezeigt und muss daher nicht fest in der Compose-Datei codiert werden. Schützen Sie jedoch die Umgebungsvariable oder verwenden Sie die Funktion für geheime Passwörter Ihrer Bereitstellungsplattform. Der Pfad zur Zertifizierungsstelle (CA) muss innerhalb des Containers vorhanden sein, nicht nur auf dem Host. Maßnahme: Binden Sie die CA schreibgeschützt ein und stellen Sie sicher, dass der Containerbenutzer darauf zugreifen kann, bevor Sie oCIS neu starten.

Verwenden Sie Ihre tatsächlichen Aktivierungs-/Deaktivierungsattribute und -werte. Die Dokumentation nennt IDP_USER_ENABLED_ATTRIBUTEdas zu prüfende Attribut; die Bedeutung von „aktiviert“ hängt vom Schema und der Implementierung ab. Falls diese Einstellung in Ihrem Verzeichnis nicht verwendet wird, erfinden Sie keinen Wert: Konsultieren Sie die Dienstdokumentation für Ihre spezifische Version. Aktion: Testen Sie sowohl ein aktiviertes als auch ein deaktiviertes Konto, um die Zugriffsrichtlinie zu überprüfen.

Stellen Sie sicher, dass Identitätssuche und Authentifizierung aufeinander abgestimmt sind.

Durch die alleinige Änderung der IDP-Einstellungen kann die Überprüfung von Anmeldeinformationen ermöglicht werden, während der Rest von oCIS denselben Benutzer oder dieselbe Gruppe nicht auflösen kann. Der Benutzerdienst verfügt über eigene LDAP-Variablen, darunter USERS_LDAP_URI`users`, USERS_LDAP_CACERT`username` USERS_LDAP_BIND_DN, USERS_LDAP_BIND_PASSWORD`username` und ` username` USERS_LDAP_USER_BASE_DN. Graph verwendet entsprechende GRAPH_LDAP_*Optionen und steuert Benutzer- und Gruppenabfragen. Stellen Sie diese auf dasselbe Verzeichnis und ein kompatibles Schema ein, wenn diese Dienste Teil Ihrer Bereitstellung sind.

Beispielsweise sollten Sie den Basis-DN und das Attribut „Stabile ID“ der Benutzer zwischen IDP und Graph abgleichen und anschließend den Basis-DN und das Attribut „Mitglied“ der Gruppen in Graph so konfigurieren, dass sie mit Ihren LDAP-Einträgen übereinstimmen. Laut der Graph-Dienstdokumentation ist das LDAP-Backend standardmäßig aktiviert, und die Einstellungen für serverseitige Schreibvorgänge werden separat aufgeführt. Empfehlung: Verwenden Sie zunächst eine schreibgeschützte Suche, wenn das Verzeichnis anderweitig autoritativ ist; aktivieren Sie GRAPH_LDAP_SERVER_WRITE_ENABLEDdiese Option, falsewenn oCIS keine Verzeichnisbenutzer und -gruppen erstellen oder ändern darf.

AUTH_BASIC_AUTH_PROVIDER=ldapKonfigurieren Sie die Basisauthentifizierung nur, wenn Ihr Client diese tatsächlich benötigt. ownCloud weist darauf hin, dass die Basisauthentifizierung auch auf dem Proxy aktiviert sein muss PROXY_ENABLE_BASIC_AUTH=true; sie ersetzt nicht die normale OIDC-Browseranmeldung. Empfehlung: Lassen Sie die Basisauthentifizierung deaktiviert, es sei denn, ein bestimmter Client benötigt sie. Überprüfen Sie die Sicherheitsauswirkungen, bevor Sie sie aktivieren.

Neustart, Test und Fehlerbehebung

  1. Überprüfen Sie die Compose-Datei und stellen Sie sicher, dass die Variablen dem richtigen Dienst zugeordnet sind.
  2. Starten Sie oCIS neu oder stellen Sie es gemäß Ihrem normalen Bereitstellungsverfahren erneut bereit, damit die Dienste die neuen Werte laden.
  3. Prüfen Sie die Start- und Dienstprotokolle auf LDAP-Verbindungs-, Bindungs-, Zertifikats- und Suchfehler.
  4. Testen Sie die Anmeldung eines bekannten Benutzers über die Weboberfläche und überprüfen Sie anschließend, ob das Benutzerprofil und die erwarteten Gruppen aufgelöst werden.
  5. Testen Sie ein ungültiges Passwort und einen deaktivierten Benutzer. Bestätigen Sie, dass keiner von beiden Zugriff erhält.

Wenn die Verbindung fehlschlägt, überprüfen Sie die DNS- und Netzwerkerreichbarkeit innerhalb des Containers, ob der LDAPS-Hostname mit dem Zertifikat übereinstimmt, die CA-Kette vertrauenswürdig ist und Bind-DN ​​und -Passwort korrekt sind. Eine erfolgreiche LDAP-Bindung beweist nicht, dass die Benutzersuchbasis oder das Anmeldeattribut korrekt sind. Wenn die Anmeldung funktioniert, aber Benutzer- oder Gruppendaten fehlen, vergleichen Sie die IDP-, Benutzer- und Graph-Einstellungen und prüfen Sie deren jeweilige Protokolle. Maßnahme: Isolieren Sie den Fehler, indem Sie jeweils nur einen Dienst und ein Testkonto testen, anstatt die TLS-Validierung zu lockern.

Setzen Sie in der Produktionsumgebung keine LDAP-TLS-Validierungsumgehungsoptionen. ownCloud warnt ausdrücklich vor unsicheren LDAP-Zertifikateinstellungen. Bewahren Sie ein Wiederherstellungsadministratorkonto und eine Kopie der vorherigen funktionierenden Konfiguration auf, bis die Anmelde- und Gruppenauflösung verifiziert ist. Vorgehensweise: Nehmen Sie die Änderung zunächst in der Staging-Umgebung vor und führen Sie sie dann in der Produktionsumgebung aus, wenn ein Administrator die vorherige Umgebung bei Bedarf wiederherstellen kann.

Offizielle Referenzen

Einen Kommentar hinterlassen

Verbinden Sie ownCloud Infinite Scale mit LDAP für die Benutzeranmeldung.

Konfigurieren Sie die oCIS LDAP-Anmeldung, gleichen Sie Benutzer- und Gruppenabfragen ab und überprüfen Sie die TLS- und Schemaeinstellungen vor der Einführung.

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Fügen Sie ownCloud 10 einen Amazon S3-Bucket hinzu, bereiten Sie kompatible Anmeldeinformationen und Endpunkte vor und prüfen Sie den Zugriff, ohne eine Einbindung mit dem primären Speicher zu verwechseln.

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Planen Sie geschützte MariaDB-Dumps für ownCloud Server, handhaben Sie den Wartungsmodus sicher und überprüfen Sie jedes Backup, bevor Sie sich darauf verlassen.

Wechseln Sie ownCloud Classic mit einer unterstützten Migration zu oCIS.

Planen Sie eine Migration von ownCloud 10 zu oCIS mit der unterstützten App, geordneten Befehlen, Identitätsprüfungen und einer klaren Liste der Daten, die eine separate Behandlung erfordern.

ownCloud Classic 10 mit Theme-App und CSS

Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Weisen Sie neuen ownCloud Infinite Scale-Benutzern rollenbasierte Speicherlimits auf Byte-Basis zu, inklusive eines proxy.yaml-Beispiels und einer Checkliste zur sicheren Überprüfung.

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Stellen Sie die ownCloud-Desktop-Synchronisierung wieder her, indem Sie den Server-Hostnamen, die Zertifikatskette, die Vertrauensstellung der privaten Zertifizierungsstelle und Probleme mit dem Captive Portal überprüfen, ohne die TLS-Verifizierung zu deaktivieren.

ownCloud-Integritätswarnung nach einem Upgrade löschen

Verwenden Sie den Bericht über ungültige Dateien, um nicht übereinstimmende Kerndateien oder App-Signaturen zu identifizieren, die korrekten Release-Dateien wiederherzustellen und die Integritätsprüfung sicher durchzuführen.

ownCloud Infinite Scale mit Docker Compose installieren

Stellen Sie ownCloud Infinite Scale anhand des offiziellen Compose-Beispiels bereit, konfigurieren Sie Domänen und persistenten Speicher und überprüfen Sie anschließend TLS, Container und die erste Anmeldung.

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Richten Sie den S3NG-Treiber, die Bucket-Berechtigungen, die persistente Metadatenspeicherung und die Upload-Größe so ein, dass ownCloud Infinite Scale Dateiinhalte zuverlässig speichern kann.