로그인
'로그인'은 Google, Apple, Steam 같은 외부 인증 제공자의 계정으로 사용자를 앱에 로그인시키는 기능입니다. Hive Axyl 인증 서버는 인증 결과를 검증해 계정에 연결된 Player ID를 반환합니다. 외부 인증 제공자가 운영하는 인증 체계와 회원 정보를 사용하므로, 앱의 회원가입 절차와 계정 데이터베이스를 따로 만들 필요가 없습니다.
공통 준비
'로그인'을 구현하기 전에 1단계. 앱 정보 생성부터 6단계. 로그인까지 '시작하기'의 과정을 먼저 완료하세요. App ID 발급, Hive Axyl SDK 설치, SDK 초기화, 토큰 발급과 세션 활성화처럼 모든 로그인 수단에 공통으로 필요한 준비가 여기에 들어 있습니다.
제공 기능
'로그인'이 지원하는 외부 인증 제공자는 아래와 같습니다.
각 로그인 수단은 외부 인증 제공자와 Hive 콘솔을 연결하는 '1단계. 연동 환경 구성'과 앱에 로그인을 구현하는 '2단계. 로그인'으로 나누어 안내합니다. 위 목록은 각 로그인 수단의 1단계로 연결됩니다.
Google Play Games 모바일 앱 로그인은 Android에서 실행되고 Google Play로 배포하는 앱에만 적용합니다. 나머지 로그인 수단은 Android, iOS, macOS, Windows에서 모두 사용합니다.
커스텀 계정으로 로그인은 앱이 직접 운영하는 인증 시스템의 계정으로 Hive Axyl 계정을 만들고 로그인하는 방식입니다. Hive Axyl이 공식 지원하는 외부 인증 제공자 외의 인증 수단을 사용해야 할 때 선택합니다.
Note
게스트 로그인과 유저네임 로그인은 외부 인증 제공자를 거치지 않고 Hive Axyl 인증 서버가 자체적으로 처리합니다. 구현 방법은 6단계. 로그인을 참조하세요.
로그인 기능 구현 순서
외부 인증 제공자 로그인 기능은 아래 순서로 구성합니다. 사전 준비는 외부 인증 제공자 콘솔에서 값을 준비하고, 콘솔 가이드는 그 값을 Hive 콘솔에 등록하며, 이 개발자 가이드는 앱 코드와 로그인 화면을 구현합니다.
- 사전 준비에서 사용할 외부 인증 제공자의 인증 정보와 필요한 설정을 준비합니다.
- 로그인 설정에서 로그인 수단을 활성화하고 준비한 인증 정보를 등록합니다.
- 아래에서 선택한 로그인 수단의 **1단계. 연동 환경 구성**으로 이동해 Add-on, 빌드 설정, 앱별 환경을 준비합니다.
- 해당 수단의 **2단계. 로그인**에서 자격 증명 획득부터 세션 활성화까지 앱 코드를 구현합니다.
- 로그인 화면을 열 때 지원하는 로그인 수단 조회를 호출하고, 반환된 로그인 수단만 버튼으로 노출합니다.
Note
Google Play Games는 외부 콘솔을 준비하기 전에 앱 서버 리다이렉트 URI를 먼저 정해야 합니다. 그다음 Google Play Games 행의 순서대로 진행하세요.
| 로그인 수단 | 외부 인증 제공자 준비 | Hive 콘솔 등록 |
|---|---|---|
| Google 계정 | Google 로그인 인증 정보 확인 | Google 로그인 인증 정보 |
| Apple | Apple 로그인 연동 | Apple 로그인 인증 정보 |
| Google Play Games | Google Play Games 로그인 인증 정보 확인 | Google Play Games 로그인 인증 정보 |
| Steam | Steam App ID 등록과 로그인 연동 | Store App ID 등록과 Steam 로그인 인증 정보 |
| X(Twitter) | X 로그인 연동 | X(Twitter) 로그인 인증 정보 |
커스텀 계정 로그인은 외부 인증 제공자와 Hive 콘솔 인증 정보 등록이 필요하지 않습니다. 커스텀 계정으로 로그인에서 앱 서버와 앱 클라이언트 구현을 진행하세요.