Authentication
Learn how authentication works in Matchmaker to securely identify and authorize players.
읽는 시간 1분최근 업데이트: 3달 전
중요
Unity Matchmaker는 현재 Multiplay 호스팅이나 Relay 및 분산된 권한과 같은 Unity가 제공하는 클라이언트 호스팅 솔루션을 지원합니다. 이 팀은 타사 호스팅 제공업체(Rocket Science의 Multiplay 등)에 대한 지원을 확장하고 있으며, 이 지원을 2026년 3월 31일 이전에 제공하려고 합니다. Matchmaker 계속 Relay와 Distributed Authority와 협력합니다.
- 플레이어 인증
- 서비스 계정 인증
플레이어 인증
플레이어 인증은 Unity Authentication을 사용하여 플레이어 기반 매치메이킹을 활성화하므로, 게임 클라이언트가 Matchmaker 서비스에 티켓 생성을 요청할 수 있습니다. 먼저 Authentication 서비스를 초기화하고 로그인한 다음 Matchmaker SDK를 사용하여 호출해야 합니다. 다양한 방법으로 로그인할 수 있으며, 가장 간단한 방법은 익명 로그인을 사용하는 것입니다.서비스 계정 인증
서비스 계정 인증은 백엔드 서비스가 게임 클라이언트를 대신해 매치메이킹 티켓을 생성할 때 사용됩니다. 이 방식은 스킬 값 같은 서버 권한 데이터를 매치메이킹 티켓에 추가해야 할 때 유용합니다. 서비스 계정을 생성하려면 이 지침을 따르십시오. Matchmaker에서 서비스 계정을 사용하려면 이 단계를 따르십시오. 다음은 일반적인 서비스 간 인증 플로의 예시입니다.- 위의 플레이어 인증 섹션에서 설명한 것과 같이 클라이언트가 익명 인증을 수행합니다.
-
클라이언트가 를 파라미터로 사용하여 커스텀 백엔드 서버를 호출합니다.
PlayerId -
커스텀 백엔드 서버가 헤더를
impersonate-user-id값으로 설정하고 티켓 생성 경로를 호출합니다.PlayerIdcurl --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}} } } ] }' - 커스텀 백엔드 서버가 티켓 ID를 클라이언트에 다시 전송합니다.
- 클라이언트가 클라이언트 SDK를 사용해 티켓 상태를 폴링합니다.