엔터프라이즈 사용자는 일반 GitLab 사용자와 비슷하지만 조직이 관리한다는 점이 다릅니다. 각 엔터프라이즈 사용자는 특정 최상위 그룹에 귀속되어 관리됩니다. 엔터프라이즈 사용자를 귀속시키려면 그룹 도메인을 인증하고 활성 구독이 있어야 합니다.

구독이 만료되거나 취소되면 다음과 같이 동작합니다.

• 기존 엔터프라이즈 사용자는 그룹의 엔터프라이즈 사용자로 남습니다.
• 그룹 Owner는 엔터프라이즈 사용자를 관리할 수 없습니다.
• 사용자 계정의 기본 이메일은 인증된 도메인의 주소여야 합니다.
• 구독을 갱신하기 전까지는 새 엔터프라이즈 사용자를 그룹에 연결할 수 없습니다.

그룹 도메인 관리#

GitLab.com 사용자를 엔터프라이즈 사용자로 귀속시키려면 도메인을 추가하고 소유권을 인증해야 합니다. 그룹 도메인은 최상위 그룹에 추가되며, 그룹에 속한 모든 하위 그룹과 프로젝트에 적용됩니다.

그룹마다 도메인을 여러 개 둘 수 있지만, 하나의 도메인은 한 번에 하나의 그룹에만 연결할 수 있습니다. 도메인을 다른 유료 그룹으로 옮기면 모든 엔터프라이즈 사용자가 새 그룹으로 자동 귀속됩니다.

그룹 도메인은 최상위 그룹 안의 프로젝트에 연결됩니다. 도메인을 인증하려면 연결된 프로젝트에서 GitLab Pages를 활성화해야 하지만, GitLab Pages 웹사이트를 만들거나 배포할 필요는 없습니다. GitLab.com에서는 모든 프로젝트에 GitLab Pages가 기본적으로 활성화되어 있으므로 별도 구성이 필요하지 않습니다.

도메인이 하나의 프로젝트에 연결되어 있더라도, 중첩된 모든 하위 그룹과 프로젝트를 포함한 그룹 계층 전체에서 사용할 수 있습니다. 연결된 프로젝트에서 Maintainer 또는 Owner 권한이 있는 구성원은 도메인을 수정하거나 제거할 수 있습니다. 이 프로젝트를 삭제하면 연결된 도메인도 함께 제거됩니다.

그룹 도메인에 대한 자세한 내용은 에픽 5299를 참고합니다.

그룹 도메인 추가#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 있어야 합니다.
• 인증하려는 이메일 도메인과 일치하는 사용자 지정 도메인 example.com 또는 하위 도메인 subdomain.example.com을 관리할 수 있어야 합니다.
• 소유권을 증명할 수 있도록 도메인에 DNS TXT 레코드를 만들 수 있어야 합니다.
• 최상위 그룹에 GitLab Pages를 사용하는 전용 프로젝트가 있어야 합니다.

그룹에 사용자 지정 도메인을 추가하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

2. 왼쪽 사이드바에서 Settings > Domain Verification을 선택합니다.

3. 오른쪽 위에서 Add Domain을 선택합니다.

4. 도메인 설정을 구성합니다.

   • Domain: 도메인 이름을 입력합니다.
   • Project: 그룹에 있는 기존 프로젝트를 연결합니다.
   • Certificate: 인증서 옵션을 선택합니다.

     • SSL/TLS 인증서가 없거나 사용하지 않으려면 Automatic certificate management using Let's Encrypt를 선택합니다.

     • 직접 보유한 SSL/TLS 인증서를 사용하려면 Manually enter certificate information을 선택합니다.

       [!note] 도메인 인증에 유효한 인증서가 필요하지는 않습니다. GitLab Pages를 사용하지 않는다면 자체 서명 인증서 경고는 무시해도 됩니다.

5. Add Domain을 선택합니다. GitLab이 도메인 정보를 저장합니다.

6. 도메인의 소유권을 인증합니다.

   1. TXT에서 인증 코드를 복사합니다.
   2. 도메인 공급자의 DNS 설정에서 인증 코드를 TXT 레코드로 추가합니다.
   3. GitLab의 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
   4. Settings > Domain Verification을 선택합니다.
   5. 도메인 이름 옆에서 Retry verification ([retry])을 선택합니다.

인증에 성공하면 도메인 상태가 Verified로 바뀌고 엔터프라이즈 사용자 관리에 사용할 수 있습니다.

그룹 도메인 보기#

그룹의 모든 사용자 지정 도메인을 보려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Domain Verification을 선택합니다.

그룹 도메인 편집#

그룹의 사용자 지정 도메인을 편집하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Domain Verification을 선택합니다.
3. 도메인 이름 옆에서 Edit (✏️)를 선택합니다.

이 화면에서 다음 작업을 수행할 수 있습니다.

• 사용자 지정 도메인을 확인합니다.
• 추가할 DNS 레코드를 확인합니다.
• TXT 인증 항목을 확인합니다.
• 인증을 다시 시도합니다.
• 인증서 설정을 편집합니다.

그룹 도메인 삭제#

그룹 도메인을 삭제하면 그룹의 엔터프라이즈 사용자에게 영향을 줄 수 있습니다. 도메인을 삭제한 뒤에는 다음과 같이 동작합니다.

• 기존 엔터프라이즈 사용자는 그룹의 엔터프라이즈 사용자로 남습니다.
• 다른 도메인을 인증하기 전까지는 새 엔터프라이즈 사용자를 그룹에 연결할 수 없습니다.

그룹의 사용자 지정 도메인을 삭제하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > Domain Verification을 선택합니다.
3. 도메인 이름 옆에서 Remove domain ([remove])을 선택합니다.
4. 확인 메시지가 표시되면 Delete domain을 선택합니다.

엔터프라이즈 사용자 관리#

최상위 그룹의 Owner는 일반 그룹 구성원 권한 외에도 그룹의 엔터프라이즈 사용자를 관리할 수 있습니다.

API로 엔터프라이즈 사용자를 다룰 수도 있습니다.

엔터프라이즈 사용자 자동 귀속#

사전 요구 사항:

• 최상위 그룹에서 그룹 도메인을 추가하고 인증해야 합니다.
• 사용자의 기본 이메일이 인증된 도메인과 일치해야 합니다.
• 사용자 계정이 다음 조건 중 하나 이상을 충족해야 합니다.
  • 사용자 계정이 2021년 2월 1일 이후에 생성되었습니다.
  • 사용자 계정에 조직의 그룹과 연결된 SAML 또는 SCIM ID가 있습니다.
  • 사용자 계정의 provisioned_by_group_id 속성이 그룹 ID와 일치합니다.
  • 사용자 계정이 2021년 2월 1일 이후에 구매하거나 갱신한 그룹 구독의 구성원입니다.

그룹이 도메인 소유권을 인증하면 해당 도메인의 이메일 주소를 사용하는 사용자는 엔터프라이즈 사용자로 그룹에 자동으로 귀속됩니다. 그룹 Owner가 직접 조치할 필요는 없습니다.

다른 도메인의 이메일 주소를 사용하는 기존 그룹 구성원은 기존 액세스 권한을 유지하지만 그룹 Owner가 관리할 수는 없습니다. 이러한 사용자를 귀속시키려면 해당 사용자가 기본 이메일 주소를 그룹 도메인에 맞게 변경해야 합니다.

귀속 절차는 시작되기까지 최대 4일이 걸릴 수 있습니다. 그룹 도메인을 직접 다시 인증하면 이 절차를 즉시 실행할 수 있습니다.

그룹이 엔터프라이즈 사용자를 귀속시키면 다음과 같이 동작합니다.

• 사용자가 환영 이메일을 받습니다.
• 사용자의 enterprise_group_id 속성에 그룹 ID가 추가됩니다.

엔터프라이즈 사용자 식별#

구성원 목록에서 엔터프라이즈 사용자를 식별할 수 있습니다. 모든 엔터프라이즈 사용자의 이름 옆에는 Enterprise 배지가 표시됩니다.

https://gitlab.com/groups/<group_id>/-/usage_quotas#seats-quota-tab의 청구 대상 사용자 목록을 분석하면 엔터프라이즈 사용자가 아닌 그룹 구성원을 확인할 수 있습니다.

이 목록에서 엔터프라이즈 사용자가 아닌 사용자는 다음 중 하나에 해당합니다.

• 인증되지 않은 도메인의 이메일 주소를 사용합니다.
• 이메일 주소가 표시되지 않습니다.

인증 방법 제한#

엔터프라이즈 사용자가 사용할 수 있는 인증 방법을 제한하면 사용자 측의 보안 노출 범위를 줄일 수 있습니다.

• 비밀번호 인증 비활성화.
• 개인 액세스 토큰 비활성화.
• SSH 키 비활성화.
• 이중 인증 비활성화.

개인 스니펫 제한#

엔터프라이즈 사용자가 개인 네임스페이스에 개인 스니펫을 만들지 못하도록 할 수 있습니다. 자세한 내용은 엔터프라이즈 사용자의 개인 스니펫 제한을 참고합니다.

그룹 및 프로젝트 생성 제한#

엔터프라이즈 사용자의 그룹 및 프로젝트 생성을 제한할 수 있으며, 이를 통해 다음을 정의합니다.

• 엔터프라이즈 사용자가 최상위 그룹을 만들 수 있는지 여부
• 엔터프라이즈 사용자 한 명이 만들 수 있는 개인 프로젝트의 최대 개수

이러한 제한은 SAML 응답에서 정의합니다. 자세한 내용은 SAML 응답에서 엔터프라이즈 사용자 설정 구성을 참고합니다.

프로비저닝된 사용자의 이메일 확인 건너뛰기#

기본적으로 SAML 또는 SCIM으로 프로비저닝된 사용자에게는 본인 확인을 위한 확인 이메일이 발송됩니다. 대신 사용자 지정 도메인을 구성하면 GitLab이 사용자 계정을 자동으로 확인합니다. 이 경우에도 사용자는 엔터프라이즈 사용자 환영 이메일을 받습니다.

자세한 내용은 인증된 도메인으로 사용자 이메일 확인 건너뛰기를 참고합니다.

엔터프라이즈 사용자의 이메일 주소 보기#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 있어야 합니다.

엔터프라이즈 사용자의 이메일 주소를 보려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Manage > Members를 선택합니다.
3. 엔터프라이즈 사용자의 이름 위에 마우스를 올립니다.

그룹 구성원 API와 프로젝트 구성원 API로도 사용자 정보를 확인할 수 있습니다. 그룹의 엔터프라이즈 사용자라면 이 정보에 사용자의 이메일 주소가 포함됩니다.

엔터프라이즈 사용자의 이메일 주소 변경#

엔터프라이즈 사용자는 다른 GitLab 사용자와 같은 절차로 기본 이메일 주소를 변경할 수 있습니다. 새 이메일 주소는 인증된 도메인의 주소여야 합니다. 조직에 인증된 도메인이 없으면 엔터프라이즈 사용자는 기본 이메일 주소를 변경할 수 없습니다.

그룹 Owner는 그룹 엔터프라이즈 사용자 API로 그룹의 엔터프라이즈 사용자 이메일 주소를 수정할 수 있습니다.

기본 이메일 주소를 인증되지 않은 도메인의 주소로 변경하는 작업은 GitLab 지원팀만 수행할 수 있습니다. 이 작업은 엔터프라이즈 사용자를 해제합니다.

엔터프라이즈 사용자 삭제#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 있어야 합니다.

그룹 엔터프라이즈 사용자 API로 엔터프라이즈 사용자를 삭제하고 GitLab에서 계정을 영구적으로 제거할 수 있습니다. 이 작업은 사용자에게서 엔터프라이즈 관리 기능만 제거하는 해제와는 다릅니다. 사용자를 삭제할 때는 다음 중 하나를 선택할 수 있습니다.

• 사용자와 그 사용자의 기여를 영구적으로 삭제합니다.
• 기여는 유지하고 고스트 사용자에게 이전합니다.

엔터프라이즈 사용자 해제#

엔터프라이즈 사용자 계정에서 엔터프라이즈 관리 기능을 제거할 수 있습니다. 예를 들어 사용자가 회사를 떠난 뒤에도 GitLab 계정을 유지하려는 경우에 이 작업이 필요합니다. 사용자를 해제해도 계정의 역할과 권한은 그대로 유지되지만, 그룹 Owner는 해당 사용자에 대한 관리 옵션을 잃습니다. 예를 들어 해제된 사용자는 그룹 Owner가 이전에 비활성화한 인증 방법을 사용할 수 있습니다.

계정을 영구적으로 제거해야 한다면 대신 사용자를 삭제하는 방법을 사용합니다.

개별 엔터프라이즈 사용자를 그룹에서 해제하려면 GitLab 지원팀이 해당 사용자의 기본 이메일 주소를 인증되지 않은 도메인의 주소로 변경해야 합니다. 이 작업을 수행하면 계정이 자동으로 해제됩니다.

귀속된 모든 엔터프라이즈 사용자를 해제하려면 그룹 도메인이 아니라 그룹 자체를 삭제합니다. 이 방법은 엔터프라이즈 사용자 기능을 시험해 보는 조직에 유용합니다.

그룹 Owner가 기본 이메일을 변경할 수 있도록 하는 방안은 이슈 412966에서 제안되었습니다.

휴면 엔터프라이즈 사용자 재활성화#

휴면 구성원 자동 제거가 활성화되어 있으면 휴면 엔터프라이즈 사용자는 그룹에서 제거되지 않고 비활성화됩니다. 이 사용자가 다시 로그인하면 계정이 재활성화됩니다.

다만 엔터프라이즈 그룹에 제한된 액세스가 활성화되어 있고 사용 가능한 시트가 없으면, 사용자는 재활성화되지 않고 승인 대기 상태가 됩니다. 기존 그룹 및 프로젝트 멤버십은 그대로 유지됩니다.

엔터프라이즈 사용자의 이메일 주소 숨기기#

히스토리

• GitLab 18.3에서 도입되었습니다.

그룹 Owner는 그룹의 모든 엔터프라이즈 사용자에 대해 프로필 페이지의 공개 이메일 주소를 숨길 수 있습니다. Owner는 구성원 페이지에서 이메일 주소를 확인할 수 있습니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 있어야 합니다.
• 그룹에 도메인 인증이 구성되어 있어야 합니다.

엔터프라이즈 사용자의 이메일 주소를 숨기려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Permissions and group features를 확장합니다.
4. Enterprise users에서 Hide email address from public profile 체크박스를 선택합니다.
5. Save changes를 선택합니다.

엔터프라이즈 사용자의 자체 계정 삭제 차단#

히스토리

• GitLab 19.2에서 deleting_account_disabled_for_enterprise_users라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 19.4에서 일반 공급으로 전환되었습니다. deleting_account_disabled_for_enterprise_users 기능 플래그가 제거되었습니다.

그룹 Owner는 그룹의 엔터프라이즈 사용자가 자신의 계정을 삭제하지 못하도록 막을 수 있습니다. 이 설정을 비활성화하면 엔터프라이즈 사용자는 사용자 설정에서 계정을 삭제할 수 없습니다. 계정 삭제 섹션에는 계정 삭제가 허용되지 않는다는 메시지가 표시됩니다. 그룹 Owner는 이 경우에도 엔터프라이즈 사용자를 삭제할 수 있습니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 필요합니다.
• 그룹에 도메인 인증이 구성되어 있어야 합니다.

엔터프라이즈 사용자가 자신의 계정을 삭제하지 못하도록 하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Permissions and group features를 확장합니다.
4. Enterprise users에서 Allow enterprise users to delete their own accounts 체크박스를 선택 해제합니다.
5. Save changes를 선택합니다.

엔터프라이즈 사용자를 위한 Extension Marketplace 활성화#

히스토리

• GitLab 17.4에서 web_ide_oauth와 web_ide_extensions_marketplace라는 기능 플래그와 함께 베타로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.4에서 web_ide_oauth가 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다.
• GitLab 17.4에서 web_ide_extensions_marketplace가 GitLab.com에 활성화되었습니다.
• GitLab 17.5에서 web_ide_oauth가 제거되었습니다.
• GitLab 17.10에서 vscode_extension_marketplace_settings 기능 플래그가 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.11에서 web_ide_extensions_marketplace가 GitLab Self-Managed에 활성화되었고, vscode_extension_marketplace_settings가 GitLab.com과 GitLab Self-Managed에 활성화되었습니다.
• GitLab 18.1에서 일반 공급으로 전환되었습니다. web_ide_extensions_marketplace와 vscode_extension_marketplace_settings 기능 플래그가 제거되었습니다.

VS Code Extension Marketplace는 Web IDE와 워크스페이스의 기능을 확장하는 확장 프로그램을 제공합니다. 최상위 그룹 Owner는 그룹의 엔터프라이즈 사용자가 이 마켓플레이스에 접근할 수 있는지 제어할 수 있습니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한이 있어야 합니다.

엔터프라이즈 사용자를 위해 Extension Marketplace를 활성화하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Permissions and group features를 확장합니다.
4. Enterprise users에서 Enable extension marketplace 체크박스를 선택합니다.
5. Save changes를 선택합니다.

문제 해결#

엔터프라이즈 사용자의 이중 인증을 비활성화할 수 없는 경우#

사용자에게 Enterprise 배지가 없으면 그룹 Owner는 해당 계정의 2FA를 비활성화하거나 재설정할 수 없습니다. 이 경우 Owner는 엔터프라이즈 사용자에게 사용 가능한 복구 옵션을 검토하도록 안내합니다.

관련 주제#

• GitLab Pages 사용자 지정 도메인.