LDAP를 통해 Active Directory 사용자를 ONLYOFFICE DocSpace와 동기화하세요.

ONLYOFFICE DocSpace와 LDAP 또는 Microsoft Active Directory 계정을 동기화하려면 설정 > 통합 > LDAP 설정에서 LDAP 인증을 활성화하고 디렉터리 연결 및 검색 매개변수를 입력한 다음 저장하고 가져오기를 확인하십시오. 이후 자동 동기화를 활성화하면 초기 설정을 반복하지 않고도 디렉터리 변경 사항이 DocSpace에 계속 반영됩니다.

이 절차는 DocSpace의 LDAP 통합에 적용되며, 독립형 ONLYOFFICE Docs 문서 편집 서버에는 적용되지 않습니다. ONLYOFFICE Workspace의 경우, 해당 설정은 제어판 > 포털 설정 > LDAP에서 찾을 수 있습니다. 2026년 10월 기준으로 확인된 최신 ONLYOFFICE 문서에 따르면, LDAP는 DocSpace SaaS 제품에서 유료 비즈니스 기능입니다. 사용 중인 자체 호스팅 버전의 기능은 별도로 확인하십시오. DocSpace LDAP 참조 및 Workspace 서버 설정 지침을 참조하십시오 .

먼저 간단한 디렉토리 가져오기를 계획하세요.

예시 시나리오: Acme Corp는 라는 Active Directory 도메인을 보유하고 있습니다 acme.local. IT 관리자는 Employees 조직 단위(OU)에 속한 각 직원에 대해 DocSpace 계정을 생성하고, 선택적으로 별도의 Groups OU에서 보안 그룹을 가져오려고 합니다. 아래의 이름, 경로 및 계정 예시는 가상의 구성 값이며, 실제 배포 환경의 결과가 아닙니다.

DocSpace를 사용하기 전에 서버가 도메인 컨트롤러에 연결할 수 있는지 확인하고, 포함해야 할 계정을 결정하고, 읽기 권한이 있는 디렉터리 계정을 준비하십시오. 도메인 관리자 계정 대신 읽기 전용 서비스 ID를 사용하십시오. 디렉터리 위치를 식별하는 정확한 LDAP 고유 이름(DN)과 Active Directory에서 이미 사용 중인 로그인 및 이메일 속성을 기록해 두십시오.

Acme의 예시 검색 기준은 입니다 OU=Employees,DC=acme,DC=local. 이 OU에서 시작하면 서비스 계정이나 관련 없는 사용자를 가져올 가능성을 줄일 수 있습니다. 사용자 또는 문서가 있는 기존 포털의 경우 LDAP 필터를 변경하기 전에 적절한 백업을 생성하고 복구 절차를 확인하십시오. ONLYOFFICE는 서버, 사용자 또는 그룹 검색 설정을 변경하면 이전에 가져온 계정과 해당 데이터에 영향을 줄 수 있다고 경고합니다. ONLYOFFICE의 백업 및 복원 문서를 검토하십시오 .

DocSpace를 디렉터리에 연결합니다.

1. LDAP 설정을 열고 인증을 활성화합니다.

DocSpace 관리자 계정으로 로그인하세요. 왼쪽 하단의 옵션 메뉴에서 설정을 선택한 다음, 통합 > LDAP 설정을 엽니다. LDAP 인증을 활성화하세요 . 구성 양식이 축소되어 있으면 표시 를 사용하여 펼치세요. 별도의 SAML 싱글 사인온 페이지를 LDAP 동기화 페이지와 혼동하지 마세요.

2. 보호된 LDAP 전송 방식을 선택합니다.

TLS로 업그레이드된 LDAP 연결의 경우 일반적으로 TCP 포트에서 StartTLS를 활성화하거나 , 389일반적 으로 TCP 포트에서 LDAPS에 SSL을 활성화하십시오636 . Acme 시나리오의 경우, 도메인 컨트롤러가 유효한 서버 인증서로 LDAPS를 사용하도록 구성되어 있다고 가정하면 LDAPS://dc1.acme.local및 를 사용하십시오 636. 지원되는 보안 방법 중 하나를 선택하십시오. 보호되지 않은 LDAP를 통해 바인딩 암호를 전송하지 마십시오.

Active Directory 도메인 컨트롤러에서 LDAPS를 사용하려면 적절한 인증서, 일치하는 DNS 이름 및 네트워크 액세스가 필요합니다. Microsoft는 SSL을 통한 LDAP용 인증서 구성 에 이러한 요구 사항을 명시하고 있습니다 . TLS 유효성 검사를 약화시키는 대신 서버에서 인증서 신뢰 문제를 해결하십시오.

3. 서버 및 바인딩 자격 증명을 입력합니다.

서버를 LDAP 또는 LDAPS URL로 설정 하고 포트 번호를 선택한 포트로 설정하십시오. 사용자 및 그룹 레코드를 읽기 위해 디렉터리 계정이 필요한 경우 양식의 인증svc_docspace@acme.local 옵션을 활성화하고 승인된 로그인과 암호를 입력하십시오. 샘플 서비스 ID는 다음과 같을 수 있습니다 . 실제 디렉터리에서 허용하는 바인딩 형식을 사용하십시오. 암호와 실제 계정 이름은 게시된 가이드나 스크린샷에 절대 포함해서는 안 됩니다.

가져올 사용자를 정확하게 선택하세요

4. 검색 기준 및 필터를 정의합니다.

사용자 DN을OU=Employees,DC=acme,DC=local 입력 하십시오 . Active Directory의 경우 ONLYOFFICE에서 권장하는 시작 필터는 입니다 . 이 필터는 선택한 검색 범위 내에 사용자 주체 이름이 있는 레코드를 선택합니다. 하지만 이 필터 자체만으로는 모든 결과가 실제 직원임을 보장하지는 않습니다. 조직에서 더 좁은 범위의 구성원을 필요로 하는 경우 OU 내용을 검토하거나 신중하게 검증된 필터를 사용하십시오.(userPrincipalName=*)

(uid=*)OpenLDAP 디렉터리에서는 사용자 필터와 로그인 속성에 대한 기본 설정이 다릅니다 uid. 이러한 기본 설정을 그대로 Active Directory 환경에 복사하지 마십시오.

5. 로그인 속성과 지도 프로필 데이터를 설정합니다.

AD의 경우 ONLYOFFICE 지침에 따라 로그인 속성을 설정하십시오 . 구성된sAMAccountName 로그인 속성은 사용자가 DocSpace 로그인 페이지에 입력하는 내용을 결정합니다. 지원되는 형식에는 단순 로그인, 로그인과 LDAP 도메인, 도메인 백슬래시 로그인이 있습니다. 가져오기 후 관리자가 아닌 직원 계정으로 형식을 테스트하십시오.

속성 매핑 에서 AD 스키마에 해당 필드가 있는 경우 이름(First Name)은 에 givenName, 성(Second Name)은 에 sn, 메일(Mail)은 에 매핑하십시오 mail. 이는 실제 디렉터리와 비교하여 확인해야 할 예시 매핑이며, 모든 환경에 적용되는 가정값이 아닙니다. 이메일 주소는 중요합니다. ONLYOFFICE에 따르면 메일 매핑은 DocSpace 이메일 주소에 사용됩니다. 메일 데이터가 누락되면 로그인 및 LDAP 도메인에서 파생된 주소가 생성되어 사용자에게 알림이 전달되지 않을 수 있습니다.

그룹을 가져온 다음 지속적인 동기화를 켜세요.

6. 선택적 그룹 멤버십을 구성합니다.

Acme에서 디렉터리 그룹도 사용하려면 그룹 멤버십을 활성화하십시오 . 이 예에서는 OU=Groups,DC=acme,DC=local그룹 DN에 를, (objectClass=group)그룹 필터에 를 사용합니다. ONLYOFFICE에서 제공하는 AD 매핑 문서에서는 distinguishedName사용자 속성에 를, member그룹 속성에 를 사용합니다. 디렉터리에 적합한 기존 그룹 이름 속성을 사용하십시오.

저장하기 전에 멤버십을 확인하십시오. ONLYOFFICE에서는 그룹 가져오기를 활성화하면 가져온 사용자가 하나 이상의 일치하는 그룹에 속한 사용자로 제한된다는 점을 명시적으로 알려드립니다. Acme의 시범 운영 직원이 선택한 그룹에 속하지 않는 경우, 처음에는 그룹 가져오기를 비활성화하거나 가져오기 전에 디렉터리 범위를 수정하십시오. 단순히 사용자 수를 늘리기 위해 그룹 필터를 전체 도메인으로 확장하지 마십시오.

7. 설정을 저장하고 가져오기를 확인합니다.

검색 기준, 계정 매핑 및 원하는 디렉터리 멤버십을 검토한 다음 저장을 클릭합니다. 가져오기 확인 대화 상자 에서 확인을 선택하여 시작합니다. 디렉터리 검색 및 가져오기에 시간이 소요될 수 있으며, 소요 시간은 환경에 따라 다릅니다. 대규모 AD 배포의 경우 ONLYOFFICE 설명서에서는 AD 쿼리 제한을 1,000개 항목으로 명시하고 있습니다. 도메인 컨트롤러 설정을 변경하기 전에 AD 관리자와 협의하여 페이징 또는 디렉터리 제한을 변경하십시오.

가져온 계정은 계정 메뉴 에서 확인하세요 . LDAP에 연결된 프로필은 관리자 보기에서 LDAP 표시기가 나타납니다. 처음 실행할 때는 의도적으로 범위를 좁혀 잘못된 필터, 메일 매핑 또는 그룹 규칙을 수정하고 전체 조직을 추가하기 전에 오류를 바로잡으세요. 저장 성공 여부만으로 사용자가 인증할 수 있다고 주장하지 마세요.

8. 자동 동기화를 예약하고 수동 동기화를 한 번 실행합니다.

LDAP 설정으로 돌아가서 자동 동기화를 활성화 하고 DocSpace 버전에 따라 시간별, 일별, 주별 또는 월별 동기화 간격을 선택하세요. 일정을 저장합니다. 즉시 업데이트하려면 LDAP 페이지 하단의 사용자 동기화를 선택하세요 . ONLYOFFICE 문서에는 LDAP 사용자가 로그인한 후 사용자별 업데이트가 설명되어 있지만, 이러한 로그인 동작은 그룹 및 계정 레코드를 새로 고쳐야 할 때 수행되는 정기적인 디렉터리 전체 동기화를 대체하는 것은 아닙니다.

로그인 및 다음 업데이트를 확인하세요

파일럿 직원 계정을 사용하여 AD 자격 증명으로 로그인한 다음 DocSpace 프로필에 예상 이름과 이메일 주소가 표시되는지 확인합니다. 그룹 기능이 활성화된 경우, 직원이 가져온 그룹에 속해 있고 DocSpace 권한을 통해 부여된 회의실에만 접근할 수 있는지 확인합니다. 마지막으로 파일럿 계정에서 중요하지 않은 디렉터리 필드를 변경하고 사용자 동기화를 실행한 다음 DocSpace 프로필에 변경 사항이 반영되었는지 확인합니다.

• 사용자가 표시되지 않습니다. 사용자 DN, 필터, 서비스 계정의 읽기 권한, 그리고 그룹 멤버십 활성화 시 파일럿 사용자가 제외되었는지 여부를 다시 확인하십시오.
• 인증에 실패했습니다. 로그인 속성, 계정의 디렉터리 상태, 네트워크 액세스 및 TLS 인증서 신뢰도를 확인하십시오.
• 이름이나 이메일이 잘못되었습니다. 설정된 검색 범위를 변경하기 전에 매핑된 LDAP 속성과 실제 디렉터리 레코드를 비교하십시오.
• 이후 변경 사항이 반영되지 않는 경우, 자동 동기화가 저장되었는지 확인하고, 사용자 동기화를 수동으로 실행하고, 수정된 계정이 구성된 필터 내에 남아 있는지 확인하십시오.

선택한 사용자가 가져오기되고, 파일럿 사용자가 디렉터리 자격 증명으로 인증할 수 있고, 의도한 그룹 제한이 적용되고, 이후 프로필 변경 사항 중 하나 이상이 올바르게 동기화될 때만 설정이 확정됩니다.