Authentication

Service account

To authenticate with the service, you need to use a service account. Ensure that your service account has the appropriate roles assigned for the required access levels:

  • Organization Role: Cloud Content Delivery API Public Editor grants read and write access to public endpoints of the CCD Management API.
  • Project Role: Unity Environments Viewer grants read access to all environments in a project.

For instructions on how to create and use service accounts, refer to the Service Account Authentication documentation.

API Key

The API Key is officially deprecated and will no longer receive updates. We recommend all users to transition to service accounts

An alternative way to authenticate with the Content Delivery Management API is to use an API Key linked to your Unity developer account. To retrieve your API Key from the Unity Cloud Dashboard, select the API Key tab and select the Copy API Key to Clipboard icon. When you make a request with the API Key, you need to do the following:

  • Include a Basic Authentication header as a base64-encoded string in the format 'username:password'.
  • Use the API Key as the password.
  • Leave the username blank.

For example, with the API key d6d2c026bac44b1ea7ac0332694a830e, you include the following Authorization header:

Authorization: Basic OmQ2ZDJjMDI2YmFjNDRiMWVhN2FjMDMzMjY5NGE4MzBl