Auth0 OmniAuth 공급자를 활성화하려면 Auth0 계정과 애플리케이션을 만들어야 합니다.

1. Auth0 Console에 로그인합니다. 동일한 링크를 사용하여 계정을 만들 수도 있습니다.

2. New App/API를 선택합니다.

3. Application Name을 입력합니다. 예를 들어 'GitLab'.

4. 애플리케이션을 만든 후 Quick Start 옵션이 표시됩니다. 이 옵션을 무시하고 대신 Settings를 선택합니다.

5. Settings 화면 상단에서 Auth0 Console의 Domain, Client ID 및 Client Secret를 볼 수 있습니다. 나중에 구성 파일을 완성하기 위해 이 설정을 메모하세요. 예를 들어:

   • Domain: test1234.auth0.com
   • Client ID: t6X8L2465bNePWLOvt9yi41i
   • Client Secret: KbveM3nqfjwCbrhaUy_gDu2dss8TIlHIdzlyf33pB7dEK5u_NyQdp65O_o02hXs2

6. Allowed Callback URLs를 입력합니다:

   • http://<your_gitlab_url>/users/auth/auth0/callback (또는)
   • https://<your_gitlab_url>/users/auth/auth0/callback

7. **Allowed Origins (CORS)**를 입력합니다:

   • http://<your_gitlab_url> (또는)
   • https://<your_gitlab_url>

8. GitLab 서버에서 구성 파일을 엽니다.

   Linux 패키지 설치의 경우:

   sudo editor /etc/gitlab/gitlab.rb
   

   자체 컴파일 설치의 경우:

   cd /home/git/gitlab
   sudo -u git -H editor config/gitlab.yml
   

9. auth0을 싱글 사인온 공급자로 추가하기 위해 공통 설정을 구성합니다. 이렇게 하면 기존 GitLab 계정이 없는 사용자에 대한 Just-In-Time 계정 프로비저닝이 활성화됩니다.

10. 공급자 구성을 추가합니다:

    Linux 패키지 설치의 경우:

    gitlab_rails['omniauth_providers'] = [
      {
        name: "auth0",
        # label: "Provider name", # optional label for login button, defaults to "Auth0"
        args: {
          client_id: "<your_auth0_client_id>",
          client_secret: "<your_auth0_client_secret>",
          domain: "<your_auth0_domain>",
          scope: "openid profile email"
        }
      }
    ]
    

    자체 컴파일 설치의 경우:

    - { name: 'auth0',
        # label: 'Provider name', # optional label for login button, defaults to "Auth0"
        args: {
          client_id: '<your_auth0_client_id>',
          client_secret: '<your_auth0_client_secret>',
          domain: '<your_auth0_domain>',
          scope: 'openid profile email' }
      }
    

11. <your_auth0_client_id>를 Auth0 Console 페이지의 클라이언트 ID로 바꿉니다.

12. <your_auth0_client_secret>을 Auth0 Console 페이지의 클라이언트 시크릿으로 바꿉니다.

13. <your_auth0_domain>을 Auth0 Console 페이지의 도메인으로 바꿉니다.

14. 설치 방법에 따라 GitLab을 재구성하거나 재시작합니다:

    • Linux 패키지를 사용하여 설치한 경우 GitLab을 재구성합니다.
    • 자체 컴파일로 설치한 경우 GitLab을 재시작합니다.

로그인 페이지에 일반 로그인 양식 아래에 Auth0 아이콘이 표시됩니다. 아이콘을 선택하여 인증 프로세스를 시작합니다. Auth0은 사용자에게 로그인하고 GitLab 애플리케이션을 승인할 것을 요청합니다. 사용자가 성공적으로 인증하면 GitLab으로 돌아가 로그인됩니다.