사용자 로그인을 위해 ownCloud Infinite Scale을 LDAP에 연결합니다.

ownCloud Infinite Scale(oCIS)에서 기존 LDAP 디렉터리를 사용하려면 내장된 OpenID Connect ID 공급자(IDP)를 구성하여 LDAP에 대해 사용자를 인증한 다음 사용자, 그룹 및 인증 서비스가 동일한 디렉터리를 가리키도록 설정해야 합니다. LDAP는 기존 서버 방식의 관리 마법사를 통해 구성할 수 없습니다. 정확한 설정은 oCIS 릴리스 및 디렉터리 스키마에 따라 다릅니다. 이 참조에서는 ownCloud 8.2 서비스 설명서와 Docker Compose 방식의 환경 변수를 사용합니다.

oCIS에서 "LDAP 인증"이 무엇을 의미하는지 이해하십시오.

oCIS는 브라우저 로그인과 사용자 및 그룹 조회 서비스를 분리합니다. 내장된 IDP는 LDAP를 사용하여 사용자 인증을 수행하고 OIDC 토큰을 발급할 수 있습니다. 그래프 및 사용자 서비스와 같은 서비스도 ID 확인을 위해 일치하는 LDAP 연결 및 속성 설정이 필요합니다. Auth Basic 서비스는 HTTP 기본 인증이 필요한 클라이언트를 처리하며, 이는 별도의 경로입니다. 조치: 구성을 변경하기 전에 브라우저 로그인, 특정 클라이언트에 대한 기본 인증 또는 둘 다 필요한지 결정하십시오.

ownCloud 8.2 문서에서는 소규모 환경을 위한 내장형 IDP 및 IDM을 설명하고 있으며, 엔터프라이즈급 배포에는 엔터프라이즈급 외부 ID 공급자를 권장합니다. Keycloak 또는 Active Directory Federation Services와 같은 OIDC 공급자를 이미 사용 중인 경우 LDAP를 직접 로그인 기관으로 사용하는 것보다 해당 공급자를 통합하는 것이 더 적합할 수 있습니다. 조치: 배포 전에 관련 ownCloud 배포 가이드를 참조하여 아키텍처 및 지원되는 릴리스를 확인하십시오.

먼저 디렉토리 정보를 수집하세요.

LDAP 관리자에게 서버 호스트 이름과 포트, TLS 인증서 체인, 바인드 계정 DN 및 암호, 사용자 검색 기준, 로그인 속성, 고유 사용자 ID 속성, 이메일 및 표시 이름 속성, 사용자 객체 클래스, 그리고 필요한 사용자 필터를 요청하십시오. 그룹이 oCIS에 표시되어야 하는 경우 그룹 기준 DN, 객체 클래스, 이름 속성, 멤버십 속성 및 고정 그룹 ID 속성도 수집하십시오.

  • 조회를 위해 최소 권한의 전용 바인드 계정을 사용하십시오.
  • ldaps://디렉터리 정책에 따라 StartTLS를 사용하는 LDAP 또는 기본 설정을 사용 하고, oCIS 컨테이너가 읽을 수 있는 위치에 발급 CA 인증서를 설치하십시오.
  • 안정적이고 고유한 사용자 식별자를 선택하십시오. 사용자가 인스턴스 사용을 시작한 후에는 ID 속성을 함부로 변경하지 마십시오.
  • oCIS 호스트 또는 컨테이너가 LDAP 서버를 확인하고 연결할 수 있는지, 그리고 방화벽 규칙에서 선택한 LDAP TLS 포트를 허용하는지 확인하십시오.

스키마 이름은 OpenLDAP, Active Directory 및 사용자 지정 디렉터리에 따라 다릅니다. ownCloud의 예시 기본값(예: inetOrgPerson, uid, ) 은 ownCloudUUID모든 경우에 적용되는 것은 아닙니다. 조치: 실제 디렉터리 항목과 각 속성을 대조하여 확인하고, 프로덕션 환경에 배포하기 전에 대표적인 테스트 계정을 사용하십시오.

내장 IDP를 구성합니다.

Docker Compose에서 환경 변수는 ocis서비스에 있어야 합니다. 다음은 템플릿이며, 그대로 사용할 수 있는 구성이 아닙니다. 모든 예시 값을 디렉터리의 실제 설정으로 바꾸고 CA 파일을 지정된 경로에 컨테이너에 마운트하십시오.

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

위 설정은 IDP 측 LDAP 조회 및 로그인에 적용됩니다. 암호는 환경 변수 대체 방식으로 표시되므로 Compose 파일에 하드코딩할 필요는 없지만, 환경 파일을 보호하거나 배포 플랫폼의 비밀 키 기능을 사용하십시오. CA 경로는 호스트뿐만 아니라 컨테이너 내부에도 존재해야 합니다. 조치: oCIS를 재시작하기 전에 CA를 읽기 전용으로 마운트하고 컨테이너 사용자가 해당 CA를 읽을 수 있는지 확인하십시오.

실제 활성화/비활성화 속성과 값을 사용하십시오. 문서에는 IDP_USER_ENABLED_ATTRIBUTE확인해야 할 속성 이름이 명시되어 있으며, "활성화"의 의미는 스키마 및 구현에 따라 다릅니다. 디렉터리에서 이 설정이 사용되지 않는 경우 임의로 값을 지정하지 마십시오. 해당 릴리스의 서비스 문서를 참조하십시오. 조치: 활성화된 계정과 비활성화된 계정을 모두 테스트하여 액세스 정책을 확인하십시오.

신원 조회와 인증을 일관되게 유지하세요.

IDP 설정만 변경하면 자격 증명 확인은 가능하지만 oCIS의 나머지 부분에서는 동일한 사용자 또는 그룹을 확인할 수 없는 경우가 발생할 수 있습니다. 사용자 서비스는 USERS_LDAP_URI, USERS_LDAP_CACERT, USERS_LDAP_BIND_DN, USERS_LDAP_BIND_PASSWORD, 을 포함한 자체 LDAP 변수를 사용합니다. USERS_LDAP_USER_BASE_DNGraph는 해당 GRAPH_LDAP_*옵션을 사용하여 사용자 및 그룹 쿼리를 제어합니다. 이러한 서비스가 배포 환경에 포함된 경우 해당 옵션을 동일한 디렉터리 및 호환 가능한 스키마로 설정하십시오.

예를 들어, IDP와 Graph 간의 사용자 기본 DN 및 고정 ID 속성을 일치시킨 다음, Graph의 그룹 기본 DN 및 멤버 속성을 LDAP 레코드와 일치하도록 설정하십시오. Graph 서비스 설명서에 따르면 LDAP 백엔드가 기본값이며 서버 쓰기 설정은 별도로 지정됩니다. 조치: 디렉터리가 다른 곳에서 권한을 갖는 경우 읽기 전용 조회로 시작하십시오. oCIS가 디렉터리 사용자 및 그룹을 생성하거나 수정해서는 안 되는 경우 설정 GRAPH_LDAP_SERVER_WRITE_ENABLED하십시오 .false

클라이언트가 실제로 HTTP 기본 인증을 필요로 하는 경우 에만 구성하십시오 AUTH_BASIC_AUTH_PROVIDER=ldap. ownCloud 문서에 따르면 기본 인증은 프록시에서도 활성화해야 하며 PROXY_ENABLE_BASIC_AUTH=true, 일반 OIDC 브라우저 로그인을 대체하는 것이 아닙니다. 조치: 지정된 클라이언트가 필요로 하지 않는 한 기본 인증을 비활성화 상태로 유지하고, 활성화하기 전에 보안상의 영향을 검토하십시오.

재시작, 테스트 및 문제 해결

  1. Compose 파일을 검증하고 변수가 올바른 서비스에 연결되었는지 확인하십시오.
  2. 서비스가 새 값을 로드하도록 하려면 일반적인 배포 절차에 따라 oCIS를 다시 시작하거나 재배포하십시오.
  3. LDAP 연결, 바인딩, 인증서 및 검색 오류에 대해서는 시작 로그와 서비스 로그를 확인하십시오.
  4. 웹 인터페이스를 통해 알려진 사용자의 로그인을 테스트한 다음, 사용자 프로필과 예상 그룹이 제대로 표시되는지 확인합니다.
  5. 잘못된 비밀번호와 사용 권한이 없는 사용자를 대상으로 테스트합니다. 둘 다 접근이 불가능한지 확인합니다.

연결에 실패하면 컨테이너 내부에서 DNS 및 네트워크 연결 가능성을 확인하고, LDAPS 호스트 이름이 인증서와 일치하는지, CA 체인이 신뢰할 수 있는지, 바인딩 DN과 암호가 올바른지 확인하십시오. LDAP 바인딩이 성공했다고 해서 사용자 검색 기준 또는 로그인 속성이 올바르다는 것을 보장하는 것은 아닙니다. 로그인은 되지만 사용자 또는 그룹 데이터가 누락된 경우 IDP, 사용자 및 그래프 설정을 비교하고 각 로그를 검사하십시오. 조치: TLS 유효성 검사를 완화하는 대신 한 번에 하나의 서비스와 하나의 테스트 계정을 테스트하여 오류를 격리하십시오.

프로덕션 환경에서 LDAP TLS 유효성 검사 우회 옵션을 설정하지 마십시오. ownCloud는 안전하지 않은 LDAP 인증서 설정에 대해 명시적으로 경고합니다. 로그인 및 그룹 확인이 확인될 때까지 복구 관리자 계정과 이전 정상 작동 구성의 사본을 보관하십시오. 조치: 먼저 스테이징 환경에 변경 사항을 적용한 다음, 관리자가 필요한 경우 이전 환경을 복원할 수 있는 시간대에 배포하십시오.

공식 참조

댓글 남기기

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

HTTP-01 또는 DNS-01을 선택하고 ownCloud 역방향 프록시를 구성한 다음 Certbot이 HTTPS 인증서를 자동으로 갱신하는지 확인하십시오.

사용자 로그인을 위해 ownCloud Infinite Scale을 LDAP에 연결합니다.

배포 전에 oCIS LDAP 로그인을 구성하고, 사용자 및 그룹 조회를 일치시키고, TLS 및 스키마 설정을 확인하십시오.

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

ownCloud 10에 Amazon S3 버킷을 추가하고, 호환되는 자격 증명 및 엔드포인트를 준비하고, 마운트와 기본 스토리지를 혼동하지 않고 액세스를 확인하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

ownCloud 서버에 대한 보호된 MariaDB 덤프를 예약하고, 유지 관리 모드를 안전하게 처리하며, 사용하기 전에 각 백업을 검증합니다.

지원되는 마이그레이션을 사용하여 ownCloud Classic을 oCIS로 이전하세요.

지원되는 앱, 순서대로 실행되는 명령, 신원 확인 절차, 그리고 별도로 처리해야 할 데이터 목록을 명확하게 작성하여 ownCloud 10에서 oCIS로의 마이그레이션을 계획하십시오.

브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.

업그레이드 후 ownCloud 무결성 경고를 해결하는 방법

잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.

Docker Compose를 사용하여 ownCloud Infinite Scale을 설치하세요.

ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.