21장. LDAP 그룹 동기화


LDAP 디렉터리에 저장된 그룹을 사용하여 사용자 멤버십 및 권한을 관리할 수 있도록 OpenShift Container Platform과 LDAP 그룹을 동기화합니다.

관리자는 그룹을 사용하여 사용자를 관리하고 권한을 변경하며 협업을 개선할 수 있습니다. 조직에서 이미 사용자 그룹을 생성하여 LDAP 서버에 저장했을 수 있습니다. OpenShift Container Platform은 이러한 LDAP 레코드를 내부 OpenShift Container Platform 레코드와 동기화하므로 한 곳에서 그룹을 관리할 수 있습니다. OpenShift Container Platform은 현재 그룹 멤버십을 정의하는 RFC 2307, Active Directory, 보강된 Active Directory라는 세 가지 공통 스키마를 사용하여 LDAP 서버와 그룹의 동기화를 지원합니다.

LDAP 구성에 대한 자세한 내용은 "LDAP ID 공급자 구성"을 참조하십시오.

참고

그룹을 동기화하려면 cluster-admin 권한이 있어야 합니다.

21.1. LDAP 동기화 구성 정보

LDAP 그룹 동기화의 작동 방식과 LDAP 스키마에 대한 그룹 동기화를 구성할 수 있도록 포함된 동기화 구성 파일을 검토합니다.

LDAP 동기화를 실행하려면 동기화 구성 파일이 필요합니다. 이 파일에는 다음과 같은 LDAP 클라이언트 구성 세부 사항이 있습니다.

  • LDAP 서버 연결에 필요한 구성
  • LDAP 서버에서 사용되는 스키마에 종속된 동기화 구성 옵션
  • OpenShift Container Platform 그룹 이름을 LDAP 서버의 그룹에 매핑하는 관리자 정의 이름 매핑 목록

구성 파일의 형식은 사용 중인 스키마에 따라 다릅니다.

  • RFC 2307
  • Active Directory
  • 보강된 Active Directory

21.1.1. LDAP 클라이언트 구성

구성의 LDAP 클라이언트 구성 섹션에서는 LDAP 서버에 대한 연결을 정의합니다. 다음 예제에서는 LDAP 클라이언트 구성 필드를 보여줍니다.

url: ldap://10.0.0.0:389
bindDN: cn=admin,dc=example,dc=com
bindPassword: <password>
insecure: false
ca: my-ldap-ca-bundle.crt
  • url 필드에는 연결 프로토콜, 데이터베이스를 호스팅하는 LDAP 서버의 IP 주소, 연결할 포트가 scheme://host:port 로 포맷되어 표시됩니다.
  • bindDN 필드에는 바인딩 DN으로 사용할 선택적 고유 이름(DN)이 표시됩니다. OpenShift Container Platform에서는 동기화 작업을 위한 항목을 검색하는 데 높은 권한이 필요한 경우 이 고유 이름을 사용합니다.
  • bindPassword 필드에는 바인딩에 사용할 선택적 암호가 표시됩니다. OpenShift Container Platform에서는 동기화 작업을 위한 항목을 검색하는 데 높은 권한이 필요한 경우 이 암호를 사용합니다. 이 값은 환경 변수, 외부 파일 또는 암호화된 파일로 제공될 수도 있습니다.
  • insecure 필드는 LDAP 연결이 TLS를 사용하는지 여부를 제어합니다. false 로 설정하면ldaps:// URL이 TLS를 사용하여 서버에 연결되고 ldap:// URL은 TLS로 업그레이드됩니다. true 로 설정하면 서버에 TLS 연결이 이루어지지 않으며 ldaps:// URL 스키마를 사용할 수 없습니다.
  • ca 필드에는 구성된 URL의 서버 인증서의 유효성을 확인하는 데 사용할 인증서 번들이 표시됩니다. 비어있는 경우 OpenShift Container Platform은 시스템에서 신뢰하는 루트를 사용합니다. insecure가 false로 설정된 경우에만 적용됩니다.

21.1.2. LDAP 쿼리 정의

동기화 구성은 동기화에 필요한 항목에 대한 LDAP 쿼리 정의로 구성됩니다. LDAP 쿼리의 특정 정의는 LDAP 서버에 멤버십 정보를 저장하는 데 사용하는 스키마에 따라 다릅니다. 다음 예제에서는 LDAP 쿼리 정의 필드를 보여줍니다.

baseDN: ou=users,dc=example,dc=com
scope: sub
derefAliases: never
timeout: 0
filter: (objectClass=person)
pageSize: 0
  • baseDN 필드에는 모든 검색이 시작되는 디렉터리 분기의 고유 이름(DN)이 포함되어 있습니다. 디렉터리 트리의 최상위를 지정해야 하지만 디렉터리의 하위 트리를 지정할 수도 있습니다.
  • scope 필드에는 검색 범위가 표시됩니다. 유효한 값은 base,one, sub 입니다. 이 필드를 생략하면 기본값은 sub 입니다. 각 값에 대한 설명은 표 1, LDAP 검색 범위 옵션을 참조하십시오.
  • derefAliases 필드에는 LDAP 트리의 별칭과 관련된 검색 동작이 표시됩니다. 유효한 값은 never, search, base 또는 always입니다. 값이 정의되지 않은 경우 기본값은 always 역참조 별칭으로 설정됩니다. 역참조 동작에 대한 설명은 표 2의 LDAP 역참조 동작 입니다.
  • timeout 필드에는 클라이언트에서 검색할 수 있는 시간 제한(초)이 표시됩니다. 값이 0이면 클라이언트 쪽 제한이 적용되지 않습니다.
  • filter 필드에는 유효한 LDAP 검색 필터가 포함되어 있습니다. 정의되지 않은 경우 기본값은 (objectClass=*)입니다.
  • pageSize 필드에는 서버가 페이지당 반환하는 최대 LDAP 항목 수가 표시됩니다. 0 으로 설정하면 페이지 크기 제한이 적용되지 않습니다. 쿼리에서 기본적으로 허용하는 클라이언트 또는 서버보다 더 많은 항목을 반환할 때 이 필드를 설정합니다.
LDAP 검색 범위설명

base

쿼리의 기본 DN에 의해 지정된 오브젝트만 고려합니다.

one

쿼리의 기본 DN과 동일한 수준의 트리에 있는 모든 오브젝트를 고려합니다.

sub

쿼리에 대해 제공된 기본 DN을 기반으로 하는 전체 하위 트리를 고려합니다.

역참조 행동설명

never

LDAP 트리에 있는 별칭을 역참조하지 않도록 합니다.

search

검색하는 동안 역참조 별칭만 발견되었습니다.

base

기본 오브젝트를 찾는 동안 별칭만 역참조합니다.

always

항상 LDAP 트리에 있는 모든 별칭을 역참조합니다.

21.1.3. 사용자 정의 이름 매핑

사용자 정의 이름 매핑은 OpenShift Container Platform 그룹의 이름을 LDAP 서버에서 그룹을 식별하는 고유 식별자에 명시적으로 매핑합니다. 매핑에서는 일반 YAML 구문을 사용합니다. 사용자 정의 매핑은 LDAP 서버의 모든 그룹에 대한 항목을 포함하거나 그룹의 하위 집합만 포함할 수 있습니다. LDAP 서버에 사용자 정의 이름 매핑이 없는 그룹이 있는 경우 동기화 중 기본 동작은 OpenShift Container Platform 그룹의 이름으로 지정된 속성을 사용하는 것입니다.

다음 예제에서는 사용자 정의 이름 매핑을 보여줍니다.

groupUIDNameMapping:
  "cn=group1,ou=groups,dc=example,dc=com": firstgroup
  "cn=group2,ou=groups,dc=example,dc=com": secondgroup
  "cn=group3,ou=groups,dc=example,dc=com": thirdgroup

21.1.4. RFC 2307 구성 파일 정보

사용자 및 그룹 쿼리 및 OpenShift Container Platform 그룹 레코드에 사용되는 속성을 정의할 수 있도록 RFC 2307 LDAP 동기화 구성 파일을 검토하십시오.

RFC 2307 스키마를 사용하려면 사용자 항목 및 그룹 항목에 대한 LDAP 쿼리 정의와 내부 OpenShift Container Platform 레코드에서 해당 항목을 표시하는 데 사용할 속성을 제공해야 합니다.

명확히 하기 위해 OpenShift Container Platform에서 생성하는 그룹은 사용자 대면 또는 관리자용 필드에 대해 가능한 경우 고유 이름 이외의 속성을 사용해야 합니다. 예를 들면 이메일로 OpenShift Container Platform 그룹의 사용자를 구분하고, 그룹 이름을 공통 이름으로 사용합니다. 다음 구성 파일에서는 이러한 관계를 생성합니다.

참고

사용자 정의 이름 매핑을 사용하는 경우 구성 파일이 다릅니다.

kind: LDAPSyncConfig
apiVersion: v1
url: ldap://LDAP_SERVICE_IP:389
insecure: false
bindDN: cn=admin,dc=example,dc=com
bindPassword:
  file: "/etc/secrets/bindPassword"
rfc2307:
    groupsQuery:
        baseDN: "ou=groups,dc=example,dc=com"
        scope: sub
        derefAliases: never
        pageSize: 0
    groupUIDAttribute: dn
    groupNameAttributes: [ cn ]
    groupMembershipAttributes: [ member ]
    usersQuery:
        baseDN: "ou=users,dc=example,dc=com"
        scope: sub
        derefAliases: never
        pageSize: 0
    userUIDAttribute: dn
    userNameAttributes: [ mail ]
    tolerateMemberNotFoundErrors: false
    tolerateMemberOutOfScopeErrors: false

다음과 같습니다.

url
그룹 레코드가 저장된 LDAP 서버의 IP 주소와 호스트를 지정합니다.
insecure
LDAP 연결에서 TLS를 사용하는지 여부를 지정합니다. false 로 설정하면ldaps:// URL이 TLS를 사용하여 서버에 연결되고 ldap:// URL은 TLS로 업그레이드됩니다. true 로 설정하면 서버에 TLS 연결이 이루어지지 않으며 ldaps:// URL 스키마를 사용할 수 없습니다.
rfc2307.groupUIDAttribute
LDAP 서버에서 그룹을 고유하게 식별하는 특성을 지정합니다. groupUIDAttribute로 DN을 사용할 때는 groupsQuery 필터를 지정할 수 없습니다. 세분화된 필터링의 경우 허용 목록 파일, 거부 목록 파일 또는 둘 다를 사용합니다.
rfc2307.groupNameAttributes
그룹 이름으로 사용할 속성을 지정합니다.
rfc2307.groupMembershipAttributes
멤버십 정보를 저장하는 그룹의 특성을 지정합니다.
rfc2307.userUIDAttribute
LDAP 서버에서 사용자를 고유하게 식별하는 속성을 지정합니다. userUIDAttribute로 DN을 사용할 때는 usersQuery 필터를 지정할 수 없습니다. 세분화된 필터링의 경우 허용 목록 파일, 거부 목록 파일 또는 둘 다를 사용합니다.
rfc2307.userNameAttributes
OpenShift Container Platform 그룹 레코드에서 사용자 이름으로 사용할 속성을 지정합니다.

21.1.5. Active Directory 구성 파일 정보

OpenShift Container Platform 그룹 레코드에 사용되는 사용자 쿼리 및 속성을 정의할 수 있도록 Active Directory LDAP 동기화 구성 파일을 검토하십시오.

Active Directory 스키마를 사용하려면 사용자 항목에 대한 LDAP 쿼리 정의와 내부 OpenShift Container Platform 그룹 레코드에서 해당 항목을 표시하는 속성을 제공해야 합니다.

명확히 하기 위해 OpenShift Container Platform에서 생성하는 그룹은 사용자 대면 또는 관리자용 필드에 대해 가능한 경우 고유 이름 이외의 속성을 사용해야 합니다. 예를 들면 OpenShift Container Platform 그룹의 사용자는 이메일로 구분하지만, 그룹 이름은 LDAP 서버의 그룹 이름에 따라 정의합니다. 다음 구성 파일에서는 이러한 관계를 생성합니다.

kind: LDAPSyncConfig
apiVersion: v1
url: ldap://LDAP_SERVICE_IP:389
activeDirectory:
    usersQuery:
        baseDN: "ou=users,dc=example,dc=com"
        scope: sub
        derefAliases: never
        filter: (objectclass=person)
        pageSize: 0
    userNameAttributes: [ mail ]
    groupMembershipAttributes: [ memberOf ]

다음과 같습니다.

activeDirectory.userNameAttributes
OpenShift Container Platform 그룹 레코드에서 사용자 이름으로 사용할 속성을 지정합니다.
activeDirectory.groupMembershiptAttributes
멤버십 정보를 저장하는 사용자의 속성을 지정합니다.

21.1.6. 보강된 Active Directory 구성 파일 정보

사용자 및 그룹 쿼리 및 OpenShift Container Platform 그룹 레코드에 사용되는 속성을 정의할 수 있도록 보강된 Active Directory LDAP 동기화 구성 파일을 검토합니다.

보강된 Active Directory 스키마를 사용하려면 사용자 항목 및 그룹 항목에 대한 LDAP 쿼리 정의와 내부 OpenShift Container Platform 그룹 레코드에서 해당 항목을 표시하는 속성을 제공해야 합니다.

명확히 하기 위해 OpenShift Container Platform에서 생성하는 그룹은 사용자 대면 또는 관리자용 필드에 대해 가능한 경우 고유 이름 이외의 속성을 사용해야 합니다. 예를 들면 이메일로 OpenShift Container Platform 그룹의 사용자를 구분하고, 그룹 이름을 공통 이름으로 사용합니다. 다음 구성 파일에서는 이러한 관계를 생성합니다.

kind: LDAPSyncConfig
apiVersion: v1
url: ldap://LDAP_SERVICE_IP:389
augmentedActiveDirectory:
    groupsQuery:
        baseDN: "ou=groups,dc=example,dc=com"
        scope: sub
        derefAliases: never
        pageSize: 0
    groupUIDAttribute: dn
    groupNameAttributes: [ cn ]
    usersQuery:
        baseDN: "ou=users,dc=example,dc=com"
        scope: sub
        derefAliases: never
        filter: (objectclass=person)
        pageSize: 0
    userNameAttributes: [ mail ]
    groupMembershipAttributes: [ memberOf ]

다음과 같습니다.

augmentedActiveDirectory.groupUIDAttribute
LDAP 서버에서 그룹을 고유하게 식별하는 특성을 지정합니다. groupUIDAttribute로 DN을 사용할 때는 groupsQuery 필터를 지정할 수 없습니다. 세분화된 필터링의 경우 허용 목록 파일, 거부 목록 파일 또는 둘 다를 사용합니다.
augmentedActiveDirectory.groupNameAttributes
그룹 이름으로 사용할 속성을 지정합니다.
augmentedActiveDirectory.userNameAttributes
OpenShift Container Platform 그룹 레코드에서 사용자 이름으로 사용할 속성을 지정합니다.
augmentedActiveDirectory.groupMembershipAttributes
멤버십 정보를 저장하는 사용자의 속성을 지정합니다.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동