자체 호스팅 GitLab 인스턴스용 SAML SSO

1. GitLab이 HTTPS로 구성되었는지 확인하십시오.
2. 일반 설정을 구성하여 saml을 단일 로그온 제공자로 추가하십시오. 이는 기존 GitLab 계정이 없는 사용자를 위한 JIT(Just-In-Time) 계정 프로비저닝을 가능하게 합니다.

3. 사용자가 계정을 수동으로 만들지 않고 SAML을 사용하여 가입할 수 있도록 하려면 /etc/gitlab/gitlab.rb을 편집하십시오:

   gitlab_rails['omniauth_allow_single_sign_on'] = ['saml']
   gitlab_rails['omniauth_block_auto_created_users'] = false
   

4. 선택 사항. 사용자의 이메일 주소가 일치하는 경우 최초 SAML 로그인을 기존의 GitLab 사용자와 자동으로 연결해야 합니다. 이를 위해 /etc/gitlab/gitlab.rb에 다음 설정을 추가하십시오:

   gitlab_rails['omniauth_auto_link_saml_user'] = true
   

   GitLab 계정의 기본 이메일 주소만 SAML 응답의 이메일과 일치합니다.

   또는 사용자는 기존 사용자를 위한 OmniAuth 활성화를 통해 SAML 식별을 기존의 GitLab 계정에 수동으로 연결할 수 있습니다.

5. 다음과 같은 속성을 구성하여 SAML 사용자가 변경할 수 없도록 합니다:

   • NameID.
   • omniauth_auto_link_saml_user와 함께 사용되는 Email.

   사용자가 이러한 속성을 변경할 수 있으면, 다른 인가된 사용자로 로그인할 수 있습니다. 이러한 속성을 변경할 수 없도록하려면 SAML IdP 설명서를 참조하십시오.

6. /etc/gitlab/gitlab.rb을 편집하고 다음과 같이 제공자 구성을 추가하십시오:

   gitlab_rails['omniauth_providers'] = [
     {
       name: "saml",
       label: "Provider name", # 선택적 로그인 버튼 레이블, 기본값은 "Saml"
       args: {
         assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
         idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
         idp_sso_target_url: "https://login.example.com/idp",
         issuer: "https://gitlab.example.com",
         name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
       }
     }
   ]
   

   여기서:

   • assertion_consumer_service_url: GitLab HTTPS 엔드포인트 (GitLab 설치의 HTTPS URL에 /users/auth/saml/callback을 추가하십시오).
   • idp_cert_fingerprint: IdP 값을 입력하십시오. SHA1 지문이어야 합니다. 이러한 값에 대한 자세한 내용은 OmniAuth SAML 문서를 참조하십시오. 다른 구성 설정에 대한 자세한 내용은 IdP에서 SAML 구성을 참조하십시오.
   • idp_sso_target_url: IdP 값 입력하십시오.
   • issuer: IdP에 대응하는 고유한 이름으로 변경하십시오.
   • name_identifier_format: IdP 값 입력하십시오.

7. 파일을 저장하고 GitLab을 다시 구성하십시오:

   sudo gitlab-ctl reconfigure
   

1. GitLab이 HTTPS로 구성되었는지 확인하십시오.
2. 일반 설정을 구성하여 saml을 단일 로그온 제공자로 추가하십시오. 이는 기존 GitLab 계정이 없는 사용자를 위한 JIT(Just-In-Time) 계정 프로비저닝을 가능하게 합니다.

3. Helm 값을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. 사용자가 계정을 수동으로 만들지 않고 SAML을 사용하여 가입할 수 있도록 하려면 gitlab_values.yaml을 편집하십시오:

   global:
     appConfig:
       omniauth:
         enabled: true
         allowSingleSignOn: ["saml"]
         blockAutoCreatedUsers: false
   

5. 선택 사항. 사용자의 이메일 주소가 일치하는 경우 SAML 사용자를 기존의 GitLab 사용자와 자동으로 연결할 수 있습니다. 이를 위해 gitlab_values.yaml에 다음 설정을 추가하십시오:

   global:
     appConfig:
       omniauth:
         autoLinkSamlUser: true
   

   또는 사용자는 기존 사용자를 위한 OmniAuth 활성화를 통해 SAML 식별을 기존의 GitLab 계정에 수동으로 연결할 수 있습니다.

6. 다음과 같은 속성을 구성하여 SAML 사용자가 변경할 수 없도록 합니다:

   • NameID.
   • Email when used with omniauth_auto_link_saml_user.

   사용자가 이러한 속성을 변경할 수 있으면, 다른 인가된 사용자로 로그인할 수 있습니다. 이러한 속성을 변경할 수 없도록하려면 SAML IdP 설명서를 참조하십시오.

7. Globals.html#providers에서 사용되는 saml.yaml 파일에 다음 내용을 넣으십시오:

   name: "saml"
   label: "Provider name" # 선택적 로그인 버튼 레이블, 기본값은 "Saml"
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

   여기서:

   • assertion_consumer_service_url: GitLab HTTPS 엔드포인트 (GitLab 설치의 HTTPS URL에 /users/auth/saml/callback를 추가하십시오).
   • idp_cert_fingerprint: IdP 값을 입력하십시오. SHA1 지문이어야 합니다. 이러한 값에 대한 자세한 내용은 OmniAuth SAML 문서를 참조하십시오. 다른 구성 설정에 대한 자세한 내용은 IdP에서 SAML 구성을 참조하십시오.
   • idp_sso_target_url: IdP 값 입력하십시오.
   • issuer: IdP에 대응하는 고유한 이름으로 변경하십시오.
   • name_identifier_format: IdP 값 입력하십시오.

8. Kubernetes Secret으로 사용할 saml.yaml 파일을 만들어십시오:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

9. gitlab_values.yaml을 편집하고 다음 구성을 추가하십시오:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

10. 파일을 저장하고 새 값들을 적용하십시오:

    helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
    

1. GitLab이 HTTPS로 구성되었는지 확인하십시오.
2. 일반 설정을 구성하여 saml을 단일 로그온 제공자로 추가하십시오. 이는 기존 GitLab 계정이 없는 사용자를 위한 JIT(Just-In-Time) 계정 프로비저닝을 가능하게 합니다.

3. 사용자가 계정을 수동으로 만들지 않고 SAML을 사용하여 가입할 수 있도록 하려면 docker-compose.yml을 편집하십시오:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_allow_single_sign_on'] = ['saml']
           gitlab_rails['omniauth_block_auto_created_users'] = false
   

4. 선택 사항. 사용자의 이메일 주소가 일치하는 경우 SAML 사용자를 기존의 GitLab 사용자와 자동으로 연결할 수 있습니다. 이를 위해 docker-compose.yml에 다음 설정을 추가하십시오:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_auto_link_saml_user'] = true
   

   또는 사용자는 기존 사용자를 위한 OmniAuth 활성화를 통해 SAML 식별을 기존의 GitLab 계정에 수동으로 연결할 수 있습니다.

5. 다음과 같은 속성을 구성하여 SAML 사용자가 변경할 수 없도록 합니다:

   • NameID.
   • omniauth_auto_link_saml_user와 함께 사용되는 Email.

   사용자가 이러한 속성을 변경할 수 있으면, 다른 인가된 사용자로 로그인할 수 있습니다. 이러한 속성을 변경할 수 없도록하려면 SAML IdP 설명서를 참조하십시오.

6. docker-compose.yml을 편집하고 다음과 같이 제공자 구성을 추가하십시오:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
             {
               name: "saml",
               label: "Provider name", # 선택적 로그인 버튼 레이블, 기본값은 "Saml"
               args: {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
               }
             }
           ]
   

   여기서:

   • assertion_consumer_service_url: GitLab HTTPS 엔드포인트 (GitLab 설치의 HTTPS URL에 /users/auth/saml/callback을 추가하십시오).
   • idp_cert_fingerprint: IdP 값을 입력하십시오. SHA1 지문이어야 합니다. 이러한 값에 대한 자세한 내용은 OmniAuth SAML 문서를 참조하십시오. 다른 구성 설정에 대한 자세한 내용은 IdP에서 SAML 구성을 참조하십시오.
   • idp_sso_target_url: IdP 값 입력하십시오.
   • issuer: IdP에 대응하는 고유한 이름으로 변경하십시오.
   • name_identifier_format: IdP 값 입력하십시오.

7. 파일을 저장하고 GitLab을 다시 시작하십시오:

   docker compose up -d
   

1. GitLab이 HTTPS로 구성되었는지 확인하십시오.
2. 일반 설정을 구성하여 saml을 단일 로그온 제공자로 추가하십시오. 이는 기존 GitLab 계정이 없는 사용자를 위한 JIT(Just-In-Time) 계정 프로비저닝을 가능하게 합니다.

3. 사용자가 계정을 수동으로 만들지 않고 SAML을 사용하여 가입할 수 있도록 하려면 /home/git/gitlab/config/gitlab.yml을 편집하십시오:

   production: &base
     omniauth:
       enabled: true
       allow_single_sign_on: ["saml"]
       block_auto_created_users: false
   

4. 선택 사항. 사용자의 이메일 주소가 일치하는 경우 SAML 사용자를 기존의 GitLab 사용자와 자동으로 연결할 수 있습니다. 이를 위해 /home/git/gitlab/config/gitlab.yml에 다음 설정을 추가하십시오:

   production: &base
     omniauth:
       auto_link_saml_user: true
   

   또는 사용자는 기존 사용자를 위한 OmniAuth 활성화를 통해 SAML 식별을 기존의 GitLab 계정에 수동으로 연결할 수 있습니다.

5. 다음과 같은 속성을 구성하여 SAML 사용자가 변경할 수 없도록 합니다:

   • NameID.
   • omniauth_auto_link_saml_user와 함께 사용되는 Email.

   사용자가 이러한 속성을 변경할 수 있으면, 다른 인가된 사용자로 로그인할

SAML IdP에서 GitLab 등록

1. 발급자(issuer)에 지정된 응용 프로그램 이름을 사용하여 SAML IdP에 GitLab SP를 등록합니다.

2. IdP에 구성 정보를 제공하려면 응용 프로그램에 대한 메타데이터 URL을 작성합니다. GitLab의 메타데이터 URL을 작성하려면 GitLab 설치의 HTTPS URL에 users/auth/saml/metadata를 추가합니다. 예를 들면:

   https://gitlab.example.com/users/auth/saml/metadata
   

   IdP는 적어도 email 또는 mail을 사용하여 사용자 이메일 주소를 포함하는 클레임을 제공해야 합니다. 사용 가능한 다른 클레임에 대한 자세한 정보는 클레임 구성을 참조하세요.

3. 로그인 페이지에 일반 로그인 폼 아래에 SAML 아이콘이 표시됩니다. 아이콘을 선택하여 인증 프로세스를 시작합니다. 인증이 성공하면 GitLab으로 되돌아가서 로그인됩니다.

IdP에서 SAML 구성

IdP에서 SAML 응용 프로그램을 구성하려면 최소한 다음 정보가 필요합니다:

• 주장 소비자 서비스 URL.
• 발급자.
• NameID.
• 이메일 주소 클레임.

구성 예제는 아이덴티티 제공자 설정을 참조하세요.

IdP에 따라 추가 구성이 필요할 수 있습니다. 자세한 정보는 IdP에서 SAML 앱을 위한 추가 구성을 참조하세요.

여러 SAML IdP를 사용하도록 GitLab 구성

GitLab을 여러 SAML IdP를 사용하도록 구성할 수 있습니다. 이를 위해:

• 각 제공자에는 args와 일치하는 고유한 이름이 설정되어야 합니다.
• 제공자의 이름은 다음과 같이 사용됩니다:
  • 제공자 이름을 기반으로 한 OmniAuth 구성에서 속성에 따라 다른 버튼과 제공자를 표시합니다. 예를 들면 allowBypassTwoFactor, allowSingleSignOn, syncProfileFromProvider.
  • 각 기존 사용자에 대한 추가 식별 정보로서 연결됩니다.
• assertion_consumer_service_url이 제공자 이름과 일치해야 합니다.
• strategy_class는 제공자 이름에서 추론할 수 없기 때문에 명시적으로 설정되어야 합니다.

참고: 여러 SAML IdP를 구성하는 경우 SAML 그룹 링크가 작동하도록하려면 SAML 응답에 그룹 속성을 포함하도록 모든 SAML IdP를 구성해야 합니다. 자세한 정보는 SAML 그룹 링크를 참조하세요.

다음은 여러 SAML IdP를 설정하는 방법입니다:

::Tabs

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     {
       name: 'saml', # 다음 이름 구성 매개변수와 일치해야 합니다.
       label: 'Provider 1' # UI에서 두 개의 버튼과 제공자를 구분합니다
       args: {
               name: 'saml', # 이것은 필수이며 제공자 이름과 일치해야 합니다
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback', # URL은 제공자 이름과 일치해야 합니다
               strategy_class: 'OmniAuth::Strategies::SAML',
               ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
             },
     },
     {
       name: 'saml_2', # 다음 이름 구성 매개변수와 일치해야 합니다.
       label: 'Provider 2' # UI에서 두 개의 버튼과 제공자를 구분합니다
       args: {
               name: 'saml_2', # 이것은 필수이며 제공자 이름과 일치해야 합니다
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml_2/callback', # URL은 제공자 이름과 일치해야 합니다
               strategy_class: 'OmniAuth::Strategies::SAML',
               ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
             },
     }
   ]
   

   사용자가 두 제공자 중 하나에서 수동으로 계정을 만들 필요 없이 SAML을 사용하여 회원가입할 수 있도록 하려면 구성에 다음 값을 추가합니다:

   gitlab_rails['omniauth_allow_single_sign_on'] = ['saml', 'saml_2']
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. 첫 번째 SAML 제공자를 위한 Kubernetes Secret로 사용할 saml.yaml 파일에 다음 내용을 넣습니다:

   name: 'saml' # 적어도 하나의 제공자는 'saml'이어야 합니다
   label: 'Provider 1' # UI에서 두 개의 버튼과 제공자를 구분합니다
   args:
     name: 'saml' # 이것은 필수이며 제공자 이름과 일치해야 합니다
     assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback' # URL은 제공자 이름과 일치해야 합니다
     strategy_class: 'OmniAuth::Strategies::SAML' # 필수
     ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
   

2. 두 번째 SAML 제공자를 위한 Kubernetes Secret로 사용할 saml_2.yaml 파일에 다음 내용을 넣습니다:

   name: 'saml_2'
   label: 'Provider 2' # UI에서 두 개의 버튼과 제공자를 구분합니다
   args:
     name: 'saml_2' # 이것은 필수이며 제공자 이름과 일치해야 합니다
     assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml_2/callback' # URL은 제공자 이름과 일치해야 합니다
     strategy_class: 'OmniAuth::Strategies::SAML' # 필수
     ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
   

3. 동일한 단계를 따라 추가 SAML 제공자를 설정합니다.

4. Kubernetes Secrets를 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml \
      --from-file=saml=saml.yaml \
      --from-file=saml_2=saml_2.yaml
   

5. Helm 값을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

6. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
             key: saml
           - secret: gitlab-saml
             key: saml_2
   

   사용자가 두 제공자 중 하나에서 수동으로 계정을 만들 필요 없이 SAML을 사용하여 회원가입할 수 있도록 하려면 구성에 다음 값을 추가합니다:

   global:
     appConfig:
       omniauth:
         allowSingleSignOn: ["saml", "saml_2"]
   

7. 파일을 저장하고 새 값들을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_allow_single_sign_on'] = ['saml', 'saml1']
           gitlab_rails['omniauth_providers'] = [
             {
               name: 'saml', # 다음 이름 구성 매개변수와 일치해야 합니다.
               label: 'Provider 1' # UI에서 두 개의 버튼과 제공자를 구분합니다
               args: {
                       name: 'saml', # 이것은 필수이며 제공자 이름과 일치해야 합니다
                       assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback', # URL은 제공자 이름과 일치해야 합니다
                       strategy_class: 'OmniAuth::Strategies::SAML',
                       ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
                     },
             },
             {
               name: 'saml_2', # 다음 이름 구성 매개변수와 일치해야 합니다.
               label: 'Provider 2' # UI에서 두 개의 버튼과 제공자를 구분합니다
               args: {
                       name: 'saml_2', # 이것은 필수이며 제공자 이름과 일치해야 합니다
                       assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml_2/callback', # URL은 제공자 이름과 일치해야 합니다
                       strategy_class: 'OmniAuth::Strategies::SAML',
                       ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
                     },
             }
           ]
   

   사용자가 두 제공자 중 하나에서 수동으로 계정을 만들 필요 없이 SAML을 사용하여 회원가입할 수 있도록 하려면 구성에 다음 값을 추가합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_allow_single_sign_on'] = ['saml', 'saml_2']
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
           name: 'saml', # 다음 이름 구성 매개변수와 일치해야 합니다.
           label: 'Provider 1' # UI에서 두 개의 버튼과 제공자를 구분합니다
           args: {
             name: 'saml', # 이것은 필수이며 제공자 이름과 일치해야 합니다
             assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback', # URL은 제공자 이름과 일치해야 합니다
             strategy_class: 'OmniAuth::Strategies::SAML',
             ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
           },
         }
         - {
           name: 'saml_2', # 다음 이름 구성 매개변수와 일치해야 합니다.
           label: 'Provider 2' # UI에서 두 개의 버튼과 제공자를 구분합니다
           args: {
             name: 'saml_2', # 이것은 필수이며 제공자 이름과 일치해야 합니다
             strategy_class: 'OmniAuth::Strategies::SAML',
             assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml_2/callback', # URL은 제공자 이름과 일치해야 합니다
             ... # 단일 제공자와 유사한 필요한 모든 인수를 여기에 넣습니다
           },
         }
   

   사용자가 두 제공자 중 하나에서 수동으로 계정을 만들 필요 없이 SAML을 사용하여 회원가입할 수 있도록 하려면 구성에 다음 값을 추가합니다:

   production: &base
     omniauth:
       allow_single_sign_on: ["saml", "saml_2"]
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb을 편집합니다.:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다.:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 이름의 파일에 다음 내용을 넣어 Kubernetes Secret로 사용합니다.:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   required_groups: ["Developers", "Freelancers", "Admins", "Auditors"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes Secret을 생성합니다.:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보냅니다.:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml을 편집합니다.:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새로운 값을 적용합니다.:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml을 편집합니다.:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 재시작합니다.:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml을 편집합니다.:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             required_groups:
               ["Developers", "Freelancers", "Admins", "Auditors"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일을 저장하고 GitLab을 다시 시작합니다.:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 편집:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       external_groups: ['Freelancers'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일 저장 및 GitLab 재구성:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret로 사용:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   external_groups: ["Freelancers"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes 시크릿 생성:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보내기:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 편집:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일 저장 및 새 값 적용:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 편집:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
             { name: 'saml',
               label: 'Our SAML Provider',
               groups_attribute: 'Groups',
               external_groups: ['Freelancers'],
               args: {
                       assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                       idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                       idp_sso_target_url: 'https://login.example.com/idp',
                       issuer: 'https://gitlab.example.com',
                       name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
               }
             }
           ]
   

2. 파일 저장 및 GitLab 재시작:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 편집:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             external_groups: ["Freelancers"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일 저장 및 GitLab 재시작:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 편집:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       admin_groups: ['Admins'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일 저장 및 GitLab 재구성:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret로 사용:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   admin_groups: ["Admins"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes 시크릿 생성:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보내기:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 편집:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일 저장 및 새 값 적용:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 편집:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                admin_groups: ['Admins'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
                }
              }
           ]
   

2. 파일 저장 및 GitLab 재시작:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 편집:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             admin_groups: ["Admins"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일 저장 및 GitLab 재시작:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       auditor_groups: ['Auditors'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret로 사용합니다:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   auditor_groups: ["Auditors"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes Secret을 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새로운 값을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                auditor_groups: ['Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             auditor_groups: ["Auditors"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret로 사용합니다:

   name: "saml"
   label: "Our SAML Provider"
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes Secret을 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값들을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새로운 값을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert: '-----BEGIN CERTIFICATE-----
                 <redacted>
                 -----END CERTIFICATE-----',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret로 사용합니다:

   name: "saml"
   label: "Our SAML Provider"
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert: |
       -----BEGIN CERTIFICATE-----
       <redacted>
       -----END CERTIFICATE-----
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   

2. Kubernetes Secret을 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값들을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새로운 값을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert: '-----BEGIN CERTIFICATE-----
                          <redacted>
                          -----END CERTIFICATE-----',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent'
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert: "-----BEGIN CERTIFICATE-----
                   <redacted>
                   -----END CERTIFICATE-----",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
               },
           }
   

2. 파일을 저장하고 GitLab을 다시 시작합니다:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init를 실행 중인 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
               attribute_statements: { nickname: ['username'] }
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. 다음 내용을 saml.yaml이라는 파일에 넣어 Kubernetes Secret로 사용하도록 합니다:

   name: "saml"
   label: "Our SAML Provider"
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
     attribute_statements:
       nickname: ["username"]
   

2. Kubernetes Secret을 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새 값들을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
                        attribute_statements: { nickname: ['username'] }
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             required_groups:
               ["Developers", "Freelancers", "Admins", "Auditors"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
                 attribute_statements: { nickname: ["username"] },
               },
           }
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   # systemd를 사용하는 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 사용하는 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일을 편집합니다:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
               allowed_clock_drift: 1  # 1초의 클럭 드리프트를 위해
       }
     }
   ]
   

2. 파일을 저장하고 GitLab을 다시 구성합니다:

   sudo gitlab-ctl reconfigure
   

1. 다음 내용을 saml.yaml이라는 파일에 넣어 Kubernetes Secret로 사용하도록 합니다:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   required_groups: ["Developers", "Freelancers", "Admins", "Auditors"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
     allowed_clock_drift: 1 # 1초의 클럭 드리프트를 위해
   

2. Kubernetes Secret을 생성합니다:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값을 내보냅니다:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 파일을 편집합니다:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일을 저장하고 새 값들을 적용합니다:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일을 편집합니다:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
                        allowed_clock_drift: 1  # 1초의 클럭 드리프트를 위해
                }
              }
           ]
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             required_groups:
               ["Developers", "Freelancers", "Admins", "Auditors"],
             args: {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
                 allowed_clock_drift: 1, # 1초의 클럭 드리프트를 위해
               },
           }
   

2. 파일을 저장하고 GitLab을 재시작합니다:

   # systemd를 사용하는 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 사용하는 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일 편집:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
               uid_attribute: 'uid'
       }
     }
   ]
   

2. 파일 저장 및 GitLab 재구성:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret으로 사용:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   required_groups: ["Developers", "Freelancers", "Admins", "Auditors"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
     uid_attribute: "uid"
   

2. Kubernetes Secret 생성:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값 내보내기:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 편집:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일 저장 및 새 값 적용:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일 편집:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
                        uid_attribute: 'uid'
                }
              }
           ]
   

2. 파일 저장 및 GitLab 재시작:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일 편집:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             required_groups:
               ["Developers", "Freelancers", "Admins", "Auditors"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
                 uid_attribute: "uid",
               },
           }
   

2. 파일 저장 및 GitLab 재시작:

   # systemd를 사용하는 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 사용하는 시스템의 경우
   sudo service gitlab restart
   

1. /etc/gitlab/gitlab.rb 파일 편집:

   gitlab_rails['omniauth_providers'] = [
     { name: 'saml',
       label: 'Our SAML Provider',
       groups_attribute: 'Groups',
       required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
       args: {
               assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
               idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
               idp_sso_target_url: 'https://login.example.com/idp',
               issuer: 'https://gitlab.example.com',
               name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
               certificate: '-----BEGIN CERTIFICATE-----\n<redacted>\n-----END CERTIFICATE-----',
               private_key: '-----BEGIN PRIVATE KEY-----\n<redacted>\n-----END PRIVATE KEY-----'
       }
     }
   ]
   

2. 파일 저장 및 GitLab 재구성:

   sudo gitlab-ctl reconfigure
   

1. saml.yaml이라는 파일에 다음 내용을 넣어 Kubernetes Secret으로 사용:

   name: "saml"
   label: "Our SAML Provider"
   groups_attribute: "Groups"
   required_groups: ["Developers", "Freelancers", "Admins", "Auditors"]
   args:
     assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback"
     idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8"
     idp_sso_target_url: "https://login.example.com/idp"
     issuer: "https://gitlab.example.com"
     name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
     certificate: '-----BEGIN CERTIFICATE-----\n<redacted>\n-----END CERTIFICATE-----'
     private_key: '-----BEGIN PRIVATE KEY-----\n<redacted>\n-----END PRIVATE KEY-----'
   

2. Kubernetes Secret 생성:

   kubectl create secret generic -n <namespace> gitlab-saml --from-file=provider=saml.yaml
   

3. Helm 값 내보내기:

   helm get values gitlab > gitlab_values.yaml
   

4. gitlab_values.yaml 편집:

   global:
     appConfig:
       omniauth:
         providers:
           - secret: gitlab-saml
   

5. 파일 저장 및 새 값 적용:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. docker-compose.yml 파일 편집:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_providers'] = [
              { name: 'saml',
                label: 'Our SAML Provider',
                groups_attribute: 'Groups',
                required_groups: ['Developers', 'Freelancers', 'Admins', 'Auditors'],
                args: {
                        assertion_consumer_service_url: 'https://gitlab.example.com/users/auth/saml/callback',
                        idp_cert_fingerprint: '43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8',
                        idp_sso_target_url: 'https://login.example.com/idp',
                        issuer: 'https://gitlab.example.com',
                        name_identifier_format: 'urn:oasis:names:tc:SAML:2.0:nameid-format:persistent',
                        certificate: '-----BEGIN CERTIFICATE-----\n<redacted>\n-----END CERTIFICATE-----',
                        private_key: '-----BEGIN PRIVATE KEY-----\n<redacted>\n-----END PRIVATE KEY-----'
                }
              }
           ]
   

2. 파일 저장 및 GitLab 재시작:

   docker compose up -d
   

1. /home/git/gitlab/config/gitlab.yml 파일 편집:

   production: &base
     omniauth:
       providers:
         - {
             name: "saml",
             label: "Our SAML Provider",
             groups_attribute: "Groups",
             required_groups:
               ["Developers", "Freelancers", "Admins", "Auditors"],
             args:
               {
                 assertion_consumer_service_url: "https://gitlab.example.com/users/auth/saml/callback",
                 idp_cert_fingerprint: "43:51:43:a1:b5:fc:8b:b7:0a:3a:a9:b1:0f:66:73:a8",
                 idp_sso_target_url: "https://login.example.com/idp",
                 issuer: "https://gitlab.example.com",
                 name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent",
                 certificate: '-----BEGIN CERTIFICATE-----\n<redacted>\n-----END CERTIFICATE-----',
                 private_key: '-----BEGIN PRIVATE KEY-----\n<redacted>\n-----END PRIVATE KEY-----',
               },
           }
   

2. 파일 저장 및 GitLab 재시작:

   # systemd를 사용하는 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 사용하는 시스템의 경우
   sudo service gitlab restart
   

1. GitLab이 HTTPS로 구성되었는지 확인하세요.

2. OmniAuth 및 group_saml 프로바이더를 활성화하도록 /etc/gitlab/gitlab.rb를 편집하세요:

   gitlab_rails['omniauth_enabled'] = true
   gitlab_rails['omniauth_providers'] = [{ name: 'group_saml' }]
   

3. 파일을 저장하고 GitLab을 다시 구성하세요:

   sudo gitlab-ctl reconfigure
   

1. GitLab이 HTTPS로 구성되었는지 확인하세요.

2. group_saml.yaml이라는 이름의 파일에 다음 내용을 넣어 Kubernetes 시크릿으로 사용하세요:

   name: "group_saml"
   

3. Kubernetes 시크릿을 생성하세요:

   kubectl create secret generic -n <namespace> gitlab-group-saml --from-file=provider=group_saml.yaml
   

4. Helm 값을 내보내세요:

   helm get values gitlab > gitlab_values.yaml
   

5. gitlab_values.yaml를 편집하여 OmniAuth 및 group_saml 프로바이더를 활성화하세요:

   global:
     appConfig:
       omniauth:
         enabled: true
         providers:
           - secret: gitlab-group-saml
   

6. 파일을 저장하고 새 값들을 적용하세요:

   helm upgrade -f gitlab_values.yaml gitlab gitlab/gitlab
   

1. GitLab이 HTTPS로 구성되었는지 확인하세요.

2. docker-compose.yml을 편집하여 OmniAuth 및 group_saml 프로바이더를 활성화하세요:

   version: "3.6"
   services:
     gitlab:
       environment:
         GITLAB_OMNIBUS_CONFIG: |
           gitlab_rails['omniauth_enabled'] = true
           gitlab_rails['omniauth_providers'] = [{ name: 'group_saml' }]
   

3. 파일을 저장하고 GitLab을 다시 시작하세요:

   docker compose up -d
   

1. GitLab이 HTTPS로 구성되었는지 확인하세요.

2. /home/git/gitlab/config/gitlab.yml을 편집하여 OmniAuth 및 group_saml 프로바이더를 활성화하세요:

   production: &base
     omniauth:
       enabled: true
       providers:
         - { name: "group_saml" }
   

3. 파일을 저장하고 GitLab을 다시 시작하세요:

   # systemd를 실행 중인 시스템의 경우
   sudo systemctl restart gitlab.target
   
   # SysV init을 실행 중인 시스템의 경우
   sudo service gitlab restart