셀프 호스티드 Google OAuth 2.0 클라이언트 생성 방법

Bencher Cloud를 사용 중이라면 Google 버튼으로 간단히 회원가입 또는 로그인할 수 있습니다.

Bencher Self-Hosted의 경우 Bencher Plus Enterprise 플랜을 보유하고, 직접 Google OAuth2 클라이언트를 생성한 뒤, 콘솔 서버 구성 및 API 서버 구성을 업데이트해야 합니다.

Google OAuth 2.0 클라이언트 생성

• Google API 콘솔에 가입합니다.
• 왼쪽 사이드바에서 Credentials 페이지로 이동합니다.
• OAuth 2.0 Client ID를 생성합니다.
  • ➕ Create Credentials > OAuth client ID 클릭
  • 동의 화면(Consent screen) 구성
    • 시작하기
      • 앱 정보(App Information)
        • 앱 이름
          • 이름 선택 (예: Bencher for My Enterprise)
        • 사용자 지원 이메일
          • 이메일 주소 선택
      • 대상(Audience)
        • Internal
          • 조직 내부 사용자에게만 제공됩니다. 앱 검증을 제출할 필요가 없습니다.
      • 연락처 정보(Contact Information)
        • 이메일 주소 추가
          • Google이 프로젝트 변경 사항을 알리기 위해 사용하는 이메일 주소입니다.
      • 완료
        • Google API Services User Data Policy에 동의
  • Create OAuth Client 클릭
    • Application type
      • Web application 선택
      • Name
        • 이름 선택 (예: Bencher for My Enterprise)
    • Authorized JavaScript origins
      • Bencher Console URL 입력 (예: https://bencher.example.com)
    • Authorized redirect URIs
      • Bencher Console URL에 /auth/google를 덧붙여 입력 (예: https://bencher.example.com/auth/google)
    • Create 클릭
  • OAuth 클라이언트 생성 완료
    • Client ID를 기록해 둡니다 (예: 012345-abcd6789envs.apps.googleusercontent.com)
    • Client Secret를 기록해 둡니다 (예: GOCSPX-abcdefgh1234567890wxyz)
    • OK 클릭

🐰 사용되지 않는 Google OAuth 클라이언트는 6개월 동안 사용되지 않으면 삭제될 수 있습니다. Google이 비활성으로 인한 삭제를 통지하며, 삭제 후 최대 30일 이내에는 클라이언트를 복원할 수 있습니다.

Google OAuth 클라이언트 구성

콘솔 UI

bencher-console Docker 이미지를 실행할 때 OAUTH_GOOGLE 환경 변수를 true로 설정하세요. (예: OAUTH_GOOGLE=true) Client ID가 없으면 UI에 Google 버튼이 표시되지 않습니다.

API 서버

client_id와 client_secret를 server config의 plus.google 섹션에 추가하세요. Google 섹션이 없으면 서버는 모든 Google 인증 요청을 실패 처리합니다.

🐰 축하합니다! Google OAuth2 클라이언트 설정 방법을 배웠습니다! 🎉

Bencher를 GitHub Actions에 추가 ➡