토큰 허가(OAuth)¶

Strix Cloud는 OAuth로 구성할 수 있으므로 플레이어 계정 관리 목적으로 자체 메서드를 통해 연결 허가가 가능합니다.

OAuth 작동 원리에 관해서는 OAuth RFC를 참조해 주십시오.

허가 활성화¶

OAuth는 Strix Cloud 웹 콘솔의 애플리케이션 페이지에서 [옵션] 탭 아래 [허가 활성화됨] 상자를 체크하고 [사용자 리소스 URL], [사용자 ID 키], [이름 키]를 지정하면 활성화할 수 있습니다.

Authorization enabled and related settings

허가 이용¶

OAuth가 애플리케이션에서 활성화되면 허가 액세스 토큰을 다음과 같이 StrixNetwork 싱글톤으로 설정해야 합니다.

StrixNetwork.instance.authorizationAccessToken = myToken;

클라이언트는 로그인 후에 허가 제공자로부터 토큰을 받아야 합니다. Strix 서버는 Strix Cloud 웹 콘솔에서 지정한 설정에서 리소스 서버 정보를 가져오고 리소스 서버에 리소스를 요청합니다.

리소스 서버에서 오는 응답은 다음과 같은 JSON입니다.

{
    "name" : "logged in user name",
    "userId" : 1
}

서버에서 적절한 JSON 개체와 함께 http OK 응답을 받으면 현재 방 멤버 name 속성과 추가 userId 커스텀 속성을 응답 속의 값으로 설정합니다. 이 값은 네트워크 초기화 중에는 덮어쓰기할 수 없습니다. 이것은 http 액세스 토큰이 있는 사용자의 이름과 ID를 나타냅니다.

http 오류 응답을 수신할 경우 방 서버에 대한 연결은 실패합니다. 네트워크는 멈췄다가 다시 시작해야 하며, 연결을 재시도합니다.

참고

서버 측에 사용자 ID 키와 이름 키를 설정해 두면 특정 JSON 키(위 예에서는 “name”과 “userId”)의 실제 이름을 허가 서버와 맞출 수 있습니다.