# 인증 서비스 연동

# 인증 서비스 연동 flow

사전체크사항

  1. 사용자 인증 토큰을 받기 위해서는 해당 게임의 게임이용약관 동의가 되어 있어야 합니다.

Stove SDK 함수는 native 기준

  1. 게임 클라이언트는 PC SDKGetToken()를 통해 access Token 획득합니다. (위 그림의 5, 6번 과정)
  2. 게임 클라이언트는 access Token을 게임 서버로 전달합니다. (위 그림의 7번 과정)
  3. 게임 서버는 Game User Access Token 유효성 검증를 호출하여 유저의 유효함을 확인합니다. (위 그림의 8, 9번 과정)

# Access Token 획득 - 게임 클라이언트

  1. 게임 클라이언트는 PC SDK를 통해 GetToken()를 통해 access Token 획득합니다.(위 그림의 5번 과정)
    • access Token의 유효기간은 6시간입니다.
    • PC SDK는 유효기간의 만료 전에 OnRenewToken() callback을 통해 새로운 access Token을 가지고 있습니다.
  2. 정상적으로 처리되면, OnToken() Callback이 호출되며, StovePCToken구조체에 토큰 문자열이 포함됩니다.(위 그림의 6번 과정)

주의사항

게임서버에서 access Token을 사용할 경우,
게임 클라이언트에서 PC SDKGetToken()을 호출하여, 최신 access Token을 얻어와 게임 서버에 전달하여 사용해야 합니다.

PC SDKGetToken() 함수로 로그인한 사용자의 토큰 정보를 얻어 옵니다.

StovePCResult result = StovePC_GetToken();
if (result == StovePCResult::STOVE_PC_NO_ERROR)
{
    /*성공 처리*/
}
1
2
3
4
5

GetToken() 함수가 정상적으로 처리되면 OnToken() 콜백이 호출됩니다.
콜백에 전달되는 StovePCToken 구조체에는 토큰 문자열이 포함되어 있습니다.

void OnToken(const StovePCToken token)
{
    /*토큰 정보 출력*/
    printf("Token : %s", token.accessToken);
}
1
2
3
4
5

토큰이란?

런처 로그인을 통해 발급되는 key 정보 입니다.
PC SDK 내부에서 토큰 정보를 관리하므로, 특별한 이유가 없다면 개발사에서 사용할 필요는 없습니다.

# Access Token 유효성 확인 - 게임 서버

  • 게임 클라이언트는 access token을 게임서버로 전달합니다. (위 그림의 7번 과정)
  • 게임 서버는 Game User Access Token 유효성 검증를 호출하여 유저의 유효함을 확인합니다. (위 그림의 8, 9번 과정)
Last Updated: 2023. 9. 8. 오전 7:07:04