GitHub 로그인 연결하기
손님이 GitHub 계정으로 가입하게 하려면, GitHub에 내 서비스를 등록하고 값 두 개를 받아 와야 합니다. Client ID와 Client secret입니다.
이 페이지는 그 값 두 개를 받는 순서를 안내합니다. 받은 값을 WEEGLOO에 넣는 방법은 받은 값을 WEEGLOO에 넣기에 있습니다.
먼저 복사해 둘 주소
손님이 GitHub에서 로그인을 마치면, GitHub은 그 결과를 정해진 주소로 돌려보냅니다. 이 주소를 GitHub에 등록해야 하므로 먼저 복사해 두세요. 1단계에서 붙여 넣습니다.
아래에서 내 Space를 고르면 식별자가 채워진 주소가 됩니다.
직접 채우고 싶다면 {spaceId} 자리에 내 Space의 식별자를 넣으세요. 콘텐츠 스튜디오에서 그 Space를 열고 브라우저 주소창을 보면, /spaces/ 다음에 오는 값이 식별자입니다.
이 주소는 내 사이트 주소가 아니라 WEEGLOO가 로그인 결과를 받는 자리입니다. 그래서 내 사이트를 아직 만들지 않았어도 지금 확정됩니다. 콘텐츠 스튜디오에서 GitHub을 켰다면 Step 1에 같은 주소가 보이므로, 거기서 복사해도 됩니다.
GitHub에서 값 두 개 받기
GitHub에 로그인한 뒤, 아래 두 단계를 차례로 진행하세요. 여기서 하는 일에는 비용이 들지 않습니다.
OAuth App 등록하기
화면에 나오는 OAuth는 GitHub 계정으로 로그인하게 해 주는 방식의 이름입니다. 값 두 개는 여기서 등록하는 앱 하나에 들어 있습니다.
-
개발자 설정 화면(https://github.com/settings/developers)을 여세요.
-
왼쪽 메뉴에서 OAuth Apps를 누르세요.
-
New OAuth app을 누르세요.
-
Application name에 손님에게 보일 이름을 입력하세요(예:
포근한 옷장). -
Homepage URL에 내 사이트 주소를 입력하세요(예:
https://pogeun-otjang.com). -
Redirect URI 칸에 먼저 복사해 둘 주소에서 복사한 주소를 붙여 넣으세요.
-
Register application을 누르세요.
아직 사이트가 없다면 Homepage URL에 앞으로 쓸 주소를 적어 두세요. 나중에 수정할 수 있습니다. Application description은 선택 항목이고, 적으면 손님에게 그대로 보이므로 손님이 읽을 문장으로 적으세요.
Client ID와 Client secret 복사하기
Register application을 누르면 방금 등록한 앱의 설정 화면이 열립니다. 값 두 개 중 Client ID는 여기에 이미 나와 있고, secret은 버튼을 눌러 지금 만듭니다.
-
Client ID에 적힌 값을 복사해 두세요.
-
Client secrets 제목 오른쪽의 Generate a new client secret을 누르세요.
-
만들어진 값 오른쪽의 복사 아이콘을 눌러 secret을 복사해 두세요.
이 화면을 벗어나면 secret을 다시 볼 수 없습니다
Client ID는 이 화면에 계속 남아 있어 언제든 다시 볼 수 있지만, secret은 그렇지 않습니다. 잃어버렸다면 Generate a new client secret으로 새로 만들고, 새로 받은 값을 WEEGLOO에 다시 넣으세요. secret은 이름 그대로 비밀 값입니다. 남에게 알려 주거나 공개된 곳에 적어 두지 마세요.
이메일이 공개여야 로그인됩니다
GitHub 로그인에는 조건이 하나 붙습니다. 로그인하는 GitHub 계정이 이메일을 공개하고 있어야 합니다.
WEEGLOO는 손님이 GitHub으로 로그인할 때 그 계정의 공개 이메일을 함께 받아 회원에 담습니다. 같은 Space에서는 한 이메일로 한 번만 가입할 수 있습니다. 공개 이메일을 지정하지 않은 계정은 이 값이 넘어오지 않고, 그러면 가입이 거기서 멈춥니다.
멈추면 손님은 WEEGLOO가 띄우는 안내 화면을 보게 됩니다. 이메일을 가져오지 못했다는 것과 무엇을 하면 되는지가 손님의 언어로 적혀 있고, 내 사이트로 돌아가는 버튼이 함께 있습니다.
이때 로그인 결과는 내 사이트까지 오지 않습니다. 그래서 내 사이트 코드로는 이 상황을 알아채지도, 대신 처리하지도 못합니다.
해결하는 사람은 손님입니다. 손님이 GitHub 계정 설정(https://github.com/settings/profile)에서 Public profile을 열면 Public email 항목이 있습니다. 여기서 표시할 이메일을 고르면 그다음 로그인부터 통과합니다. 아직 고르지 않은 계정에는 Select a verified email to display라고만 적혀 있습니다.
내 사이트에서 할 수 있는 일은 GitHub으로 로그인하는 자리에 이 조건을 미리 적어 두어 손님이 막히기 전에 알게 하는 것입니다.
받은 값을 WEEGLOO에 넣기
이제 손에 값 두 개가 있습니다. 여기서부터는 지금까지 어떻게 작업해 왔는지에 따라 갈립니다.
콘텐츠 스튜디오에서 직접 설정하고 있었다면 이렇게 진행하세요.
- 서비스 회원 로그인의 소셜 로그인 켜기로 돌아가세요.
- GitHub을 켜세요.
- Step 2의 Client ID 칸에 Client ID를 넣으세요.
- Client Secret 칸에 Client secret을 넣으세요.
- 저장을 누르세요.
AI 에이전트에게 연동을 맡겨 두고 값을 받아 오라는 안내를 받았다면, 받아 온 값 두 개를 대화창에 그대로 붙여 넣고 하던 작업을 이어 가세요. 남은 설정은 에이전트가 이어서 처리합니다.
다음으로 할 일
- 서비스 회원 로그인: 받아 온 값을 콘텐츠 스튜디오에 넣고, 회원 로그인의 나머지 설정을 마칩니다.
- 회원 역할과 권한: 가입한 회원이 무엇을 보고 쓸 수 있는지 정하는 ServiceUserRole을 만듭니다.
- Auth API: 로그인을 내 사이트 코드에 붙일 때 필요한 요청 형식 같은 기술 명세를 다룹니다.