Bitbucket.org를 OAuth 2.0 공급자로 설정하여 Bitbucket.org 계정 자격 증명으로 GitLab에 로그인할 수 있습니다. Bitbucket.org에서 프로젝트를 가져올 수도 있습니다.

• Bitbucket.org를 OmniAuth 공급자로 사용하려면 Bitbucket OmniAuth 공급자 섹션을 따르세요.
• Bitbucket에서 프로젝트를 가져오려면 Bitbucket OmniAuth 공급자와 Bitbucket 프로젝트 가져오기 섹션을 모두 따르세요.

Bitbucket을 OAuth 2.0 인증 공급자로 사용#

Bitbucket OmniAuth 공급자를 활성화하려면 Bitbucket.org에 애플리케이션을 등록해야 합니다. Bitbucket이 사용할 애플리케이션 ID와 비밀 키를 생성합니다.

1. Bitbucket.org에 로그인합니다.

2. 애플리케이션을 등록하는 방법에 따라 개인 사용자 설정(Bitbucket 설정)이나 팀 설정(팀 관리)으로 이동합니다. 애플리케이션을 개인이나 팀으로 등록하는 것은 완전히 선택 사항입니다.

3. 액세스 관리 아래 왼쪽 메뉴에서 OAuth를 선택합니다.

4. 소비자 추가를 선택합니다.

5. 필요한 세부 정보를 입력합니다:

   • 이름: 무엇이든 가능합니다. <조직>'s GitLab 또는 <이름>'s GitLab처럼 설명적인 것을 고려해 보세요.

   • 애플리케이션 설명: 선택 사항. 원하면 입력하세요.

   • 콜백 URL: (GitLab 버전 8.15 이상에서 필수) https://gitlab.example.com/users/auth와 같은 GitLab 설치 URL. 이 필드를 비워 두면 Invalid redirect_uri 메시지가 발생합니다.

     [!warning] OAuth 2 은밀한 리디렉션 공격을 방지하려면 Bitbucket 인증 콜백 URL 끝에 /users/auth를 추가하세요. Bitbucket으로 인증하고 Bitbucket 저장소에서 데이터를 가져오려면 이 인증 엔드포인트를 포함해야 합니다.

   • URL: https://gitlab.example.com과 같은 GitLab 설치 URL.

6. 최소한 다음 권한을 부여합니다:

   • 계정: Email, Read
   • 프로젝트: Read
   • 저장소: Read
   • 풀 리퀘스트: Read
   • 이슈: Read
   • 위키: Read and write

7. 저장을 선택합니다.

8. 새로 생성된 OAuth 소비자를 선택하면 OAuth 소비자 목록에 키와 시크릿이 표시됩니다. 구성을 계속하면서 이 페이지를 열어 두세요.

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

   # Omnibus 패키지의 경우
   sudo editor /etc/gitlab/gitlab.rb
   
   # 소스에서 설치한 경우
   sudo -u git -H editor /home/git/gitlab/config/gitlab.yml
   

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

    Linux 패키지 설치의 경우:

    gitlab_rails['omniauth_providers'] = [
      {
        name: "bitbucket",
        # label: "Provider name", # optional label for login button, defaults to "Bitbucket"
        app_id: "<bitbucket_app_key>",
        app_secret: "<bitbucket_app_secret>",
        url: "https://bitbucket.org/"
      }
    ]
    

    자체 컴파일 설치의 경우:

    omniauth:
      enabled: true
      providers:
        - { name: 'bitbucket',
            # label: 'Provider name', # optional label for login button, defaults to "Bitbucket"
            app_id: '<bitbucket_app_key>',
            app_secret: '<bitbucket_app_secret>',
            url: 'https://bitbucket.org/'
          }
    

    여기서 <bitbucket_app_key>는 키이고 <bitbucket_app_secret>은 Bitbucket 애플리케이션 페이지의 시크릿입니다.

11. 구성 파일을 저장합니다.

12. 변경 사항을 적용하려면 Linux 패키지를 사용하여 설치한 경우 GitLab을 재구성하거나, 자체 컴파일 설치의 경우 재시작합니다.

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

Bitbucket 프로젝트 가져오기#

이전 구성을 설정한 후 Bitbucket을 사용하여 GitLab에 로그인하고 프로젝트 가져오기를 시작할 수 있습니다.

Bitbucket에서 프로젝트를 가져오지만 로그인을 활성화하지 않으려면 관리 영역에서 로그인을 비활성화할 수 있습니다.