Google 로그인 연결하기
손님이 Google 계정으로 가입하게 하려면, Google에 내 서비스를 등록하고 값 두 개를 받아 와야 합니다. 클라이언트 ID와 클라이언트 보안 비밀번호입니다.
이 페이지는 그 값 두 개를 받는 순서를 안내합니다. 받은 값을 WEEGLOO에 넣는 방법은 받은 값을 WEEGLOO에 넣기에 있습니다.
먼저 복사해 둘 주소
손님이 Google에서 로그인을 마치면, Google은 그 결과를 정해진 주소로 돌려보냅니다. 이 주소를 Google에 등록해야 하므로 먼저 복사해 두세요. 3단계에서 붙여 넣습니다.
아래에서 내 Space를 고르면 식별자가 채워진 주소가 됩니다.
직접 채우고 싶다면 {spaceId} 자리에 내 Space의 식별자를 넣으세요. 콘텐츠 스튜디오에서 그 Space를 열고 브라우저 주소창을 보면, /spaces/ 다음에 오는 값이 식별자입니다.
이 주소는 내 사이트 주소가 아니라 WEEGLOO가 로그인 결과를 받는 자리입니다. 그래서 내 사이트를 아직 만들지 않았어도 지금 확정됩니다. 콘텐츠 스튜디오에서 Google을 켰다면 Step 1에 같은 주소가 보이므로, 거기서 복사해도 됩니다.
Google에서 값 두 개 받기
Google 계정으로 Google Cloud Console(https://console.cloud.google.com)에 로그인한 뒤, 아래 네 단계를 차례로 진행하세요. 여기서 하는 일에는 비용이 들지 않습니다.
프로젝트 만들기
-
새 프로젝트 화면(https://console.cloud.google.com/projectcreate)을 여세요.
-
프로젝트 이름에 나중에 알아볼 이름을 입력하세요(예:
포근한 옷장). -
만들기를 누르세요.
-
콘솔 위쪽의 프로젝트 이름이 방금 만든 것으로 되어 있는지 확인하세요.
이미 쓰던 프로젝트가 있다면 새로 만들지 않고 그 프로젝트를 그대로 써도 됩니다.
동의 화면 구성하기
손님이 Google 계정으로 로그인하면, 이 서비스에 로그인해도 되는지 묻는 Google 화면이 먼저 뜹니다. 그 화면에 어떤 이름이 뜨고 문의는 어디로 받을지를 여기서 정합니다. 프로젝트마다 한 번만 하면 됩니다.
-
Google 인증 플랫폼의 브랜딩 화면(https://console.cloud.google.com/auth/branding)을 여세요.
-
시작하기를 누르세요.
-
앱 이름에 손님에게 보일 이름을 입력하세요(예:
포근한 옷장). -
사용자 지원 이메일에서 문의를 받을 주소를 고르세요.
-
다음을 누르세요.
-
대상에서 외부를 고르세요.
-
다음을 누르세요.
-
연락처 정보에 이메일 주소를 입력하세요.
-
완료 단계에서 Google의 사용자 데이터 정책 동의 항목에 체크하세요.
-
만들기를 누르세요.
내부는 같은 조직의 계정만 쓸 수 있습니다. 내 조직 밖의 손님이 로그인하게 하려면 외부를 고릅니다. 외부로 만든 로그인은 처음에 테스트 모드로 시작하므로, 로그인해 볼 계정 등록하기를 이어서 진행하세요.
OAuth 클라이언트 만들기
화면에 나오는 OAuth는 Google 계정으로 로그인하게 해 주는 방식의 이름입니다. 여기서 만드는 클라이언트에 먼저 복사해 둘 주소를 등록합니다.
-
왼쪽 메뉴에서 클라이언트를 누르세요.
-
클라이언트 만들기를 누르세요.
-
애플리케이션 유형에서 웹 애플리케이션을 고르세요.
-
이름에 이 클라이언트를 알아볼 이름을 입력하세요(예:
포근한 옷장). -
승인된 JavaScript 원본은 비워 두세요.
-
승인된 리디렉션 URI의 URI 추가를 누르세요.
-
나타난 칸에 먼저 복사해 둘 주소에서 복사한 주소를 붙여 넣으세요.
-
만들기를 누르세요.
목록에는 Android나 iOS 같은 유형도 있지만, 모바일 앱에 로그인을 붙이는 경우에도 웹 애플리케이션을 고릅니다. 로그인 결과가 돌아가는 곳이 내 앱이 아니라 WEEGLOO의 웹 주소이기 때문입니다. 이름은 Google 화면에서 클라이언트를 구분하는 용도이고, 손님에게는 보이지 않습니다.
등록한 주소는 바로 반영되지 않을 수 있습니다
폼 아래에는 "참고: 설정이 적용되는 데 5분에서 몇 시간이 걸릴 수 있습니다"라는 Google의 안내가 있습니다. 등록한 직후에는 아직 반영되지 않아 로그인이 막힐 수 있습니다. 그럴 때는 시간을 두고 다시 시도하세요.
클라이언트 ID와 보안 비밀번호 복사하기
만들기를 누르면 OAuth 클라이언트 생성됨 창이 뜹니다. 여기 적힌 값 두 개가 WEEGLOO에 넣을 값입니다.
-
클라이언트 ID 오른쪽의 복사 아이콘을 눌러 값을 복사해 두세요.
-
클라이언트 보안 비밀번호 오른쪽의 복사 아이콘을 눌러 값을 복사해 두세요.
-
두 값을 모두 옮겨 두었으면 확인을 누르세요.
창을 닫으면 보안 비밀번호를 다시 볼 수 없습니다
이 창에는 "이 대화상자를 닫으면 더 이상 클라이언트 보안 비밀번호를 보거나 다운로드할 수 없습니다"라는 경고가 있습니다. 창을 닫기 전에 두 값을 복사해 두세요. 값을 파일로 받아 두고 싶다면 JSON 다운로드를 눌러도 됩니다.
두 값이 콘텐츠 스튜디오의 어느 칸에 들어가는지는 이렇습니다.
| Google 화면 | 콘텐츠 스튜디오 |
|---|---|
| 클라이언트 ID | Client ID |
| 클라이언트 보안 비밀번호 | Client Secret |
보안 비밀번호는 이름 그대로 비밀번호입니다. 남에게 알려 주거나 공개된 곳에 적어 두지 마세요.
로그인해 볼 계정 등록하기
방금 만든 로그인은 처음에 게시 상태가 테스트 중입니다. Google은 게시 상태가 테스트 중인 동안에는 테스트 사용자만 앱에 액세스할 수 있다고 안내합니다. 로그인이 되는지 확인하려면 로그인해 볼 계정을 테스트 사용자에 먼저 등록하세요.
- 왼쪽 메뉴에서 대상을 누르세요.
- 테스트 사용자의 Add users를 누르세요.
- 오른쪽에 열린 칸에 로그인해 볼 Google 계정 주소를 입력하세요.
- 저장을 누르세요.
Add users는 Google이 번역하지 않는 문구라 어느 언어에서나 영어로 보입니다.
앱 인증을 받기 전까지 등록할 수 있는 사용자는 100명입니다. 이 한도는 앱의 전체 수명 주기에서 계산됩니다. 지금 몇 명이 등록됐는지는 같은 화면의 OAuth 사용자 한도에서 확인합니다.
손님 누구나 로그인하게 열려면 같은 화면의 앱 게시를 누릅니다. 이 버튼은 브랜딩 화면의 구성을 마쳐야 눌립니다. 서비스에 따라 Google의 인증 절차가 필요할 수도 있습니다.
받은 값을 WEEGLOO에 넣기
이제 손에 값 두 개가 있습니다. 여기서부터는 지금까지 어떻게 작업해 왔는지에 따라 갈립니다.
콘텐츠 스튜디오에서 직접 설정하고 있었다면 이렇게 진행하세요.
- 서비스 회원 로그인의 소셜 로그인 켜기로 돌아가세요.
- Google을 켜세요.
- Step 2의 Client ID 칸에 클라이언트 ID를 넣으세요.
- Client Secret 칸에 클라이언트 보안 비밀번호를 넣으세요.
- 저장을 누르세요.
AI 에이전트에게 연동을 맡겨 두고 값을 받아 오라는 안내를 받았다면, 받아 온 값 두 개를 대화창에 그대로 붙여 넣고 하던 작업을 이어 가세요. 남은 설정은 에이전트가 이어서 처리합니다.
다음으로 할 일
- 서비스 회원 로그인: 받아 온 값을 콘텐츠 스튜디오에 넣고, 회원 로그인의 나머지 설정을 마칩니다.
- 회원 역할과 권한: 가입한 회원이 무엇을 보고 쓸 수 있는지 정하는 ServiceUserRole을 만듭니다.
- Auth API: 로그인을 내 사이트 코드에 붙일 때 필요한 요청 형식 같은 기술 명세를 다룹니다.