계정 및 인증
'계정 및 인증'은 사용자가 로그인한 다음 그 계정을 유지하고 관리하는 데 필요한 기능을 제공합니다.
제공 기능
-
지원하는 로그인 수단 조회
로그인 화면에 어떤 로그인 버튼을 노출할지 Hive Axyl 인증 서버에 조회합니다. 목록에는 App ID에 귀속된 서비스 환경에서 쓸 수 있고 Hive 콘솔에서 사용으로 켜 둔 로그인 수단만 담깁니다. 요청 IP로 판별한 국가에 따라 일부 로그인 수단이 빠질 수 있으며, 이 국가는 앱에서 지정할 수 없습니다.
-
계정 연동
현재 로그인한 Player ID에 다른 로그인 수단을 추가로 연결하거나 연결을 해제합니다. 게스트로 시작한 사용자가 Google 계정을 연결해 두면 기기를 바꾼 뒤에도 같은 플레이 데이터로 돌아옵니다. 계정 연동은 서로 다른 두 계정을 하나로 합치는 기능이 아니며, 로그인한 상태에서만 사용합니다.
-
이용 제한
운영 정책을 어긴 사용자의 앱 진입을 차단합니다. 로그인에 성공한 사용자라도 제재 대상이면 제재 사유와 기간을 안내하고 앱 진입을 막아야 합니다. 제재 대상과 제재 유형의 등록과 해제는 Hive 콘솔에서만 처리하며, 앱은 제재 여부를 조회만 합니다.
-
로그인 토큰 유효성 검증
앱 서버가 앱 클라이언트에서 받은 액세스 토큰이 유효한지 확인합니다. 앱 서버가 자체 세션을 만들거나 아이템 지급처럼 위변조를 허용할 수 없는 처리를 하기 전에 사용합니다.
더 알아보기
- 자동 로그인: 저장해 둔 인증 정보로 앱 재실행 시 세션 복원
- 여러 계정 간 전환: 한 기기에 보관한 여러 계정 사이의 세션 교체
- 계정 연동 시 충돌 처리: 다른 Player ID가 이미 쓰고 있는 계정을 연동할 때의 처리
- 비밀번호 변경: 유저네임 계정의 로그인 비밀번호 변경
- 추가 보안 적용: grant key로 게스트 계정과 유저네임 계정 생성 요청 사전 인가
다음 단계
'계정 및 인증'의 각 기능을 구현하려면 먼저 모듈 설치 및 초기화를 진행하세요.
앱 서버에서 Hive Axyl Server API를 직접 호출한다면 토큰 발급으로 인증 토큰을 먼저 준비하세요.