LDAP Rake 작업

Tier: Free, Premium, Ultimate Offering: Self-managed

다음은 LDAP 관련 Rake 작업입니다.

확인

LDAP 확인 Rake 작업은 bind_dn 및 password 자격 증명을 테스트하고
(구성된 경우) LDAP 사용자의 샘플을 나열합니다. 이 작업은 또한
gitlab:check 작업의 일부로 실행되지만, 아래의 명령을 사용하여 독립적으로 실행할 수 있습니다.

  • 리눅스 패키지 설치:

    sudo gitlab-rake gitlab:ldap:check

  • 셀프 컴파일 설치:

    sudo -u git -H bundle exec rake gitlab:ldap:check RAILS_ENV=production

기본적으로 이 작업은 100명의 LDAP 사용자의 샘플을 반환합니다.
이 한계를 변경하려면 확인 작업에 숫자를 전달하세요:

rake gitlab:ldap:check[50]

그룹 동기화 실행

Tier: Premium, Ultimate Offering: Self-managed

다음 작업은 그룹 동기화를 즉시 실행합니다.
이는 다음 예약된 그룹 동기화가 실행될 때까지 기다리지 않고
구성된 모든 그룹 멤버십을 LDAP에 대해 업데이트하고 싶을 때 유용합니다.

note
그룹 동기화를 수행하는 빈도를 변경하려면,
크론 일정 조정하세요.

  • 리눅스 패키지 설치:

    sudo gitlab-rake gitlab:ldap:group_sync

  • 셀프 컴파일 설치:

    bundle exec rake gitlab:ldap:group_sync

공급자 이름 바꾸기

gitlab.yml 또는 gitlab.rb에서 LDAP 서버 ID를 변경하면
모든 사용자 ID를 업데이트해야 하며, 그렇지 않으면 사용자가 로그인을 할 수 없습니다.
이전 및 새로운 공급자를 입력하고 이 작업이 데이터베이스의
모든 일치하는 ID를 업데이트합니다.

old_provider 및 new_provider는 접두사 ldap와
구성 파일에서의 LDAP 서버 ID로부터 파생됩니다. 예를 들어, gitlab.yml 또는
gitlab.rb에서 LDAP 구성을 다음과 같이 볼 수 있습니다:

main:
  label: 'LDAP'
  host: '_your_ldap_server'
  port: 389
  uid: 'sAMAccountName'
  ...

main이 LDAP 서버 ID입니다. 함께, 고유한 공급자는 ldapmain입니다.

caution
잘못된 새로운 공급자를 입력하면 사용자가 로그인할 수 없습니다.
이 경우, 잘못된 공급자를 old_provider로,
올바른 공급자를 new_provider로 하여 작업을 다시 실행하세요.

  • 리눅스 패키지 설치:

    sudo gitlab-rake gitlab:ldap:rename_provider[old_provider,new_provider]

  • 셀프 컴파일 설치:

    bundle exec rake gitlab:ldap:rename_provider[old_provider,new_provider] RAILS_ENV=production

예시

기본 서버 ID main (전체 공급자 ldapmain)으로 시작한다고 가정하세요.
main을 mycompany로 변경하면, new_provider는 ldapmycompany가 됩니다.
모든 사용자 ID의 이름을 변경하려면 다음 명령을 실행하세요:

sudo gitlab-rake gitlab:ldap:rename_provider[ldapmain,ldapmycompany]

예시 출력:

100 users with provider 'ldapmain' will be updated to 'ldapmycompany'.
If the new provider is incorrect, users will be unable to sign in.
Do you want to continue (yes/no)? yes

User identities were successfully updated

기타 옵션

old_provider와 new_provider를 지정하지 않으면 작업이 해당 값을 입력하라고 요청합니다:

  • Linux 패키지 설치:

    sudo gitlab-rake gitlab:ldap:rename_provider

  • 셀프 컴파일 설치:

    bundle exec rake gitlab:ldap:rename_provider RAILS_ENV=production

예시 출력:

과거 제공자는 무엇인가요? 예: 'ldapmain': ldapmain
새 제공자는 무엇인가요? 예: 'ldapcustom': ldapmycompany

이 작업은 force 환경 변수를 허용하며, 이는 확인 대화를 건너뜁니다:

sudo gitlab-rake gitlab:ldap:rename_provider[old_provider,new_provider] force=yes

비밀

GitLab은 LDAP 구성 비밀을 사용하여 암호화된 파일에서 읽을 수 있습니다.

암호화된 파일의 내용을 업데이트하기 위해 다음 Rake 작업이 제공됩니다.

비밀 표시

현재 LDAP 비밀의 내용을 표시합니다.

  • Linux 패키지 설치:

    sudo gitlab-rake gitlab:ldap:secret:show

  • 셀프 컴파일 설치:

    bundle exec rake gitlab:ldap:secret:show RAILS_ENV=production

예시 출력:

main:
  password: '123'
  bind_dn: 'gitlab-adm'

비밀 편집

편집기에서 비밀 내용을 열고, 종료 시 결과 내용을 암호화된 비밀 파일에 작성합니다.

  • Linux 패키지 설치:

    sudo gitlab-rake gitlab:ldap:secret:edit EDITOR=vim

  • 셀프 컴파일 설치:

    bundle exec rake gitlab:ldap:secret:edit RAILS_ENV=production EDITOR=vim

원시 비밀 쓰기

STDIN을 통해 새로운 비밀 내용을 제공하여 작성합니다.

  • Linux 패키지 설치:

    echo -e "main:\n  password: '123'" | sudo gitlab-rake gitlab:ldap:secret:write

  • 셀프 컴파일 설치:

    echo -e "main:\n  password: '123'" | bundle exec rake gitlab:ldap:secret:write RAILS_ENV=production

비밀 예시

편집기 예시

쓰기 작업은 편집기와 함께 편집 명령이 작동하지 않는 경우에 사용할 수 있습니다:

# 기존 비밀을 평문 파일로 작성합니다
sudo gitlab-rake gitlab:ldap:secret:show > ldap.yaml
# 편집기에서 ldap 파일을 편집합니다
...
# 파일을 재암호화합니다
cat ldap.yaml | sudo gitlab-rake gitlab:ldap:secret:write
# 평문 파일을 제거합니다
rm ldap.yaml

KMS 통합 예시

KMS로 암호화된 콘텐츠를 수신하는 애플리케이션으로도 사용할 수 있습니다:

gcloud kms decrypt --key my-key --keyring my-test-kms --plaintext-file=- --ciphertext-file=my-file --location=us-west1 | sudo gitlab-rake gitlab:ldap:secret:write

Google Cloud 비밀 통합 예시

Google Cloud의 비밀을 수신하는 애플리케이션으로도 사용할 수 있습니다:

gcloud secrets versions access latest --secret="my-test-secret" > $1 | sudo gitlab-rake gitlab:ldap:secret:write