GS2-Account API 레퍼런스

사용자를 식별하기 위한 계정 관리 기능을 제공하는 서비스입니다.
기기 변경이나 분실에 대비하여, 이메일 주소+비밀번호 또는 소셜 계정을 이용한 데이터 인계 기능을 지원합니다.

익명 계정

GS2-Account가 발행하는 것은 익명 계정입니다.
일반적인 계정과 마찬가지로 로그인ID와 비밀번호를 가지지만, 그 두 가지 모두를 시스템이 무작위로 발행하며 사용자에게 입력을 요구하지 않는 것이 특징입니다.
발행된 인증 정보를 디바이스의 로컬 스토리지에 저장해 두고, 두 번째 실행부터는 그 정보로 로그인하여 게임을 재개합니다.

사용자는 등록의 번거로움 없이 플레이를 시작할 수 있고, 게임 측은 개인정보를 보관하지 않아도 됩니다.

인계

인증 정보를 디바이스의 로컬 스토리지에만 보관하면, 단말의 고장·분실·기기 변경으로 계정을 잃게 됩니다.
이를 피하기 위해 사용자는 원하는 시점에 인계 정보를 등록할 수 있습니다.

인계 정보에는 각종 플랫폼의 ID 기반이나 SNS 계정으로 인증하여 얻은 사용자ID 등을 기록합니다.
새로운 디바이스에서 같은 ID 기반에 로그인하고, 거기서 얻은 사용자ID로 인계를 실행하면 원래의 익명 계정으로 로그인하기 위한 정보를 취득할 수 있습니다.
취득한 정보를 다시 로컬 스토리지에 저장하여 이후의 로그인에 이용합니다.

인계 정보는 슬롯 번호 0~1024 범위에서 관리되며, 최대 1,025종류까지 등록할 수 있습니다.
슬롯마다 다른 인증 수단을 할당할 수 있으므로, 사용자가 인계 수단을 선택하도록 하는 운용도 가능합니다.

OpenID Connect 연동

인계 정보의 등록과 인계의 실행에 OpenID Connect를 준수하는 인증 시스템을 이용할 수 있습니다.
연동 대상은 마스터 데이터의 슬롯마다 Discovery 엔드포인트 URL·클라이언트ID·클라이언트 시크릿으로 지정합니다.
Sign in with Apple의 경우에는 클라이언트 시크릿 대신 Team ID·Key ID·개인키(PEM)를 지정합니다.

OpenID Connect 연동이 설정된 슬롯은 임의의 사용자 식별자와 비밀번호를 사용한 인계 정보 등록 및 인계 실행을 할 수 없게 됩니다.