ldapsearch

LDAP 서버에 연결하여 지정한 필터 조건으로 디렉터리를 검색합니다. 검색 결과의 각 항목을 레코드로 변환하여 출력합니다.

명령어 속성

문법

옵션

profile=STR

LDAP 접속 프로파일 이름. 시스템에 등록된 LDAP 프로파일을 지정합니다.

filter=STR

LDAP 필터 표현식. RFC 4515 표준 LDAP 필터 문법을 사용합니다. 지정하지 않으면 모든 항목을 반환합니다.

출력 필드

LDAP 항목의 속성(attribute)이 필드로 출력됩니다. 항목마다 속성 구성이 다를 수 있습니다. 주요 필드는 다음과 같습니다:

오류 코드

파싱 오류

런타임 오류

해당 사항 없음

설명

ldapsearch 명령어는 시스템에 등록된 LDAP 접속 프로파일로 LDAP 서버에 연결하여 디렉터리를 검색합니다. 검색 결과의 각 항목이 레코드로 변환되며, 항목의 속성이 필드로 출력됩니다.

LDAP 프로파일에는 서버 호스트, 포트, 바인드 DN, 비밀번호, 기본 DN 정보가 포함되어 있습니다. 검색은 기본 DN을 루트로 하는 서브트리 전체를 대상으로 수행됩니다(SCOPE_SUB).

objectGUID, objectSid, userParameters 속성은 바이너리 타입으로 반환됩니다.

사용 예

1. 모든 Active Directory 사용자 조회

   ldapsearch profile=ad_server filter="(&(objectClass=user)(objectCategory=person))"
   

   Active Directory에서 사람 유형의 사용자 계정을 모두 조회합니다.

2. 특정 그룹의 구성원 조회

   ldapsearch profile=ad_server filter="(&(objectClass=user)(memberOf=CN=Admins,DC=example,DC=com))"
   | fields sAMAccountName, name, userPrincipalName
   

   Admins 그룹의 구성원을 조회하고 계정 이름, 표시 이름, UPN만 출력합니다.

3. 계정 이름으로 특정 사용자 조회

   ldapsearch profile=ad_server filter="(sAMAccountName=jsmith)"
   

   jsmith 계정 이름을 가진 사용자를 조회합니다.

호환성

ldapsearch 명령어는 소나 4.0 이전 버전부터 제공되었습니다.