Hub/docs/serverAPI/guest create

 

guest/create

Description

  • Playfirst System에 사용하는 새로운 게스트 식별자를 발급한다.
    • 새로 발급 받은 게스트 실별자는 게임이 설치된 동안에만 유효하며 게임 삭제 후 재설치시 새로운 식별자가 발급된다.
    • 게스트 식별자는 디바이스 및 게임에 매칭된다.


Parameters

  • N/A(Hub 모듈 내에서 자체적으로 HTTP 쿠키에 실어 전송하는 디바이스 정보 및 게임인덱스 값만을 받음)


출력 JSON

  • guest_uid: 새롭게 생성된 게스트 식별자(string)
  • did: 디바이스 ID(string)
{
    "type": "guest/create",
    "error_code": 0,
    "guest_uid": "9000001371",
    "did": "27162811"
}


에러 메시지

  • 디바이스 등록 실패 / 게스트 식별자 발급 실패
{
    "type": "guest/create",
    "error_code": 1101,
    "error_msg": "Database error occured."
}
  • 차단된 디바이스
{
    "type": "guest/create",
    "error_code": 1400,
    "error_msg": "This service to device is denied."
}


Related Method


게스트 식별자 발급 프로세스 보안 기능 강화

  • 적용된 Peppermint 버전
    • Android Peppermint v2.6.11, iOS Peppermint v2.6.9
  • 내용
    • 게스트 식별자 발급 프로세스에 보안 기능을 추가하여 무분별한 API 호출과 악의적인 공격에 대비할 수 있도록 보안 기능을 강화하였습니다.
    • 게스트 식별자 발급은 RSA 암호화 로직을 사용합니다. Peppermint 모듈은 게스트 식별자 발급에 필요한 데이터를 공개키(public key)로 암호화하여 암호문을 서버에 전달하고, 서버는 서버만 가지고 있는 개인키(private key)로 암호문을 평문으로 해독합니다. 서버는 해독된 데이터를 확인하여 게스트 식별자 발급이 가능한 상태 여부를 확인 후 다시 Peppermint 모듈로 결과를 전달합니다.
    • Peppermint 모듈을 적용하는 게임 클라이언트에서 별도로 대응해야하는 부분은 없습니다. 기존과 동일하게 guest/create API 요청 시 API 호출 결과를 콜백으로 전달하게 됩니다.