Documentation

Support

Cloud Content Delivery

Open Unity Dashboard

Cloud Content Delivery

Authentication

Use a service account to authenticate with Cloud Content Delivery and understand the required roles for secure API access.
Read time 1 minuteLast updated 17 hours ago

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

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 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