웹 로그인

웹 로그인은 커뮤니티, 블록체인, 다양한 웹사이트에서 안전하고 간편하게 로그인을 처리할 수 있는 제품입니다.

웹 로그인의 종류¶

웹 로그인은 2가지 종류가 있으며, 동작에 차이가 있습니다. 블록체인에서 로그인을 사용하는 경우를 웹 로그인v1이라고 하며, 커뮤니티에서 로그인을 사용하는 경우는 웹 로그인v2라고 합니다.

블록체인에서 로그인을 사용하고 싶은 경우¶

개요
- 최초 IdP 연동 시 유저 식별자인 PlayerID를 웹 로그인에서 직접 생성합니다.
- 블록체인에서 로그인을 처리할 때 사용합니다. 이 때 최초 IdP 연동은 게임에서만 진행해야 합니다. 그렇지 않으면 계정 충돌이 발생할 수 있습니다. 또한 블록체인은 SMS 인증을 진행한 후 로그인 화면이 노출됩니다.
- 이외에도 Hive SDK를 적용하지 않는 게임에서 웹에서만 로그인을 처리하고 유저 식별자를 PlayerID로 이용하고 싶을 때 사용합니다.
앱센터에서 AppID 생성
- 웹 로그인을 사용하려면 앱센터 AppID를 생성해야 합니다. 앱센터 AppID 등록하기 콘솔 가이드를 참고하세요.
인증에서 로그인 설정
- AppID를 생성한 후 아래와 같이 사용할 로그인을 설정합니다. 웹 로그인은 게스트 로그인이 없습니다.
  - 사용할 로그인 키 등록
  - Redirect URI 등록 : 웹 로그인을 완료 후 이동될 페이지 주소를 작성합니다. 최대 5개까지 등록합니다. http://와 https://가 구분되기 때문에 둘 다 사용하고 싶은 경우에는 도메인(예: www.a.com)으로 작성해주시면 됩니다.
  - 멤버십v4 회원가입 여부 등록 : 회원가입 사용으로 표시할 경우 최초 IdP 연동이 웹 로그인에서 가능하며, 이 때 계정 충돌이 발생할 수 있습니다. 회원가입을 미사용으로 표시할 경우 최초 IdP 연동은 게임에서만 가능합니다. 블록체인은 회원가입 미사용으로 표시합니다.
API
- 블록체인에서 로그인을 사용하거나 Hive SDK를 적용하지 않고 웹에서 단독으로 로그인을 사용하고 싶은 경우의 사용하는 API를 웹 로그인v1이라고 말하며, 웹 로그인v1 API 사용하시려면 아래 API 가이드를 참고하세요.
  - 로그인 페이지 호출하기 v1
  - 웹 로그인 검증하기 v1

Note

계정 충돌

계정 충돌은 웹 로그인v1을 사용하여 최초 IdP 연동하여 생성된 PlayerID를 Hive SDK를 적용한 게임에서 게스트 로그인 후 게임 프로필에서 추가 IdP 연동을 연결할 때 이미 웹 로그인으로 PlayerID가 생성되어 있으므로 유저에게 계정을 선택하라는 계정 충돌이 발생됩니다.

커뮤니티, 웹사이트에서 로그인을 사용하고 싶은 경우¶

개요
- 최초 IdP 연동 시 유저 식별자를 사용 제품에서 생성하며 계정 충돌 상황을 방지하기 위해서 만들어졌습니다.
- 유저 식별자를 제품에서 생성하기 때문에 다양한 곳에서 사용할 수 있으며, 계정 충돌이 발생하지 않습니다. 게임에서 생성된 PlayerID를 연결하려면 Server API를 사용합니다.
앱센터에서 AppID 생성
- 웹 로그인을 사용하려면 앱센터 AppID를 생성해야 합니다. 앱센터 AppID 등록하기 콘솔 가이드를 참고하세요.
인증에서 로그인 설정
- AppID를 생성한 후 아래와 같이 사용할 로그인을 설정합니다. 웹 로그인은 게스트 로그인이 없습니다.
  - 사용할 로그인 키 등록
  - Redirect URI 등록 : 웹 로그인을 완료 후 이동될 페이지 주소를 작성합니다. 최대 5개까지 등록합니다. http://와 https://가 구분되기 때문에 둘 다 사용하고 싶은 경우에는 도메인(예: www.a.com) 으로 작성해주시면 됩니다.
  - 멤버십v4 회원가입 여부 등록 : 회원가입을 사용으로 표시합니다.
API
- 커뮤니티를 사용하고 싶은 경우의 사용하는 API를 웹 로그인v2이라고 말하며, 웹 로그인v2 API 사용하시려면 아래 API 가이드를 참고하세요.

IdP 콘솔 설정하기¶

인증 > 인증 환경설정 > 로그인 설정에서 웹 로그인을 설정했다면 Google, Apple 등과 같은 IdP 콘솔에서 웹 로그인 Redirect URI를 등록해야 합니다.

Google¶

등록 방법
- Google Cloud Console에 접속하여 프로젝트에서 OAuth 클라이언트 ID를 생성하고, Redirect URI를 등록합니다.
- 자세한 내용은 Google Developers 문서를 참고하세요.
등록 URI
- sandbox : https://sandbox-weblogin.withhive.com/cb_google
- real : https://weblogin.withhive.com/cb_google

Warning

Google Cloud Console의 OAuth 동의 화면에서 승인된 도메인에 withhive.com이 자동으로 등록되어 있다면, 민감한 범위 또는 제한된 범위를 추가하지 마세요. Hive에서는 withhive.com의 도메인 소유권을 제공하지 않습니다.

Facebook¶

등록 방법
- Meta for Developers에 접속하여 앱 내에서 Facebook 로그인 설정을 추가한 후, Redirect URI를 등록합니다.
- 자세한 내용은 Meta Developers 문서를 참고하세요.
등록 URI
- sandbox : https://sandbox-weblogin.withhive.com/cb_facebook
- real : https://weblogin.withhive.com/cb_facebook

Apple¶

등록 방법
- Apple Developer Console에 접속하여 Services IDs를 생성한 후, Sign in with Apple 설정에서 Return URLs를 등록합니다.
- 자세한 내용은 Apple Developer 문서를 참고하세요.
등록 URI
- sandbox : https://sandbox-weblogin.withhive.com/cb_apple
- real : https://weblogin.withhive.com/cb_apple