Service accounts#

Service accounts let you programmatically call Unity Services APIs, including the Multiplay API. You can create any number of service accounts, each with one or more project roles.

Service account roles#

Service accounts support role-based access control (RBAC) through project roles. These roles give the service account permissions to perform specific activities, such as managing allocations. If you try to use a service account for something it doesn't have permission to do, the API call authorization fails.

Refer to Project roles for more information about specific roles.

Create a service account#

The following steps create a service account for allocating and deallocating servers:

1. Sign into the Unity Dashboard.
2. Go to Projects > Service Accounts.

1. Select Create service account.

1. Name the service account and, optionally, add a description.
2. Select Create.

1. Go to Project roles, then select Add project role.

1. Select the name of your project.

1. Locate Multiplayer, then select Multiplay Allocations Admin.

Multiplay Allocations Admin is under Project roles.

Generate a service account key#

To generate an authentication key pair for a service account:

1. Sign into the Unity Dashboard.
2. Go to Projects > Service Accounts.
3. Open the More (⋮) menu for the service account to create a key, then select Edit. If you don’t already have a service account, refer to Create a service account.

1. Under Keys, select Create key.

1. This automatically generates a Key ID and Secret key pair for the service account. Save both the Key ID and the Secret key in a safe location.

1. Select Done.
2. View Authentication for more information on using these credentials on API requests.