Połącz ownCloud Infinite Scale z LDAP w celu logowania użytkowników

Aby użyć istniejącego katalogu LDAP z ownCloud Infinite Scale (oCIS), skonfiguruj wbudowanego dostawcę tożsamości (IDP) OpenID Connect do uwierzytelniania użytkowników w LDAP, a następnie skieruj użytkownika, grupę i usługi uwierzytelniania do tego samego katalogu. LDAP nie jest konfigurowany za pomocą kreatora administracyjnego w stylu Classic Server. Dokładne ustawienia zależą od wersji oCIS i schematu katalogu; w tym dokumencie wykorzystano dokumentację usługi ownCloud 8.2 oraz zmienne środowiskowe w stylu Docker Compose.

Zrozum, co oznacza „uwierzytelnianie LDAP” w oCIS

oCIS oddziela logowanie przez przeglądarkę od usług wyszukujących użytkowników i grupy. Wbudowany dostawca tożsamości (IDP) może używać protokołu LDAP do uwierzytelniania użytkowników i wystawiać tokeny OIDC; usługi takie jak Graph i Users również wymagają pasujących ustawień połączenia i atrybutów LDAP do rozpoznawania tożsamości. Usługa Auth Basic obsługuje uwierzytelnianie podstawowe HTTP dla klientów, którzy go potrzebują; jest to osobna ścieżka. Działanie: przed zmianą konfiguracji zdecyduj, czy potrzebujesz logowania przez przeglądarkę, uwierzytelniania podstawowego dla konkretnego klienta, czy obu.

Dokumentacja ownCloud 8.2 opisuje wbudowanego dostawcę tożsamości (IDP) i dekodera (IDM) dla małych środowisk, jednocześnie zalecając zewnętrznego dostawcę tożsamości klasy korporacyjnej dla wdrożeń korporacyjnych. Jeśli korzystasz już z dostawcy OIDC, takiego jak Keycloak lub Active Directory Federation Services, zintegrowanie go może być lepszym rozwiązaniem niż uczynienie LDAP bezpośrednim serwerem autoryzującym logowanie. Działanie: przed wdrożeniem sprawdź architekturę i obsługiwaną wersję z odpowiednim przewodnikiem wdrożeniowym ownCloud.

Najpierw zbierz dane katalogowe

Zapytaj administratora LDAP o nazwę hosta i port serwera, łańcuch certyfikatów TLS, nazwę wyróżniającą i hasło konta powiązania, bazę wyszukiwania użytkowników, atrybut logowania, atrybut unikalnego identyfikatora użytkownika, atrybuty adresu e-mail i nazwy wyświetlanej, klasę obiektu użytkownika oraz wszelkie wymagane filtry użytkownika. Jeśli grupy mają pojawiać się w oCIS, zbierz również podstawową nazwę wyróżniającą grupy, klasę obiektu, atrybut nazwy, atrybut członkostwa oraz atrybut identyfikatora grupy stabilnej.

  • Użyj dedykowanego konta powiązania o najmniejszych uprawnieniach do wyszukiwań.
  • Wybierz ldaps://protokół LDAP z funkcją StartTLS zgodnie z polityką katalogową i zainstaluj wystawiający certyfikat CA w miejscu, w którym kontener oCIS będzie mógł go odczytać.
  • Wybierz stabilny, unikalny identyfikator użytkownika. Nie zmieniaj pochopnie atrybutu ID po rozpoczęciu korzystania z instancji przez użytkowników.
  • Sprawdź, czy host lub kontener oCIS może rozwiązać i dotrzeć do serwera LDAP oraz czy reguły zapory sieciowej zezwalają na wybrany port LDAP TLS.

Nazwy schematów różnią się w zależności od OpenLDAP, Active Directory i katalogów niestandardowych. Przykładowe wartości domyślne ownCloud, takie jak inetOrgPerson, uidi , ownCloudUUIDnie są uniwersalne. Działanie: sprawdź każdy atrybut z rzeczywistymi wpisami w katalogu i użyj reprezentatywnych kont testowych przed uruchomieniem.

Skonfiguruj wbudowany IDP

W przypadku Docker Compose zmienne środowiskowe należą do ocisusługi. Poniższy przykład to szablon, a nie konfiguracja domyślna: zastąp każdą przykładową wartość rzeczywistymi ustawieniami swojego katalogu i zamontuj plik CA w kontenerze w określonej ścieżce.

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

Powyższe ustawienia obejmują wyszukiwanie i logowanie LDAP po stronie dostawcy tożsamości (IDP). Hasło jest wyświetlane jako zamiennik środowiska, więc nie musi być zakodowane na stałe w pliku Compose, ale należy zabezpieczyć plik środowiska lub skorzystać z funkcji zabezpieczeń platformy wdrożeniowej. Ścieżka do urzędu certyfikacji (CA) musi znajdować się wewnątrz kontenera, a nie tylko na hoście. Działanie: zamontuj urząd certyfikacji (CA) w trybie tylko do odczytu i upewnij się, że użytkownik kontenera może je odczytać przed ponownym uruchomieniem oCIS.

Użyj aktualnego atrybutu i wartości „enabled”/„disabled”. Nazwy atrybutów do sprawdzenia podano w dokumentacji IDP_USER_ENABLED_ATTRIBUTE; znaczenie „enabled” zależy od schematu i implementacji. Jeśli to ustawienie nie jest używane w Twoim katalogu, nie wymyślaj wartości: zapoznaj się z dokumentacją usługi dotyczącą konkretnej wersji. Działanie: przetestuj zarówno konto włączone, jak i wyłączone, aby zweryfikować politykę dostępu.

Utrzymuj spójność wyszukiwania tożsamości i uwierzytelniania

Sama zmiana ustawień IDP może umożliwić sprawdzenie poświadczeń, podczas gdy reszta oCIS nie będzie w stanie rozpoznać tego samego użytkownika lub grupy. Usługa Użytkownicy ma własne zmienne LDAP, w tym USERS_LDAP_URI, USERS_LDAP_CACERT, USERS_LDAP_BIND_DN, USERS_LDAP_BIND_PASSWORDi USERS_LDAP_USER_BASE_DN. Graph używa odpowiednich GRAPH_LDAP_*opcji i kontroluje zapytania dotyczące użytkowników i grup. Ustaw je na ten sam katalog i zgodny schemat, jeśli te usługi są częścią wdrożenia.

Na przykład, wyrównaj nazwę wyróżniającą bazy użytkowników i atrybut stabilnego identyfikatora między IDP a Graph, a następnie ustaw nazwę wyróżniającą grupy i atrybut członka w Graph tak, aby odpowiadały rekordom LDAP. Dokumentacja usługi Graph podaje, że jej zaplecze LDAP jest domyślne i oddzielnie identyfikuje ustawienia zapisu serwera. Działanie: rozpocznij wyszukiwanie tylko do odczytu, jeśli katalog jest autorytatywny gdzie indziej; ustaw GRAPH_LDAP_SERVER_WRITE_ENABLEDna , falsegdy oCIS nie może tworzyć ani modyfikować użytkowników i grup katalogu.

Skonfiguruj tylko AUTH_BASIC_AUTH_PROVIDER=ldapwtedy, gdy Twój klient faktycznie wymaga uwierzytelniania podstawowego HTTP. Dokumenty ownCloud wskazują, że uwierzytelnianie podstawowe musi być również włączone na serwerze proxy za pomocą PROXY_ENABLE_BASIC_AUTH=true[brakuje kontekstu]. Nie zastępuje ono standardowego logowania się przez przeglądarkę OIDC. Działanie: pozostaw uwierzytelnianie podstawowe wyłączone, chyba że dany klient go potrzebuje, i sprawdź konsekwencje związane z bezpieczeństwem przed jego włączeniem.

Uruchom ponownie, przetestuj i rozwiąż problemy

  1. Sprawdź poprawność pliku Compose i upewnij się, że zmienne są dołączone do właściwej usługi.
  2. Uruchom ponownie lub wdróż ponownie oCIS, korzystając ze zwykłej procedury wdrażania, aby usługi załadowały nowe wartości.
  3. Sprawdź dzienniki uruchamiania i usług w celu wykrycia błędów połączenia LDAP, powiązań, certyfikatów i wyszukiwania.
  4. Przetestuj znane logowanie użytkownika za pomocą interfejsu internetowego, a następnie sprawdź, czy profil użytkownika i oczekiwane grupy są rozwiązywane.
  5. Przetestuj nieprawidłowe hasło i wyłączoną nazwę użytkownika. Upewnij się, że żadne z nich nie uzyska dostępu.

Jeśli połączenie się nie powiedzie, sprawdź dostępność DNS i sieci wewnątrz kontenera, czy nazwa hosta LDAPS jest zgodna z certyfikatem, czy łańcuch CA jest zaufany, a nazwa wyróżniająca powiązania i hasło są poprawne. Pomyślne powiązanie LDAP nie dowodzi poprawności bazy wyszukiwania użytkownika ani atrybutu logowania. Jeśli logowanie działa, ale brakuje danych użytkownika lub grupy, porównaj ustawienia IDP, użytkowników i wykresu oraz przejrzyj ich indywidualne logi. Działanie: wyizoluj awarię, testując jedną usługę i jedno konto testowe na raz, zamiast osłabiać walidację TLS.

Nie ustawiaj opcji pomijania walidacji LDAP TLS w środowisku produkcyjnym. ownCloud wyraźnie ostrzega przed niebezpiecznymi ustawieniami certyfikatu LDAP. Zachowaj konto administratora odzyskiwania i kopię poprzedniej konfiguracji roboczej do czasu weryfikacji logowania i rozwiązania grupy. Działanie: najpierw zastosuj zmianę w środowisku testowym, a następnie wdróż ją w czasie, gdy administrator będzie mógł w razie potrzeby przywrócić poprzednie środowisko.

Oficjalne źródła

Zostaw komentarz

Postaw ownCloud na HTTPS z Let's Encrypt i Nginx

Postaw ownCloud na HTTPS z Let's Encrypt i Nginx

Wybierz HTTP-01 lub DNS-01, skonfiguruj odwrotny serwer proxy ownCloud i sprawdź, czy Certbot automatycznie odnawia certyfikaty HTTPS.

Połącz ownCloud Infinite Scale z LDAP w celu logowania użytkowników

Skonfiguruj logowanie oCIS LDAP, dostosuj wyszukiwanie użytkowników i grup oraz zweryfikuj ustawienia TLS i schematu przed wdrożeniem.

Podłącz kontener S3 do ownCloud 10 jako pamięć zewnętrzną

Podłącz kontener S3 do ownCloud 10 jako pamięć zewnętrzną

Dodaj kontener Amazon S3 do ownCloud 10, przygotuj zgodne dane uwierzytelniające i punkty końcowe oraz sprawdź dostęp, nie myląc mocowania z pamięcią główną.

Zautomatyzuj zrzuty bazy danych ownCloud za pomocą bezpiecznego nocnego zadania cron

Zautomatyzuj zrzuty bazy danych ownCloud za pomocą bezpiecznego nocnego zadania cron

Zaplanuj chronione zrzuty MariaDB dla serwera ownCloud, bezpiecznie obsługuj tryb konserwacji i weryfikuj każdą kopię zapasową przed jej wykorzystaniem.

Przenieś ownCloud Classic do oCIS z obsługiwaną migracją

Zaplanuj migrację z ownCloud 10 do oCIS z obsługiwaną aplikacją, uporządkowanymi poleceniami, sprawdzaniem tożsamości i przejrzystą listą danych wymagających osobnego przetwarzania.

Brand ownCloud Classic 10 z aplikacją motywu i CSS

Zastąp logo ownCloud Classic 10 i dostosuj kolory interfejsu użytkownika za pomocą aplikacji motywu, unikając przy tym pułapek związanych z aktualizacją i sprawdzaniem integralności.

Ustawianie domyślnych limitów pamięci masowej według roli użytkownika w ownCloud oCIS

Ustawianie domyślnych limitów pamięci masowej według roli użytkownika w ownCloud oCIS

Przypisz nowym użytkownikom ownCloud Infinite Scale limity pamięci masowej oparte na bajtach według roli, korzystając z przykładu proxy.yaml i listy kontrolnej weryfikacji bezpieczeństwa.

Napraw błędy certyfikatu synchronizacji ownCloud w źródle TLS

Napraw błędy certyfikatu synchronizacji ownCloud w źródle TLS

Przywróć synchronizację pulpitu ownCloud, sprawdzając nazwę hosta serwera, łańcuch certyfikatów, zaufanie prywatnego urzędu certyfikacji i problemy z portalem uwierzytelniającym bez wyłączania weryfikacji TLS.

Wyczyść ostrzeżenie o integralności ownCloud po aktualizacji

Użyj raportu o nieprawidłowych plikach, aby zidentyfikować niezgodne pliki główne lub podpisy aplikacji, przywrócić prawidłowe pliki wydania i bezpiecznie zweryfikować kontrolę integralności.

Zainstaluj ownCloud Infinite Scale z Docker Compose

Wdróż ownCloud Infinite Scale z oficjalnego przykładu Compose, skonfiguruj domeny i trwałą pamięć masową, a następnie zweryfikuj protokół TLS, kontenery i pierwsze logowanie.