Authentication#

Matchmaker에서는 다음 두 가지 방법으로 인증할 수 있습니다.

• 플레이어 인증
• 서비스 계정 인증

플레이어 인증#

플레이어 인증은 Unity Authentication을 사용하여 플레이어 기반 매치메이킹을 활성화하므로, 게임 클라이언트가 Matchmaker 서비스에 티켓 생성을 요청할 수 있습니다.

먼저 Authentication 서비스를 초기화하고 로그인한 다음 Matchmaker SDK를 사용하여 호출해야 합니다.

다양한 방법으로 로그인할 수 있으며, 가장 간단한 방법은 익명 로그인을 사용하는 것입니다.

서비스 계정 인증#

서비스 계정 인증은 백엔드 서비스가 게임 클라이언트를 대신해 매치메이킹 티켓을 생성할 때 사용됩니다. 이 방식은 스킬 값 같은 서버 권한 데이터를 매치메이킹 티켓에 추가해야 할 때 유용합니다.

서비스 계정을 생성하려면 이 지침을 따르십시오.

Matchmaker에서 서비스 계정을 사용하려면 이 단계를 따르십시오.

다음은 일반적인 서비스 간 인증 플로의 예시입니다.

1. 위의 플레이어 인증 섹션에서 설명한 것과 같이 클라이언트가 익명 인증을 수행합니다.

2. 클라이언트가 PlayerId를 파라미터로 사용하여 커스텀 백엔드 서버를 호출합니다.

3. 커스텀 백엔드 서버가 impersonate-user-id 헤더를 PlayerId 값으로 설정하고 티켓 생성 경로를 호출합니다.

   curl --location --request POST 'https://matchmaker.services.api.unity.com/v2/tickets' --header 'Content-Type: application/json' --header 'Authorization: {{SERVICE-ACCOUNT-TOKEN}}'
    --header 'impersonated-user-id: {{PLAYER-ID}}' --data-raw '{ "players": [ { "id": "{{PLAYER-ID}}", "customData": { "Skill": {{ENRICHED-DATA}} } } ] }'

4. 커스텀 백엔드 서버가 티켓 ID를 클라이언트에 다시 전송합니다.

5. 클라이언트가 클라이언트 SDK를 사용해 티켓 상태를 폴링합니다.