커뮤니티 솔루션

ZimaOS의 LDAP 인증: 현재 옵션과 한계

Homelab users requested LDAP/domain authentication so ZimaOS Samba shares and self-hosted apps could use common identities; no native implementation was announced.

ZimaOS는 현재 소유자/구성원 계정 또는 Samba 공유에 대한 기본 LDAP나 Active Directory 인증을 문서화하고 있지 않습니다. 지원되는 다중 사용자 모델은 공유별 권한이 설정된 로컬 ZimaOS 구성원 계정입니다.

원래 스레드는 도메인 계정을 원하는 홈랩 및 소규모 사업체 사용자의 기능 요청이었습니다. IceWhale은 LDAP 지원을 발표하는 답변을 하지 않았으므로, Docker LDAP 서버를 구성한 뒤 ZimaOS Samba가 자동으로 이를 사용하리라 가정하지 마세요.

현재 ZimaOS에서 지원하는 기능

현재 ZimaOS Samba 다중 사용자 가이드에는 로컬 구성원 계정, 비밀번호, 게스트 액세스, 폴더 권한이 안내되어 있습니다.

Docker에서 OpenLDAP를 실행하는 것만으로는 충분하지 않은 이유

LDAP 컨테이너는 LDAP를 지원하는 애플리케이션에 디렉터리 서비스를 제공할 수 있지만, ZimaOS 계정/Samba 계층에는 여전히 명시적인 LDAP/SSSD/winbind 통합이 필요합니다. 현재 ZimaOS 문서에는 해당 통합이 안내되어 있지 않습니다.

지원되는 경우 앱 수준에서 LDAP 사용하기

ID 공급자를 운영하고, Nextcloud나 LDAP/OIDC를 지원하는 다른 소프트웨어와 같은 개별 애플리케이션을 여기에 연결할 수는 있습니다. ZimaOS 자체에서 로컬 NAS 계정을 사용하더라도 앱 로그인을 통합할 수 있습니다.

NAS 관리 계정 분리하기

가정용 또는 소규모 사무실 시스템에서는 소유자/관리자 계정을 로컬로 유지하면 디렉터리 서비스 중단으로 스토리지 관리가 차단될 가능성을 줄일 수 있습니다.

로컬 구성원 계정으로 SMB 액세스 매핑하기

SMB 액세스가 필요한 사용자마다 ZimaOS 구성원을 만들고, 필요한 공유 폴더만 할당하며, 민감한 폴더의 게스트 액세스는 비활성화하세요.

Samba를 도메인 구성원으로 무작정 설정하지 마세요

Samba를 AD에 가입시키려면 일반적으로 Kerberos, winbind/SSSD, NSS/PAM, 머신 자격 증명, DNS 및 영구 구성 설정이 필요합니다. ZimaOS는 어플라이언스형 운영체제이므로, 관리되지 않는 패키지나 구성 변경 사항은 사라지거나 내장 공유 서비스와 충돌할 수 있습니다.

하이브리드 ID 아키텍처

LDAP / OIDC 공급자
   ├─ Nextcloud
   ├─ 기타 Docker 앱
   └─ 내부 서비스

ZimaOS 로컬 계정
   ├─ 소유자/관리자
   └─ SMB 구성원 계정

모든 곳에서 싱글 사인온을 제공하는 방식은 아니지만, 현재 제품의 경계에 맞춰 관리할 수 있습니다.

액세스 제어 가이드에서 유용한 보안 정보를 확인할 수 있습니다.

계층별로 단일 ID 출처를 사용하세요

애플리케이션은 LDAP를 사용하지만 ZimaOS SMB는 로컬 구성원을 사용한다면, 이 차이를 사용자에게 명확히 안내하세요. 비밀번호 관리 정책이 없다면 비밀번호가 서로 다른 동일한 사용자 이름을 만들지 마세요. 싱글 사인온이 제대로 작동하지 않는 것처럼 보일 수 있습니다.

디렉터리 서비스를 별도로 백업하세요

OpenLDAP, Authentik, Keycloak 또는 다른 ID 서비스를 Docker에서 실행한다면 해당 서비스의 데이터베이스와 서명 및 구성 데이터를 별도로 백업해야 합니다. ID 공급자가 손실되면 연결된 모든 앱에서 사용자가 잠길 수 있습니다.

NAS 복구를 LDAP에 의존시키지 마세요

디렉터리 컨테이너, DNS 또는 네트워크를 사용할 수 없는 상황에서도 저장소를 관리할 수 있도록 ZimaOS 로컬 소유자 계정을 하나 이상 유지하세요. 그러면 ID 서비스가 중단되어도 복구 경로를 확보할 수 있습니다.

FAQ

현재 ZimaOS를 Active Directory에 가입시킬 수 있나요?

현재 ZimaOS 문서에는 공식 AD/LDAP 가입 절차가 안내되어 있지 않습니다.

ZimaOS에서 OpenLDAP을 실행할 수 있나요?

Docker 앱으로 실행할 수는 있지만, 그렇다고 ZimaOS Samba가 자동으로 LDAP에 인증하는 것은 아닙니다.

Docker 앱에서 LDAP를 사용할 수 있나요?

각 애플리케이션이 LDAP 또는 다른 ID 프로토콜을 지원한다면 가능합니다.

SMB 사용자에는 무엇을 사용해야 하나요?

현재 ZimaOS 로컬 구성원 계정과 공유별 권한을 사용하세요.