GitHub 소셜 로그인을 설정하세요
GitHub 소셜 로그인에 대한 공식 Logto 커넥터입니다.
이 가이드는 Logto 커넥터에 대한 기본적인 이해를 전제로 합니다. 익숙하지 않은 분들은 커넥터 가이드를 참조하여 시작하세요.
시작하기
GitHub 커넥터는 최종 사용자가 GitHub OAuth 2.0 인증 프로토콜을 통해 자신의 GitHub 계정을 사용하여 애플리케이션에 로그인할 수 있도록 합니다.
GitHub 계정으로 로그인하기
GitHub 웹사이트로 이동하여 GitHub 계정으로 로그인하세요. 계정이 없다면 새로 등록할 수 있습니다.
OAuth 앱 생성 및 구성하기
OAuth 앱 생성 가이드를 따라 새 애플리케이션을 등록하세요.
Application name에 새 OAuth 애플리케이션의 이름을 지정하고 앱의 Homepage URL을 입력하세요. Application description 필드는 비워둘 수 있으며 Authorization callback URL을 ${your_logto_origin}/callback/${connector_id}로 설정할 수 있습니다. connector_id는 Logto Admin Console 커넥터 세부 정보 페이지의 상단 바에서 찾을 수 있습니다.
로그인 시 "The redirect_uri MUST match the registered callback URL for this application."라는 오류 메시지가 나타나면, GitHub OAuth 앱과 Logto 앱의 Authorization Callback URL을 (물론 프로토콜을 포함하여) 일치시키면 문제를 해결할 수 있습니다.
Enable Device Flow 앞의 체크박스를 선택하지 않는 것이 좋습니다. 그렇지 않으면 모바일 기기에서 GitHub으로 로그인하는 사용자가 GitHub 앱에서 초기 로그인 동작을 확인해야 합니다. 많은 GitHub 사용자가 휴대폰에 GitHub 모바일 앱을 설치하지 않아서 로그인 흐름이 차단될 수 있습니다. 최종 사용자가 로그인 흐름을 확인하도록 기대하는 경우에는 우리의 제안을 무시하세요. 디바이스 흐름에 대한 자세한 내용을 참조하세요.
OAuth 앱 관리하기
OAuth Apps 페이지로 이동하여 기존 OAuth 앱을 추가, 편집 또는 삭제할 수 있습니다. OAuth 앱 세부 정보 페이지에서 Client ID를 찾고 Client secrets를 생성할 수 있습니다.
커넥터 구성하기
이전 섹션에서 언급한 OAuth 앱 세부 정보 페이지에서 얻은 Client ID와 Client Secret으로 clientId 및 clientSecret 필드를 채우세요.
scope는 스코프의 공백으로 구분된 목록입니다. 제공되지 않으면, 스코프는 기본적으로 read:user로 설정됩니다.
구성 유형
| 이름 | 유형 |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
GitHub 커넥터 테스트
이제 완료되었습니다. GitHub 커넥터가 이제 사용 가능해야 합니다. 로그인 경험에서 소셜 커넥터 활성화를 잊지 마세요.
참고 자료
GitHub - 개발자 - 앱
GitHub - 개발자 - 앱 - OAuth 앱 생성