¶ LDAP
¶ 개요
LDAP(Lightweight Directory Access Protocol)[1]는 조직 · 구성원 · 장비 같은 데이터를 트리 구조로 저장한 디렉터리에 읽고 쓰기 위한 프로토콜이다. 애플리케이션이 디렉터리 서비스와 정보를 주고받는 공통 언어를 제공하며, 실무에서는 주로 사용자 계정을 한곳에 두고 여러 서비스가 같은 계정으로 인증하게 하는 데 쓴다. Kerberos · SSO · SASL · TLS 지원을 갖춰 IAM(Identity and Access Management)의 사용자 저장소 역할을 한다.
구현체는 OpenLDAP · 389 Directory Server(FreeIPA 의 바탕) · Microsoft Active Directory 가 있다. Active Directory 도 LDAP 으로 조회할 수 있어 ldapsearch 가 그대로 통한다.
¶ 구성 요소
LDAP 인증은 클라이언트-서버 모델이며 다음 요소로 이루어진다.
| 요소 | 뜻 |
|---|---|
| DSA (Directory System Agent) | LDAP 서버. slapd 가 이것이다 |
| DUA (Directory User Agent) | 서버에 접속하는 클라이언트 — 사용자 PC · 애플리케이션 |
| DIT (Directory Information Tree) | 항목이 이루는 트리. 최상위를 suffix 또는 base DN 이라 한다 |
| DN (Distinguished Name) | 트리 안 항목의 전체 경로 — uid=susan,ou=users,dc=example,dc=com |
| RDN (Relative DN) | DN 의 각 구성 요소 — uid=susan |
| Entry · Attribute · objectClass | 항목은 속성의 집합이고, objectClass 가 어떤 속성을 가져야 하는지 정한다(schema) |
| Bind | 인증 동작. 익명 · simple(DN + 비밀번호) · SASL(Kerberos 등)[2] |
| LDIF | 항목을 텍스트로 적는 형식. ldapadd · ldapmodify 의 입력 |
포트는 389(평문 · StartTLS) 와 636(LDAPS) 이다. Active Directory 글로벌 카탈로그는 3268 · 3269 를 더 쓴다.
¶ OpenLDAP 설치
¶ OpenLDAP
- LDAP 의 오픈소스 구현체. 개요 · 요구사항 · 배포판 패키지와 소스 빌드의 선택 기준.
¶ OpenLDAP v2.7.1 설치 가이드
- 현행 기능 릴리스. RHEL 9 계열에 소스 빌드로 설치하고
slapd.conf로 LDAPS 까지 연다.
¶ OpenLDAP v2.6.10 설치 가이드
- 2.6 계열 소스 빌드 기록. Keycloak 연동까지 다룬다.
¶ 설정과 운영
¶ OpenLDAP cn=config 전환과 EXTERNAL 인증
- 정적
slapd.conf와 동적cn=config의 차이,ldapi://EXTERNAL 바인드.
¶ OpenLDAP 접근 제어(ACL) 작성
access to·olcAccess규칙의 평가 순서와 흔한 구성.
¶ OpenLDAP 계정 비활성화와 비밀번호 정책
- 무엇을 막고 싶은지에 따라 달라지는 비활성화 방법과 ppolicy 오버레이.
¶ 쿠버네티스에 올린 OpenLDAP 의 데이터 보존
- 파드를 다시 띄우면 계정이 사라지는
emptyDir구성을 영속 볼륨으로 바꾼다.
¶ 조회와 수정
¶ ldapsearch
- 조회 명령으로 동작을 확인하고 항목을 찾는다.
¶ ldapmodify 로 그룹에 사용자 추가 — AD 와 OpenLDAP 의 차이
- 그룹 objectClass 별 속성 차이와 AD 의
member표기.
¶ Active Directory · FreeIPA 연동
¶ AD 연동 - 필요한 계정 권한과 글로벌 카탈로그
- 애플리케이션 연동에 요청해야 할 바인드 계정 권한과 포트 · 글로벌 카탈로그 선택.
¶ AD LDAP Signing 강제와 StartTLS · LDAPS 진단
- Windows Server 2025 부터 기본이 된 LDAP 서명 요구와 그에 맞춘 접속 방식.
¶ FreeIPA 사용자 DN 확인과 CDP LDAP 바인드 설정
- FreeIPA 의 DN 구조를 확인해 CDP 의 LDAP 바인드 항목을 채운다.
¶ GitLab CE 와 AD(LDAP) 연동
gitlab.rb설정과 Community Edition 에서 되는 것 · 안 되는 것의 구분.
¶ 문제 해결
¶ OpenLDAP 소스 빌드와 기동 실패
./configure단계의 누락 패키지와 설치 경로 · 설정 경로 불일치.
¶ OpenLDAP 운영 중 나는 오류
- LDAP 결과 코드별 흔한 원인을 정리한다.
¶ uidNumber 중복 - unique overlay 확인과 해제
Constraint violation (19)로 LDIF 가 들어가지 않을 때 오버레이를 확인한다.
¶ 하위 문서
¶ AD 계정 생성 자동화 — LDAPS 와 unicodePwd
- Active Directory 도메인 컨트롤러에 사용자 계정을 프로그램으로 생성·등록할 때(예: 셀프서비스 계정 등록 웹 서비스) 걸리는 핵심…
¶ AD 사용자 검색 필터에 쓸 속성 고르기
- 애플리케이션의 LDAP 설정에 흔히 다음과 같은 값이 들어간다.
¶ JNDI 로 LDAP·AD 에 붙고 페이지 단위로 읽기
- 자바 애플리케이션의 LDAP 설정 파일에
INITIAL_CONTEXT_FACTORY·PROVIDER_URL같은 항목이 있는데 무엇…
¶ LDAP 패스워드 변경 — ldappasswd 와 관리자 DN
ldapsearch는 조회 전용이다. 이름 때문에 "검색 조건으로 값을 바꾼다" 고 오해하기 쉽지만 쓰기 동작이 없다. 변경은 `ldap…
¶ OpenLDAP LDIF 적재
- 데이터를 넣는 방법은 둘이고, 고르는 기준은 slapd 가 떠 있느냐다.
¶ OpenLDAP 로그 수준과 출력 위치
slapd는 자기 로그 파일을 직접 만들지 않는다. syslog 로 보낼 뿐이다. 그래서 로그가 안 보인다는 문제는 대개 수준이 낮아서이…
¶ AD 연동 - 필요한 계정 권한과 글로벌 카탈로그
¶ FreeIPA 사용자 DN 확인과 CDP LDAP 바인드 설정
¶ GitLab CE 와 AD(LDAP) 연동
¶ OpenLDAP
¶ OpenLDAP cn=config 전환과 EXTERNAL 인증
¶ OpenLDAP v2.6.10 설치 가이드
¶ OpenLDAP v2.7.1 설치 가이드
¶ OpenLDAP 계정 비활성화와 비밀번호 정책
¶ OpenLDAP 접근 제어(ACL) 작성
¶ ldapmodify 로 그룹에 사용자 추가 — AD 와 OpenLDAP 의 차이
¶ ldapsearch
¶ uidNumber 중복 - unique overlay 확인과 해제
¶ 쿠버네티스에 올린 OpenLDAP 의 데이터 보존
¶ 트러블슈팅
¶ OpenLDAP 문제 해결
RFC 4511 — LDAP: The Protocol. 2026-09-20 확인. https://www.rfc-editor.org/rfc/rfc4511.html ↩︎
RFC 4513 — LDAP: Authentication Methods and Security Mechanisms. 2026-09-20 확인. https://www.rfc-editor.org/rfc/rfc4513.html ↩︎