GitLab 소셜 로그인을 설정하세요 (Set up social login with GitLab)
GitLab 소셜 로그인을 위한 공식 Logto 커넥터입니다. GitLab을 OAuth 2.0 인증 아이덴티티 제공자 (IdP)로 사용하세요.
이 가이드는 Logto 커넥터에 대한 기본적인 이해를 전제로 합니다. 익숙하지 않은 분들은 커넥터 가이드를 참조하여 시작하세요.
시작하기
GitLab 커넥터를 사용하면 최종 사용자가 GitLab OAuth 2.0 인증 프로토콜을 통해 자신의 GitLab 계정으로 애플리케이션에 로그인할 수 있습니다.
GitLab 계정으로 로그인하기
GitLab 웹사이트에 접속하여 GitLab 계정으로 로그인하세요. 계정이 없다면 새로 등록할 수 있습니다.
OAuth 앱 생성 및 구성하기
GitLab OAuth 앱 생성 가이드를 따라 새 애플리케이션을 등록하세요.
새 OAuth 애플리케이션의 Name(이름)에 원하는 이름을 입력하고, 앱의 Redirect URI(리디렉션 URI)를 작성하세요. Redirect URIs는 ${your_logto_origin}/callback/${connector_id} 형식으로 맞춤 설정하세요. connector_id는 Logto 관리 콘솔 커넥터 상세 페이지 상단 바에서 확인할 수 있습니다.
스코프에서는 openid를 선택하세요. 또한 profile과 email도 활성화하는 것이 좋습니다. profile 스코프는 사용자의 프로필 정보를 얻기 위해 필요하며, email 스코프는 사용자의 이메일 주소를 얻기 위해 필요합니다. 이러한 스코프를 사용하려면 GitLab OAuth 앱에서 허용했는지 확인하세요. 이 스코프들은 이후 커넥터를 구성할 때도 사용됩니다.
- 커스텀 도메인을 사용하는 경우, OAuth 플로우가 두 도메인 모두에서 올바르게 작동하도록 커스텀 도메인과 기본 Logto 도메인 모두를 Redirect URIs에 추가하세요.
- 로그인 시 "The redirect_uri MUST match the registered callback URL for this application." 오류 메시지가 나타나면, GitLab OAuth 앱의 Redirect URI와 Logto 앱의 리디렉션 URL(프로토콜 포함)을 일치시키면 문제가 해결될 수 있습니다.
OAuth 앱 관리하기
GitLab의 애플리케이션 페이지로 이동하면 기존 OAuth 앱을 추가, 수정 또는 삭제할 수 있습니다. 또한 OAuth 앱 상세 페이지에서 Application ID와 Secret을 확인하거나 생성할 수 있습니다.
커넥터 구성하기
이전 섹션에서 안내한 OAuth 앱 상세 페이지에서 받은 Application ID와 Secret을 clientId 및 clientSecret 필드에 입력하세요.
scope는 스코프의 공백으로 구분된 목록입니다. 입력하지 않으면 기본값은 openid입니다. GitLab 커넥터에서 사용할 수 있는 스코프는 openid, profile, email입니다. profile 스코프는 사용자의 프로필 정보를 얻기 위해 필요하며, email 스코프는 사용자의 이메일 주소를 얻기 위해 필요합니다. 이러한 스코프를 사용하려면 GitLab OAuth 앱에서 허용했는지 확인하세요 (OAuth 앱 생성 및 구성하기 섹션에서 구성).
구성 타입
| Name | Type |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
GitLab 커넥터 테스트하기
이제 끝입니다. GitLab 커넥터를 사용할 수 있습니다. 로그인 경험에서 커넥터 활성화하기를 잊지 마세요.
참고 자료
GitLab - API 문서 (API Documentation)GitLab - OAuth 애플리케이션 (OAuth Applications)