웹 로그인 API 개요¶

웹 로그인 API는 웹페이지에서 IdP 연동을 제공하는 API입니다. 웹 로그인 API로 로그인을 구현하면, 사용자는 웹페이지에서 Google, Facebook 등 원하는 IdP로 로그인할 수 있습니다. 웹 로그인은 일반적으로 앱이 아닌 외부 사이트(예시: 게임 앱 개발사가 운영하는 게임 커뮤니티 사이트)에서 사용자를 로그인시킬 때 사용을 권장합니다. 웹 로그인 API는 v2와 v1 두 종류가 존재합니다.

웹 로그인 V2¶

앱을 Hive SDK로 개발했고, 외부 사이트에서 앱 사용자를 로그인시키고 싶을 때 웹 로그인 V2 사용을 권장합니다. 사용자가 웹페이지에서 IdP 계정으로 로그인하면, 검증 V2 API로 IdP 식별자(`idp_user_id`)를 얻을 수 있습니다. 개발사에서는 이 IdP 식별자를 외부 사이트 사용자 계정 식별자로 사용하고 이를 외부 사이트 데이터베이스에 저장해야 합니다. 왜냐하면, 이 IdP 식별자와 PlayerID 조회 API로 앱에서 쓰이는 사용자 식별자인 PlayerID를 얻을 수 있기 때문입니다. 웹 로그인 V2는 PlayerID를 직접 생성하지 않으며, IdP 식별자로 PlayerID를 얻어야 합니다. 이러한 방식으로, 개발사는 앱에 존재하는 사용자 계정과 앱 외부 사이트에 존재하는 동일한 사용자 계정을 연동할 수 있습니다.

예를 들어, 게임 앱 개발사는 어떤 사용자가 자사 게임 커뮤니티에 Google 계정으로 로그인하는 기능을 웹 로그인 V2로 구현할 수 있습니다. 로그인 후에, 검증 V2 API를 호출하면 Google 계정으로 로그인한 사용자의 IdP 식별자를 얻을 수 있습니다. 만약, 동일한 사용자가 게임 앱에 접속해 로그인하면 게임상 사용자 식별자인 PlayerID가 생성되는데, 게임 커뮤니티에서 쓰이는 IdP 식별자와 PlayerID 조회 API로 이 PlayerID를 얻을 수 있습니다. 이렇게, 개발사는 게임 커뮤니티와 게임에 존재하는 동일한 사용자 계정을 연동할 수 있습니다.

웹 로그인 V1¶

앱을 Hive SDK로 개발하지 않았고, 외부 사이트에서 앱 사용자를 로그인시키고 싶을 때 웹 로그인 V1 사용을 권장합니다. 즉, Hive가 제공하는 기능 중에서 로그인 기능만 앱 외부에서 이용하고 싶을 때 웹 로그인 V1 사용을 권장합니다. 사용자가 웹페이지에서 IdP 계정으로 로그인하면, 웹 로그인 V1은 바로 사용자 PlayerID(`pid`)를 생성합니다. 개발사는 PlayerID로 사용자를 식별할 수 있으며, IdP 식별자와 같은 별도 식별자를 획득, 관리할 필요가 없습니다.

예를 들어, 게임 앱 개발사는 어떤 사용자가 자사 게임 커뮤니티에 Google 계정으로 로그인하는 기능을 웹 로그인 V1으로 구현할 수 있습니다. 사용자가 Google 계정으로 로그인하면 PlayerID도 같이 생성되므로, 앱 개발사는 이 PlayerID로 Hive 콘솔에서 사용자 정보를 조회하거나 활용할 수 있습니다.