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 검색 범위 | 설명 |
|---|---|
|
| 쿼리의 기본 DN에 의해 지정된 오브젝트만 고려합니다. |
|
| 쿼리의 기본 DN과 동일한 수준의 트리에 있는 모든 오브젝트를 고려합니다. |
|
| 쿼리에 대해 제공된 기본 DN을 기반으로 하는 전체 하위 트리를 고려합니다. |
| 역참조 행동 | 설명 |
|---|---|
|
| LDAP 트리에 있는 별칭을 역참조하지 않도록 합니다. |
|
| 검색하는 동안 역참조 별칭만 발견되었습니다. |
|
| 기본 오브젝트를 찾는 동안 별칭만 역참조합니다. |
|
| 항상 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- 멤버십 정보를 저장하는 사용자의 속성을 지정합니다.