LDAP 동기화

사용자 및 그룹에 대한 LDAP 동기화를 구성하고 동기화 일정을 조정하는 방법을 알아봅니다.

LDAP를 GitLab과 연동하도록 구성 했다면 GitLab 이 사용자와 그룹을 자동으로 동기화할 수 있습니다. LDAP 동기화는 LDAP ID가 할당된 기존 GitLab 사용자의 사용자 정보와 그룹 정보를 갱신합니다. LDAP를 통해 새 GitLab 사용자를 만들지는 않습니다. 동기화가 실행되는 시점은 변경할 수 있습니다. 속도 제한이 있는 LDAP 서버 # 일부 LDAP 서버에는 속도 제한이 구성되어 있습니다. GitLab은 다음 대상마다 LDAP 서버에 한 번씩 쿼리합니다. 예약된 사용자 동기화 과정의 각 사용자입니다. 예약된 그룹 동기화 과정의 각 그룹입니다. 경우에 따라 LDAP 서버로 더 많은 쿼리가 발생할 수 있습니다. 예를 들어 그룹 동기화 쿼리가 memberuid 속성을 반환 할 때입니다. LDAP 서버에 속도 제한이 구성되어 있고 다음 과정에서 그 한도에 도달하면 이렇게 동작합니다. 사용자 동기화 과정에서는 LDAP 서버가 오류 코드를 반환하고 GitLab 이 해당 사용자를 차단합니다. 그룹 동기화 과정에서는 LDAP 서버가 오류 코드를 반환하고 GitLab 이 해당 사용자의 그룹 멤버십을 제거합니다. 원치 않는 사용자 차단과 그룹 멤버십 제거를 막으려면 LDAP 동기화를 구성할 때 LDAP 서버의 속도 제한을 고려해야 합니다. 사용자 동기화 # GitLab은 하루에 한 번 워커를 실행해 GitLab 사용자를 LDAP와 대조하고 갱신합니다. 이 과정에서 다음 액세스 검사를 수행합니다. 사용자가 여전히 LDAP에 존재하는지 확인합니다. LDAP 서버가 Active Directory 라면 사용자가 활성 상태(차단·비활성 상태가 아님)인지 확인합니다. 이 검사는 LDAP 구성에 active_directory: true 가 설정된 경우에만 수행됩니다. Active Directory에서는 사용자 계정 제어 속성 ( userAccountControl:1.2.840.113556.1.4.803 )의 비트 2가 설정되면 해당 사용자가 비활성·차단 상태로 표시됩니다. 자세한 내용은 Bitmask Searches in LDAP 를 참고합니다. 이 과정에서는 다음 사용자 정보도 갱신합니다. sync_name 이 true 로 설정된 경우의 이름입니다. 이 동기화는 Prevent users from changing their profile name 이 활성화되어 있어도 수행됩니다. 이메일 주소입니다. sync_ssh_keys 가 설정된 경우의 SSH 공개 키입니다. Kerberos가 활성화된 경우의 Kerberos ID 입니다. Note LDAP 서버에 속도 제한이 있으면 사용자 동기화 과정에서 그 한도에 도달할 수 있습니다. 자세한 내용은 속도 제한 문서 를 확인합니다. LDAP 사용자의 프로필 이름 동기화 # 기본적으로 GitLab은 LDAP 사용자의 프로필 이름 필드를 동기화합니다. 이 동기화를 막으려면 sync_name 을 false 로 설정합니다. Linux package (Omnibus) Helm chart (Kubernetes) D