새 사용자 계정 제한
GitLab v19.5Offering: GitLab Self-Managed, GitLab Dedicated
요약
새 사용자 계정에 다음 제한을 적용할 수 있습니다. 관리자 액세스 권한이 있어야 합니다. 기본적으로 GitLab 도메인에 방문하는 모든 사용자가 계정을 만들 수 있습니다. 새 계정 생성을 차단하려면 다음 단계를 따릅니다.
새 사용자 계정에 다음 제한을 적용할 수 있습니다.
- 계정 생성을 차단합니다.
- 새 계정에 관리자 승인을 요구합니다.
- 사용자 이메일 확인을 요구합니다.
- 특정 이메일 도메인을 사용하는 새 계정을 허용하거나 거부합니다.
사전 요구 사항#
관리자 액세스 권한이 있어야 합니다.
새 사용자 계정 생성 비활성화#
기본적으로 GitLab 도메인에 방문하는 모든 사용자가 계정을 만들 수 있습니다. 외부에 공개된 GitLab 인스턴스를 운영하는 고객이라면, 일반 사용자의 계정 생성을 예상하지 않는 경우 새 계정 생성을 비활성화하기를 적극 권장합니다. GitLab Dedicated에서는 인스턴스가 프로비저닝될 때 새 계정 생성이 기본적으로 차단됩니다.
새 계정 생성을 차단하려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- Allow new user accounts 체크박스를 해제한 다음 Save changes를 선택합니다.
Rails 콘솔에서 다음 명령을 실행해 새 사용자 계정을 차단할 수도 있습니다.
::Gitlab::CurrentSettings.update!(signup_enabled: false)
새 사용자 계정에 관리자 승인 요구#
이 설정은 새 GitLab 인스턴스에서 기본적으로 활성화되어 있습니다. 이 설정이 활성화되어 있으면 GitLab 도메인에 방문해 등록 양식으로 새 계정을 만드는 모든 사용자는 관리자의 명시적 승인을 받아야 계정을 사용할 수 있습니다. 사용자 계정 생성이 허용된 경우에만 적용됩니다.
새 사용자 계정에 관리자 승인을 요구하려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- Require admin approval for new user accounts 체크박스를 선택한 다음 Save changes를 선택합니다.
관리자가 이 설정을 비활성화하면 승인 대기 상태인 사용자는 백그라운드 job에서 자동으로 승인됩니다.
이 설정은 LDAP 또는 OmniAuth 사용자에게는 적용되지 않습니다. OmniAuth 나 LDAP로 가입하는
새 사용자에게 승인을 적용하려면 OmniAuth 구성 또는
LDAP 구성에서 block_auto_created_users를
true로 설정합니다.
사용자 상한으로도 새 사용자에게 승인을 적용할 수 있습니다.
사용자 이메일 확인#
계정 생성 시 확인 이메일을 보내고, 사용자가 로그인하기 전에 이메일 주소를 확인하도록 요구할 수 있습니다.
새 계정에 사용된 이메일 주소의 확인을 강제하려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- Email confirmation settings에서 Hard를 선택합니다.
사용할 수 있는 설정은 다음과 같습니다.
- Hard - 계정 생성 시 확인 이메일을 보냅니다. 새 사용자는 이메일 주소를 확인해야 로그인할 수 있습니다.
- Soft - 계정 생성 시 확인 이메일을 보냅니다. 새 사용자는 즉시 로그인할 수 있지만 3일 안에 이메일을 확인해야 합니다. 3일이 지나면 이메일을 확인할 때까지 로그인할 수 없습니다.
- Off - 새 사용자는 이메일 주소를 확인하지 않고 로그인할 수 있습니다.
제한된 접근 켜기#
사전 요구 사항:
- 관리자여야 합니다.
- 해당 그룹이나 그 하위 그룹 또는 프로젝트가 외부에 공유되어 있지 않아야 합니다.
제한된 접근을 켜려면 다음 단계를 따릅니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- Seat control에서 Restricted access를 선택합니다.
사용자 상한 설정#
사전 요구 사항:
- 관리자여야 합니다.
사용자 상한을 설정하려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- User cap 필드에 숫자를 입력하거나, 제한을 두지 않으려면 비워 둡니다.
- Save changes를 선택합니다.
사용자 상한 제거#
관리자 승인 없이 계정을 만들 수 있는 새 사용자 수에 제한을 두지 않으려면 사용자 상한을 제거합니다.
사용자 상한을 제거하면 승인 대기 중인 사용자가 자동으로 승인됩니다.
사전 요구 사항:
- 관리자여야 합니다.
사용자 상한을 제거하려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- User cap에서 숫자를 지웁니다.
- Save changes를 선택합니다.
비밀번호 복잡도 요구 사항 수정#
기본적으로 사용자 비밀번호에는 제한된 수의 요구 사항이 적용됩니다. 최소 길이를 늘리거나 특정 문자 유형을 요구하도록 요구 사항을 수정할 수 있습니다.
비밀번호 요구 사항을 변경해도 기존 사용자 비밀번호에는 영향이 없습니다. 수정된 복잡도 요구 사항은 다음 경우에만 적용됩니다.
- 새 사용자가 계정을 만들 때.
- 기존 사용자가 비밀번호를 재설정할 때.
비밀번호 복잡도 요구 사항을 수정하려면 다음 단계를 따릅니다.
-
오른쪽 상단에서 Admin을 선택합니다.
-
왼쪽 사이드바에서 Settings > General을 선택합니다.
-
New user account restrictions를 확장합니다.
-
복잡도 요구 사항을 수정합니다.
설정 설명 Minimum password length 필요한 최소 문자 수를 설정합니다. 8자 미만이나 128자 초과로는 설정할 수 없습니다. Require numbers 비밀번호에 숫자(0-9)를 최소 하나 포함하도록 요구합니다. Premium 및 Ultimate 전용입니다. Require uppercase letters 비밀번호에 대문자(A-Z)를 최소 하나 포함하도록 요구합니다. Premium 및 Ultimate 전용입니다. Require lowercase letters 비밀번호에 소문자(a-z)를 최소 하나 포함하도록 요구합니다. Premium 및 Ultimate 전용입니다. Require symbols 비밀번호에 기호를 최소 하나 포함하도록 요구합니다. Premium 및 Ultimate 전용입니다. -
Save changes를 선택합니다.
특정 이메일 도메인을 사용한 계정 생성 허용 또는 거부#
새 사용자 계정에 사용할 수 있는 이메일 도메인을 허용 목록 또는 거부 목록으로 지정할 수 있습니다.
이 제한은 외부 사용자가 새 계정을 만들 때만 적용됩니다. 관리자는 관리자 패널에서 허용되지 않은 도메인으로도 사용자를 추가할 수 있습니다. 또한 사용자는 계정을 만든 뒤 이메일 주소를 허용되지 않은 도메인으로 변경할 수 있습니다.
이메일 도메인 허용 목록#
지정한 도메인 목록과 일치하는 이메일 주소로만 사용자 계정을 만들도록 제한할 수 있습니다.
이메일 도메인 거부 목록#
특정 도메인의 이메일 주소로 가입하는 것을 차단할 수 있습니다. 이렇게 하면 악의적인 사용자가 일회용 이메일 주소로 스팸 계정을 만드는 위험을 줄일 수 있습니다.
이메일 도메인 허용 목록 또는 거부 목록 생성#
이메일 도메인 허용 목록이나 거부 목록을 만들려면 다음 단계를 따릅니다.
-
오른쪽 상단에서 Admin을 선택합니다.
-
왼쪽 사이드바에서 Settings > General을 선택합니다.
-
New user account restrictions를 확장합니다.
-
허용 목록은 직접 입력해야 합니다. 거부 목록은 직접 입력하거나 목록 항목이 담긴
.txt파일을 업로드할 수 있습니다.허용 목록과 거부 목록 모두 와일드카드를 지원합니다. 예를 들어
*.company.com으로 모든company.com하위 도메인을 허용하거나,*.io로.io로 끝나는 모든 도메인을 차단할 수 있습니다. 도메인은 공백, 세미콜론, 쉼표 또는 줄 바꿈으로 구분합니다.
LDAP 사용자 필터 설정#
LDAP 서버에 있는 LDAP 사용자 중 일부에게만 GitLab 접근을 허용할 수 있습니다.
자세한 내용은 LDAP 사용자 필터 설정 문서를 참고합니다.
역할 승격에 대한 관리자 승인 켜기#
히스토리
- GitLab 16.9에서
member_promotion_management라는 기능 플래그와 함께 도입되었습니다. - GitLab 17.5에서 기능 플래그
member_promotion_management가wip에서beta로 변경되고 기본적으로 활성화되었습니다. - GitLab 18.0에서 기능 플래그
member_promotion_management가 제거되었습니다.
기존 사용자가 프로젝트나 그룹에서 과금 대상 역할로 승격되는 것을 막으려면 역할 승격에 대한 관리자 승인을 켭니다. 그러면 관리자 승인 대기 중인 승격 요청을 승인하거나 거부할 수 있습니다.
- 관리자가 사용자를 그룹이나 프로젝트에 추가하는 경우:
- 새 사용자 역할이 과금 대상이면 해당 사용자의 다른 모든 멤버십 요청이 자동으로 승인됩니다.
- 새 사용자 역할이 과금 대상이 아니면 해당 사용자의 다른 요청은 관리자 승인이 있을 때까지 대기 상태로 남습니다.
- 관리자가 아닌 사용자가 다른 사용자를 그룹이나 프로젝트에 추가하는 경우:
- 해당 사용자가 어떤 그룹이나 프로젝트에서도 과금 대상 역할이 없는 상태에서 과금 대상 역할로 추가되거나 승격되면, 그 요청은 관리자 승인이 있을 때까지 대기 상태로 남습니다.
- 해당 사용자가 이미 과금 대상 역할을 가지고 있다면 관리자 승인이 필요하지 않습니다.
사전 요구 사항:
- 관리자여야 합니다.
역할 승격 승인을 켜려면 다음 단계를 따릅니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > General을 선택합니다.
- New user account restrictions를 확장합니다.
- Seat control 섹션에서 Approve role promotions를 선택합니다.
이 승인 요건은 LDAP 동기화나 SAML 그룹 링크로 부여된 멤버십에는 적용되지 않습니다. LDAP 나 SAML로 역할 승격을 받은 사용자는 이전에 과금 대상 역할을 가지고 있었는지와 무관하게 관리자 승인이 필요하지 않습니다.