시작하기¶
웹 로그인 은 유저가 웹에서 IdP로 로그인할 수 있는 기능입니다. 웹 로그인이 가능한 IdP를 참고하세요.
웹 로그인 API를 사용하면 유저가 앱이 아닌 외부의 웹 사이트(예: 게임 개발사가 운영하는 커뮤니티 사이트)에서 IdP 로그인 을 구현할 수 있습니다. 현재 웹 로그인 API는 기존의 웹 로그인 v1과 웹 로그인 v2을 통합하여 제공합니다.
Warning
- 웹 로그인 API 버전 v2 및 v1을 구분하여 호출하는 방식은 현재 지원하지 않습니다. 지속적인 지원을 받으려면 통합된 웹 로그인 API를 사용해야 합니다.
- 통합된 웹 로그인 API에서는 버전을 구분하지 않습니다.
Note
웹 로그인 API를 사용하려면 Hive 콘솔의 관련 설정을 완료해야 합니다. 자세한 내용은 콘솔 가이드의 인증 > 로그인 설정에서 웹 로그인이 가능한 IdP를 참고하세요.
웹 로그인 API 사용 방법¶
웹 로그인 API는 '웹 로그인 AppID'의 사용 용도에 따라 사용 방법이 상이합니다.
'웹 로그인 AppID' 사용 용도가 '커뮤니티' 또는 '웹사이트'인 경우¶
하이브 콘솔의 앱센터 > AppID 관리 > 웹 로그인 AppID 등록에서 '웹 로그인 AppID'의 사용 용도를 커뮤니티 또는 웹사이트로 선택하는 경우, 게임 개발사에서는 웹 로그인 API를 아래와 같이 사용합니다.
- 로그인 페이지 호출
- 로그인 검증 및 유저 정보 조회 API의 응답 값인 IdP 식별자(
idp_index,idp_user_id) 값을 사용자 계정 식별자로 활용 및 개발사 데이터베이스에 저장
위와 같이 사용하는 이유는 게임이 아닌 커뮤니티 또는 웹사이트에서 먼저 IdP로 로그인하면 게임에서 사용하는 사용자 식별자인 PlayerID를 생성하지 않기 때문입니다. PlayerID 대신 IdP 식별자를 사용자 계정 식별자로 활용하면 계정 충돌 을 방지할 수 있습니다.
단, 사용자가 게임 앱에 접속해 로그인하면 게임 사용자 식별자인 PlayerID가 생성되므로 검증 및 유저 정보 조회 API의 응답 값인 user_info의 PlayerID 또는 인증 API로 유저 정보 조회 API의 응답 값인 PlayerID와 구분하여 사용자 계정 식별자로 사용할 수 있습니다.
Note
계정 충돌은 아래와 같은 상황에서 발생합니다.
- 웹 로그인을 사용하여 최초 IdP로 로그인 및 PlayerID 생성
- Hive SDK를 적용한 게임에서 로그인 후 게임 프로필에서 추가 IdP 연동을 연결 시
- 이미 웹 로그인으로 PlayerID가 생성되었기 때문에 유저에게 계정을 선택하라는 계정 충돌 발생
'웹 로그인 AppID' 사용 용도가 '블록체인'인 경우¶
하이브 콘솔의 앱센터 > AppID 관리 > 웹 로그인 AppID 등록에서 '웹 로그인 AppID'의 사용 용도를 '블록체인'으로 선택하는 경우, 게임 개발사에서는 웹 로그인 API를 아래와 같이 사용합니다.
- 로그인 페이지 API 호출
- 로그인 검증 및 유저 정보 조회 API 호출 및 응답 값인 PlayerID 값으로 사용자 계정 식별 가능 (IdP 식별자와 같은 별도 식별자를 획득 및 관리할 필요가 없음)
즉, 블록체인의 경우 로그인 페이지 API 호출 및 로그인 검증 및 유저 정보 조회 API 호출하면 PlayerID가 생성되므로, 커뮤니티 또는 웹사이트처럼 별도 IdP 식별자를 사용하지 않아도 됩니다.