Verbind ownCloud Infinite Scale met LDAP voor gebruikersaanmelding.

Om een ​​bestaande LDAP-directory te gebruiken met ownCloud Infinite Scale (oCIS), configureert u de ingebouwde OpenID Connect-identiteitsprovider (IDP) om gebruikers te authenticeren via LDAP. Vervolgens laat u de gebruikers-, groeps- en authenticatieservices naar dezelfde directory verwijzen. LDAP wordt niet geconfigureerd via een beheerderswizard zoals in Classic Server. De exacte instellingen zijn afhankelijk van uw oCIS-release en directoryschema; deze handleiding maakt gebruik van de servicedocumentatie van ownCloud 8.2 en omgevingsvariabelen in Docker Compose-stijl.

Begrijp wat "LDAP-authenticatie" inhoudt in oCIS.

oCIS scheidt de aanmelding via de browser van de services die gebruikers en groepen opzoeken. De ingebouwde IDP kan LDAP gebruiken voor gebruikersauthenticatie en OIDC-tokens uitgeven; services zoals Graph en Users hebben ook overeenkomende LDAP-verbindingen en attribuutinstellingen nodig om identiteiten te kunnen oplossen. De Auth Basic-service verzorgt HTTP Basic-authenticatie voor clients die dit nodig hebben; dit is een apart pad. Actie: bepaal of u aanmelding via de browser, Basic-authenticatie voor een specifieke client of beide nodig hebt voordat u de configuratie wijzigt.

De documentatie van ownCloud 8.2 beschrijft een ingebouwde IDP en IDM voor kleine omgevingen, terwijl een externe identiteitsprovider van enterprise-niveau wordt aanbevolen voor implementaties op grote schaal. Als u al een OIDC-provider gebruikt, zoals Keycloak of Active Directory Federation Services, is het integreren van die provider mogelijk een betere optie dan LDAP als directe aanmeldautoriteit te gebruiken. Actie: controleer uw architectuur en ondersteunde release met de relevante implementatiehandleiding van ownCloud vóór de uitrol.

Verzamel eerst de adresgegevens.

Vraag de LDAP-beheerder om de hostnaam en poort van de server, de TLS-certificaatketen, de DN en het wachtwoord van het bindaccount, de zoekbasis voor gebruikers, het inlogkenmerk, het unieke gebruikers-ID-kenmerk, de e-mail- en weergavenaamkenmerken, de gebruikersobjectklasse en eventuele vereiste gebruikersfilters. Als groepen in oCIS moeten verschijnen, verzamel dan ook de basis-DN van de groep, de objectklasse, het naamkenmerk, het lidmaatschapskenmerk en het stabiele groeps-ID-kenmerk.

  • Gebruik een speciaal bind-account met minimale privileges voor zoekopdrachten.
  • Geef de voorkeur ldaps://aan LDAP met StartTLS volgens uw directorybeleid en installeer het uitgevende CA-certificaat op een locatie waar de oCIS-container het kan lezen.
  • Kies een stabiele, unieke gebruikers-ID. Wijzig het ID-kenmerk niet zomaar nadat gebruikers de instantie in gebruik hebben genomen.
  • Controleer of de oCIS-host of -container de LDAP-server kan bereiken en oplossen, en of de firewallregels de gekozen LDAP TLS-poort toestaan.

Schemanamen verschillen tussen OpenLDAP, Active Directory en aangepaste directory's. De standaardvoorbeelden van ownCloud, zoals inetOrgPerson, uid, en , ownCloudUUIDzijn niet universeel. Actie: controleer elk attribuut aan de hand van daadwerkelijke directory-items en gebruik representatieve testaccounts vóór de productie.

Configureer de ingebouwde IDP

Voor Docker Compose horen omgevingsvariabelen bij de ocisservice. Het volgende is een sjabloon, geen kant-en-klare configuratie: vervang elke voorbeeldwaarde door de daadwerkelijke instellingen van uw directory en koppel het CA-bestand aan de container op het opgegeven pad.

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

De bovenstaande instellingen hebben betrekking op LDAP-lookup en -aanmelding aan de IDP-zijde. Het wachtwoord wordt weergegeven als een omgevingsvariabele, dus het hoeft niet hardgecodeerd te worden in het Compose-bestand. Beveilig echter het omgevingsbestand of gebruik de geheime functie van uw implementatieplatform. Het CA-pad moet zich binnen de container bevinden, niet alleen op de host. Actie: koppel de CA alleen-lezen en controleer of de containergebruiker deze kan lezen voordat u oCIS opnieuw start.

Gebruik uw daadwerkelijke ingeschakelde/uitgeschakelde attribuut en waarden. De documentatie noemt dit IDP_USER_ENABLED_ATTRIBUTEals het attribuut dat gecontroleerd moet worden; de betekenis van "ingeschakeld" hangt af van het schema en de implementatie. Als deze instelling niet in uw directory wordt gebruikt, verzin dan geen waarde: raadpleeg de servicedocumentatie voor uw specifieke release. Actie: test zowel een ingeschakeld account als een uitgeschakeld account om het toegangsbeleid te verifiëren.

Zorg ervoor dat identiteitsopzoeking en authenticatie op elkaar zijn afgestemd.

Het wijzigen van alleen de IDP-instellingen kan ervoor zorgen dat referenties worden gecontroleerd, terwijl de rest van oCIS dezelfde gebruiker of groep niet kan vinden. De gebruikersservice heeft zijn eigen LDAP-variabelen, waaronder USERS_LDAP_URI, USERS_LDAP_CACERT, USERS_LDAP_BIND_DN, USERS_LDAP_BIND_PASSWORD, en USERS_LDAP_USER_BASE_DN. Graph gebruikt overeenkomstige GRAPH_LDAP_*opties en beheert zoekopdrachten naar gebruikers en groepen. Stel deze in op dezelfde directory en een compatibel schema wanneer deze services deel uitmaken van uw implementatie.

Stel bijvoorbeeld de basis-DN en het stabiele ID-attribuut van de gebruiker in tussen IDP en Graph, en stel vervolgens de basis-DN en het lidmaatschapsattribuut van de groep in Graph in zodat deze overeenkomen met uw LDAP-records. De documentatie van de Graph-service geeft aan dat de LDAP-backend de standaard is en beschrijft de instellingen voor schrijven naar de server afzonderlijk. Actie: begin met alleen-lezen opzoeken als de directory elders gezaghebbend is; stel GRAPH_LDAP_SERVER_WRITE_ENABLEDdit in falsewanneer oCIS geen gebruikers en groepen in de directory mag aanmaken of wijzigen.

Configureer dit alleen AUTH_BASIC_AUTH_PROVIDER=ldapals uw client daadwerkelijk HTTP Basic-authenticatie vereist. ownCloud documenteert dat Basic-authenticatie ook bij de proxy moet worden ingeschakeld PROXY_ENABLE_BASIC_AUTH=true; het is geen vervanging voor normale OIDC-browseraanmelding. Actie: laat Basic-authenticatie uitgeschakeld, tenzij een specifieke client dit nodig heeft, en bekijk de beveiligingsimplicaties voordat u het inschakelt.

Herstarten, testen en problemen oplossen.

  1. Valideer het Compose-bestand en controleer of de variabelen aan de juiste service zijn gekoppeld.
  2. Start oCIS opnieuw op of implementeer het opnieuw volgens uw gebruikelijke implementatieprocedure, zodat de services de nieuwe waarden laden.
  3. Controleer de opstart- en servicelogboeken op LDAP-verbindings-, bind-, certificaat- en zoekfouten.
  4. Test de aanmelding van een bekende gebruiker via de webinterface en controleer vervolgens of het gebruikersprofiel en de verwachte groepen correct worden weergegeven.
  5. Test een ongeldig wachtwoord en een uitgeschakelde gebruiker. Controleer of geen van beiden toegang krijgt.

Als de verbinding mislukt, controleer dan vanuit de container of de DNS- en netwerkbereikbaarheid correct zijn. Controleer of de LDAPS-hostnaam overeenkomt met het certificaat, of de CA-keten betrouwbaar is en of de bind-DN ​​en het wachtwoord correct zijn. Een succesvolle LDAP-binding bewijst niet dat de zoekbasis voor gebruikers of het inlogkenmerk correct is. Als aanmelden wel lukt, maar er gebruikers- of groepsgegevens ontbreken, vergelijk dan de IDP-, gebruikers- en grafiekinstellingen en controleer de bijbehorende logboeken. Actie: isoleer de fout door één service en één testaccount tegelijk te testen in plaats van de TLS-validatie te versoepelen.

Stel in de productieomgeving geen opties in om de LDAP TLS-validatie te omzeilen. ownCloud waarschuwt expliciet voor onveilige LDAP-certificaatinstellingen. Bewaar een herstelbeheerdersaccount en een kopie van de vorige werkende configuratie totdat de aanmelding en groepsresolutie zijn geverifieerd. Actie: voer de wijziging eerst door in de testomgeving en rol deze vervolgens uit tijdens een periode waarin een beheerder de vorige omgeving indien nodig kan herstellen.

Officiële referenties

Laat een reactie achter

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Kies HTTP-01 of DNS-01, configureer een ownCloud reverse proxy en controleer of Certbot HTTPS-certificaten automatisch vernieuwt.

Verbind ownCloud Infinite Scale met LDAP voor gebruikersaanmelding.

Configureer de oCIS LDAP-aanmelding, stem gebruikers- en groepszoekopdrachten op elkaar af en controleer de TLS- en schema-instellingen vóór de uitrol.

Verbind een S3-bucket met ownCloud 10 als externe opslag.

Verbind een S3-bucket met ownCloud 10 als externe opslag.

Voeg een Amazon S3-bucket toe aan ownCloud 10, bereid compatibele inloggegevens en eindpunten voor en controleer de toegang zonder een mount te verwarren met primaire opslag.

Automatiseer het maken van database-dumps van ownCloud met een veilige, dagelijkse cronjob.

Automatiseer het maken van database-dumps van ownCloud met een veilige, dagelijkse cronjob.

Plan beveiligde MariaDB-dumps voor ownCloud Server, ga veilig om met de onderhoudsmodus en controleer elke back-up voordat u erop vertrouwt.

Migreer ownCloud Classic naar oCIS met een ondersteunde migratie.

Plan een migratie van ownCloud 10 naar oCIS met de ondersteunde app, geordende opdrachten, identiteitscontroles en een duidelijke lijst van gegevens die afzonderlijk verwerkt moeten worden.

Het merk ownCloud Classic 10 met een thema-app en CSS

Vervang de logo's van ownCloud Classic 10 en pas de kleuren van de webinterface aan met een thema-app, en vermijd daarbij de valkuilen van upgrades en integriteitscontroles.

Stel standaardopslagquota in op basis van gebruikersrol in ownCloud oCIS.

Stel standaardopslagquota in op basis van gebruikersrol in ownCloud oCIS.

Wijs bytegebaseerde opslaglimieten toe aan nieuwe ownCloud Infinite Scale-gebruikers per rol, met behulp van een proxy.yaml-voorbeeld en een checklist voor veilige verificatie.

Los certificaatfouten van ownCloud Sync op bij de TLS-bron.

Los certificaatfouten van ownCloud Sync op bij de TLS-bron.

Herstel de synchronisatie van ownCloud Desktop door de serverhostnaam, certificaatketen, vertrouwensrelatie met de privé-CA en problemen met de captive portal te controleren, zonder TLS-verificatie uit te schakelen.

Een ownCloud-integriteitswaarschuwing wissen na een upgrade

Gebruik het rapport met ongeldige bestanden om niet-overeenkomende kernbestanden of app-handtekeningen te identificeren, de juiste releasebestanden te herstellen en de integriteitscontrole veilig te verifiëren.

Installeer ownCloud Infinite Scale met Docker Compose.

Implementeer ownCloud Infinite Scale vanuit het officiële Compose-voorbeeld, configureer domeinen en permanente opslag, en controleer vervolgens TLS, containers en de eerste aanmelding.