비밀번호 없는 권한 인증

이 가이드에서는 플레이어가 게임 앱을 통해 인증을 받도록 하여 사용자가 유저 ID를 수동으로 입력할 필요 없이 게임 허브에 원활하게 접근할 수 있도록 하는 방법을 설명합니다.

전제 조건

• 요청 인증을 위한 활성화된 서버 간(S2S) API 키가 필요합니다.

1단계: 게임 클라이언트에서 권한 부여 딥링크 가로채기

플레이어가 로그인 버튼을 클릭하면 게임 허브가 해당 게임의 딥링크로 리디렉션합니다. URL 형식은 다음과 같습니다:

mygame://authorize-player?nonce={nonce}

여기서 {nonce}는 각 인증 요청마다 게임 허브에서 생성되는 고유한 문자열입니다.

게임 클라이언트는 딥링크를 가로채서 URL에서 nonce 매개변수를 추출해야 합니다. 이 nonce는 게임 백엔드에 대한 권한 부여 요청에 사용됩니다.

2단계: 게임 백엔드로 권한 부여 요청 전달

플레이어가 인증된 세션을 시작한 후, 게임 클라이언트는 게임 백엔드에 권한 요청을 전송해야 합니다.

3단계: Aghanim에게 권한 요청을 전송하기

게임 클라이언트로부터 요청을 받으면 게임 백엔드는 엔드포인트 Authorize User를 사용하여 Aghanim API에 POST 요청을 보내야 합니다. 요청에 다음 매개변수를 포함하세요:

매개변수	설명	필수 여부
player_id	인증받을 플레이어의 고유 식별자.	예
nonce	게임 허브에서 제공하는 고유 문자열.	예
redirect_path	플레이어를 리디렉션할 게임 허브 페이지.	아니오

예시 요청

curl --request POST \
  --url https://api.aghanim.com/s2s/v1/users/authorize \
  --header 'Authorization: Bearer YOUR_S2S_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "player_id": "2D2R-OP3C",
    "nonce": "N2Q3Y2MGI6bQ"
  }'

예시 응답

{
  "authorization_url": "https://your-game-hub/go/login?token=dXNyX...FTV0xqTWg&nonce=N2Q3Y2MGI6bQ"
}

4단계: 플레이어를 인증 URL로 리디렉션

게임 백엔드는 Aghanim으로부터 authorization_url을 받으면, 이 URL을 다시 게임 클라이언트로 전달해야 합니다. 그런 다음 게임 클라이언트는 기본 브라우저를 실행하고 인증 URL을 열어야 합니다. 이 동작으로 플레이어의 게임 허브 인증이 완료됩니다.

도움이 필요하세요?
통합팀에 문의하십시오 integration@aghanim.com