Documentation

Support

Authentication

Get started

Open Unity Dashboard

Authentication

Get started

Follow this workflow to create a Unity account, link your project, and install the SDK to get started with Unity Authentication.
Read time 2 minutesLast updated 18 hours ago
To use Authentication, you need to:
  1. Sign up for UGS.
  2. Link your dashboard to a Unity Editor project.
  3. Install the SDK in your game code.
  4. Initialize the SDK.

Sign up

If you don't have a Unity account, create one and create a new project to sign up for Unity Gaming Services.
  1. Sign into the Unity Dashboard.
  2. Select Administration in the side panel.
  3. Select Sign Up in the top banner and follow the instructions.

Link your project

Link your project to a Unity Cloud project in the Unity Editor through a project ID. Follow these steps to get your project ID.
  1. In the Unity Editor menu, select Edit > Project Settings > Services tab.
  2. If you’re not already signed in with your Unity ID, either create a new Unity ID or sign in.
  3. To create a new project, select your organization and select Create. To link to an existing project, select I already have a Unity Project ID. Then, select your organization and project from the dropdown, and select Link.
Now you can find your project ID from the Settings tab in the Services window.

Install the SDK

To install the latest Authentication package for Unity:
  1. In the Unity Editor, open Window > Package Manager.
  2. In the Package Manager, select the Unity Registry list view.
  3. Search for Authentication, or locate it in the package list.
  4. Select the package, then select Install.
Refer to the Package Manager documentation for more information.

Initialize the Unity Services SDK

To implement Unity Authentication in your game, initialize all the Unity Services SDKs included in the project following this code snippet: 
using System;using Unity.Services.Core;using UnityEngine;public class InitializationExample : MonoBehaviour{	async void Awake()	{		try		{			await UnityServices.InitializeAsync();		}		catch (Exception e)		{			Debug.LogException(e);		}	}}

Register authentication events

To receive updates about the status of your player, register a function to the 
SignedIn
, 
SignInFailed
and 
SignedOut
event handlers. 
// Setup authentication event handlers if desiredvoid SetupEvents() {  AuthenticationService.Instance.SignedIn += () => {    // Shows how to get a playerID    Debug.Log($"PlayerID: {AuthenticationService.Instance.PlayerId}");    // Shows how to get an access token    Debug.Log($"Access Token: {AuthenticationService.Instance.AccessToken}");  };  AuthenticationService.Instance.SignInFailed += (err) => {    Debug.LogError(err);  };  AuthenticationService.Instance.SignedOut += () => {    Debug.Log("Player signed out.");  };  AuthenticationService.Instance.Expired += () =>    {        Debug.Log("Player session could not be refreshed and expired.");    };}