10장. 항목 검색 및 튜닝 검색


웹 콘솔, 명령줄을 사용하고 LDAP 검색 유틸리티를 사용하여 디렉터리 항목을 검색할 수 있습니다. 사용자 수준에서 전역적으로 설정된 리소스 제한을 사용하고 익명 바인딩에 대해 검색 성능을 향상시킬 수 있습니다.

10.1. 명령줄을 사용하여 항목 검색(ldapsearch)

ldapsearch 명령줄 유틸리티를 사용하여 디렉터리 항목을 검색할 수 있습니다. 이 유틸리티는 지정된 ID 및 인증 정보를 사용하여 지정된 서버에 대한 연결을 열고 지정된 검색 필터를 기반으로 항목을 찾습니다. 검색 범위는 다음과 같습니다.

  • 단일 항목(-s 기본)
  • 항목 즉시 하위 항목(-s one)
  • 전체 트리 또는 하위 트리(-ssubtree)
참고

ldapsearch 유틸리티는 고유 이름의 속성을 기반으로 디렉터리 항목을 검색하지 않습니다. 고유 이름은 디렉터리 항목의 고유 식별자일 뿐이며 검색 키로 사용할 수 없습니다. 대신 ldapsearch 는 항목에 저장된 속성 값 쌍을 기반으로 항목을 검색합니다. 항목의 고유 이름이 (예: uid=bjensen,ou=People, dc=example,dc=com )인 경우 dc:example 이 이 항목에 속성 값 쌍으로 명시적으로 추가되지 않는 한 dc=example과 일치하지 않습니다.

ldapsearch 유틸리티는 RFC 2849 사양에 정의된 LDIF 형식으로 결과를 반환합니다.

10.1.1. ldapsearch 명령 형식

ldapsearch 명령은 다음 형식을 사용해야 합니다.

# ldapsearch [-x | -Y mechanism] [options] [search_filter] [list_of_attributes]
Copy to Clipboard Toggle word wrap
  • -x 또는 -Y

    -x (간단한 바인딩) 또는 -Y (SASL 메커니즘)를 사용하여 연결 유형을 구성합니다.

  • options

    ldapsearch 명령줄 옵션. 사용 중인 경우 검색 필터 앞에 옵션을 지정합니다.

  • search_filter

    LDAP 검색 필터입니다. -f 옵션을 사용하여 파일에서 검색 필터를 구성하는 경우 검색 필터를 지정하지 마십시오.

  • list_of_attributes

    공백 문자로 구분된 속성 목록입니다. 특성 목록을 지정하면 검색 결과에 반환되는 속성 수가 줄어듭니다. 이 속성 목록은 검색 필터 뒤에 표시되어야 합니다. 속성 목록을 지정하지 않으면 운영 특성을 제외하고 디렉터리에 설정된 액세스 제어에서 허용하는 모든 속성에 대한 값을 반환합니다.

    검색에서 작동 속성을 반환하려면 ldapsearch 검색 명령에 명시적으로 지정해야 합니다. 오브젝트의 모든 작동 속성을 반환하려면 + 를 사용합니다. 명시적으로 지정된 작동 속성 외에도 일반 속성을 검색하려면 속성 목록의 별표(*)를 사용합니다.

    별표 문자를 백슬래시(\*)로 이스케이프해야 할 수 있습니다.

    일치하는 DN 목록만 검색하려면 속성 1.1 을 사용합니다. 예를 들면 다음과 같습니다.

    # ldapsearch -D "cn=Directory Manager" -W -H ldap://server.example.com \ -b "dc=example,dc=com" -x "(objectclass=inetorgperson)" 1.1
    Copy to Clipboard Toggle word wrap

10.1.2. 일반적으로 사용되는 ldapsearch 옵션

다음 표에는 가장 일반적으로 사용되는 ldapsearch 유틸리티 옵션이 나열되어 있습니다. 지정된 값에 공백 문자가 포함된 경우 값은 작은따옴표 또는 큰따옴표로 묶어야 합니다. 예를 들면 다음과 같습니다.

-b "cn=My Special Group,ou=groups,dc=example,dc=com"

중요

OpenLDAP의 ldapsearch 유틸리티는 기본적으로 SASL 연결을 사용합니다. 간단한 바인딩 또는 TLS를 사용하려면 -x 인수를 사용하여 SASL을 비활성화하고 기타 연결 방법을 허용합니다.

Expand
옵션설명

-b

검색 시작 지점을 지정합니다(기본 고유 이름(DN)). 고유 이름은 데이터베이스에 있어야 합니다. LDAP_BASEDN 환경 변수를 기본 DN으로 설정하는 경우 이 옵션을 사용할 필요가 없습니다.
값에 공백 문자가 포함된 경우 옵션 값을 작은따옴표 또는 큰따옴표로 지정해야 합니다. 예:
-b "cn=user,ou=Product Development,dc=example,dc=com".
루트 DSE 항목을 검색하려면 여기에 빈 문자열(예: -b "" )을 지정합니다.

-D

서버를 인증하는 데 사용되는 DN을 지정합니다. Directory Server는 DN 값을 인식해야 하며 DN에는 항목을 검색할 권한이 있어야 합니다. 예:
-D "uid=user_name,dc=example,dc=com".
서버가 익명 액세스를 지원하는 경우 이 옵션을 지정하지 마십시오.

-H

서버에 연결할 LDAP URL을 지정합니다. LDAP URL 형식은 다음과 같습니다.

ldap[s]://hostname:[port]
Copy to Clipboard Toggle word wrap

포트 값을 지정하는 것은 선택 사항입니다. 그런 다음 ldapsearch 유틸리티는 기본 LDAP 포트 389 또는 LDAPS 포트 636을 사용합니다.

또한 유틸리티는 슬래시(/) 대신 HTML 16x 코드 %2F로 구분된 각 요소가 있는 LDAPI URL을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

ldapi://%2Ffull%2Fpath%2Fto%2Fslapd-example.socket
Copy to Clipboard Toggle word wrap

LDAPI의 경우 서버가 수신 대기하는 LDAPI 소켓을 나타내는 파일의 전체 경로를 지정합니다. URL을 지정하지 않은 경우 ldapsearch 는 localhost 또는 /etc/openldap/ldap.conf 파일에 지정된 설정을 사용합니다.

-h

Directory Server가 설치된 시스템의 호스트 이름 또는 IP 주소를 지정합니다. 예: -h server.example.com. 호스트를 지정하지 않은 경우 ldapsearch 는 localhost를 사용합니다. Directory Server는 IPv4 및 IPv6 주소를 모두 지원합니다.

참고

-h 옵션은 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 대신 -H 옵션을 사용합니다.

-p

Directory Server에서 사용하는 TCP 포트 번호를 지정합니다. 예를 들면 -p 1049 입니다. 기본 포트 번호는 389 입니다.

참고

-p 옵션은 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다.

-l

검색 요청을 완료하는 데 필요한 최대 시간 제한(초)을 지정합니다. 예를 들면 -l 300 입니다. ldapsearch 유틸리티가 이 두 값을 비교하고 가장 작은 값을 사용하므로 시간 제한은 nsslapd-timelimit 속성에 지정된 값을 초과해서는 안 됩니다. 기본 nsslapd-timelimit 속성 값은 3600 초입니다.

-s 범위

검색 범위를 지정합니다. 다음 범위 중 하나를 선택할 수 있습니다.


  • 하위항목은 -b 옵션에 지정된 항목과 모든 하위 항목을 검색합니다. 이는 기본 설정입니다.

  • 1개에서는 -b 옵션에 지정된 항목의 즉시 하위 항목을 검색합니다. ldapsearch 유틸리티는 기본 DN 자체가 아닌 하위만 고려합니다.
  • 기본
    -b 옵션에 지정된 항목 또는 LDAP_BASEDN 환경 변수에 의해 정의된 항목만 검색합니다.

-W

암호를 입력하라는 메시지를 표시합니다. 옵션을 지정하지 않은 경우 ldapsearch 유틸리티는 익명 액세스를 사용합니다. 또는 -w 옵션을 사용하여 암호를 유틸리티에 전달합니다.

참고

암호는 다른 사용자의 프로세스 목록에 표시될 수 있으며 쉘의 기록에 저장됩니다.

-x

간단한 바인딩을 허용하도록 기본 SASL 연결을 비활성화합니다.

-Y SASL_mechanism

인증에 사용할 SASL 메커니즘을 설정합니다. 메커니즘을 설정하지 않으면 ldapsearch 에서 서버에서 지원하는 최상의 메커니즘을 선택합니다. x 옵션을 사용하지 않는 경우 대신 -Y 옵션을 지정해야 합니다.

-Z 번호

검색 요청에 대한 응답에서 반환할 최대 항목 수를 설정합니다. 이 값은 루트 DN을 사용하여 바인딩할 때 nsslapd-sizelimit 특성을 덮어씁니다.

-f

검색 필터가 있는 파일을 지정합니다.

10.1.3. 특수 문자 사용

ldapsearch 유틸리티를 사용하는 경우 공백 문자, 별표(*) 또는 백슬래시(\)와 같이 명령줄 인터프리터에 특별한 의미가 있는 문자로 값을 지정해야 할 수 있습니다. 명령줄 인터프리터에 따라 특수 문자가 있는 값을 단일(' ) 또는 double(')따옴표로 묶습니다. 예를 들면 다음과 같습니다.

-D "cn=John Smith,ou=Product Development,dc=example,dc=com"
Copy to Clipboard Toggle word wrap

일반적으로 작은따옴표(' )를사용하여 값을 묶습니다. 쉘 변수가 있는 경우 변수 보간을 허용하려면 큰따옴표(" ")를 사용합니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat