# 커스텀 ID로 로그인

> Sign in users to Vivox with custom identifiers.

플레이어 ID를 생성하는 기존 플레이어 관리 시스템이 이미 있는 경우 커스텀 ID 제공자를 사용하여 ID를 연결할 수 있습니다.

> **Important:**
>
> **중요**: [Authentication 패키지 설정](../../../developer-guide/vivox-unity-sdk-basics/sign-in-with-authentication-package)이 사용 사례에 적합하지 않고 커스텀 플레이어 ID에 플레이어를 연결하려는 경우에만 이 플로를 사용하십시오.

**필수 조건**:

1. [Unity Cloud 프로젝트 설정](/services/getting-started.md)
   * 프로젝트 ID, 개발 환경 ID, 개발 환경 이름이 있어야 합니다.
2. [UAS 커스텀 ID 제공자 활성화](/authentication/platform-signin/custom-id.md) 이 설정에서 서비스 계정 인증정보를 손쉽게 사용할 수 있어야 합니다.

이 설정의 전반적인 플로는 다음과 같습니다.

![](/api/media?file=/vivox-unity/media/images/sign-in-with-custom-ids.png)

로그인

1. 모든 사용자를 로그인 시 UAS 커스텀 ID 제공자에 등록하고 플레이어용 `accessToken`과 `sessionTokens`를 검색합니다.
2. `accessToken`과 `sessionToken`을 사용하여 클라이언트에서 AuthenticationService를 설정합니다.

## 클라이언트 측 설정##client-side-setup

아래에 추가로 설정된 서버 측 로그인과 함께 백엔드에서 액세스 토큰을 검색하여 `AuthenticationService`로 처리해야 합니다.

`ProcessAuthenticationTokens`를 통해 Unity Authentication 서비스 액세스 토큰을 처리하고, 게임에 연동된 플레이어 인증이 필요한 다른 UGS SDK에서 토큰을 사용할 수 있습니다. 액세스 토큰이 만료되었으므로 액세스 토큰을 수동으로 새로 고친 후 새 액세스 토큰으로 `ProcessAuthenticationTokens`를 호출해야 합니다. 액세스 토큰과 세션 토큰을 모두 사용하여 `ProcessAuthenticationTokens`를 호출할 수 있습니다. Unity Authentication SDK는 액세스 토큰이 만료되기 전에 액세스 토큰을 새로 고치고, 플레이어의 세션을 활성 상태로 유지하고, 캐시된 플레이어로 로그인 을 활성화합니다.

```cs
using Unity.Services.Authentication;
using Unity.Services.Vivox;

void SignUserWithCustomTokenWithAutoRefresh()
{
    try
    {
        // Check if a cached player already exists by checking if the session token exists
        if (AuthenticationService.Instance.SessionTokenExists)
        {
            // This call will sign in the cached player.
            await AuthenticationService.Instance.SignInAnonymouslyAsync();
            Debug.Log("Cached user sign in succeeded!");
        }
        else
        {
            var userTokens = // Fetch the user tokens using your method calls
            AuthenticationService.Instance.ProcessAuthenticationTokens(userTokens.AccessToken, userTokens.SessionToken)
        }
        // Shows how to get the playerID
        Debug.Log($"PlayerID: {AuthenticationService.Instance.PlayerId}");

        await VivoxService.Instance.InitializeAsync();
    }
    catch (AuthenticationException ex)
    {
        // Compare error code to AuthenticationErrorCodes
        // Notify the player with the proper error message
        Debug.LogException(ex);
    }
    catch (RequestFailedException ex)
    {
        // Compare error code to CommonErrorCodes
        // Notify the player with the proper error message
        Debug.LogException(ex);
    }
    catch (Exception ex) {
        // Handle exceptions from your method call
        Debug.LogException(ex);
    }
}
```

샘플 코드는 클래스가 아니라 메서드뿐임을 유의해 주십시오.

액세스 토큰은 백엔드에서 검색해야 합니다. 자세한 내용은 아래 [서버 측 설정](#server-side-setup)을 참고하시기 바랍니다.

## 서버 측 설정##server-side-setup

플레이어가 로그인하는 동안 각 플레이어가 UAS 커스텀 ID 제공자에 등록되어 있는지 확인하고 플레이어의 `accessToken`과 `sessionToken`을 검색합니다. 아직 설정하지 않았다면 [UAS 커스텀 ID 제공자 활성화](/authentication/platform-signin/custom-id.md)를 참고하여 설정합니다. 서비스 계정 인증정보를 사용하여 게임 서버에 플레이어를 등록하기 위한 요청을 보낼 수 있습니다.

1. [토큰 교환 API](https://services.docs.unity.com/docs/service-account-auth/#authenticate-an-api-using-a-stateless-token)를 호출하여 상태 비보존 토큰을 검색합니다.
2. [커스텀 ID API로 로그인](https://services.docs.unity.com/player-auth/v1/#tag/Player-Authentication/operation/SignInWithCustomID)을 호출합니다.

```bash
curl --location 'https://player-auth.services.api.unity.com/v1/projects/<PROJECT_ID>/authentication/server/custom-id' \
--header 'Content-Type: application/json' \
--header 'UnityEnvironment: <ENVIRONMENT_NAME>' \
--header 'Authorization: Bearer <STATELESS_TOKEN' \
--data '{
    "externalId": "YOUR_CUSTOM_PLAYER_ID"
}'
```

이 요청의 응답에는 `AuthenticationService`를 초기화하기 위해 클라이언트에 반환해야 하는 `idToken`과 `sessionToken`이 포함됩니다. 이 컨텍스트에서는 `idToken`을 `accessToken`으로 사용할 수 있습니다.

선택적으로 [플레이어 이름 API](https://services.docs.unity.com/player-names/v1/#tag/Player-Names/operation/updateName)를 사용하여 플레이어의 이름을 설정할 수 있습니다. 이 기능은 Vivox Safety 제품을 사용하는 경우 Moderation 대시보드에서 플레이어 이름을 운영자에게 표시할 수 있으므로 유용합니다. 플레이어가 이름을 변경하는 경우 플레이어 이름을 최신 상태로 유지해야 합니다. [플레이어 이름 관리](/authentication/player-name-management.md)를 사용하여 클라이언트 측에서 플레이어 이름을 직접 관리할 수도 있습니다.