Store secrets using the Unity Dashboard

Create, configure, and store secrets securely.

Read time 4 minutes

Last updated 4 months ago

You can manage secrets in the Unity Dashboard. Secrets are stored in a hierarchy that aligns with the structure of Unity Cloud projects, consisting of organizations, projects, and environments.

Ensure permissions

To store secrets, you need the appropriate permissions. You must be a member of the organization and have the necessary roles to access the secrets. If you don't have the required permissions, contact your organization's or project's owner. Refer to Grant roles for more information.

Navigating the dashboard

You can find secrets in three different levels: organization, project, and environment. Each level has its own secrets. Each level will display the inherited secrets from the level above it. For example, project-level secrets inherit from organization-level secrets.

View organization-level secrets

At the organization level, you can view all the secrets that are accessible to all projects in the organization. To access the organization level secrets, follow these steps:

In the Unity Dashboard, open the Account menu and select Manage organization.
In the Administration menu, select Secrets.

View project-level secrets

At the project level, you can view all the secrets that are accessible to all environments in the project, and inherited secrets from the organization level. To access the project level secrets, follow these steps:

In the Unity Dashboard, select Home > Projects.
Select the project you want to view secrets for.
Select Development > Secrets.

View environment-level secrets

At the environment level, you can view all the secrets that are accessible to the environment in the project, and inherited secrets from the project and organization levels. To access the environment level secrets, follow these steps:

In the Unity Dashboard, select Home > Projects.
Select the project you want to view secrets for.
Select Development > Environments.
Select the environment you want to view secrets for.
Select Secrets.

Managing secrets

The section below provide a walkthrough on secret management in the Unity Dashboard. Most of these operations are available at the organization, project, and environment levels. A secret override cannot be created at the organization level, as there is nothing to override.

Add a secret

To create a secret, navigate to a level where you want to store the secret. Follow these steps:

Select the
```
Add secret
```
button.
Provide a unique key for the secret.
Provide a description for the secret (optional).
Enter the value of the secret.
Select the dropdown to choose which Unity services can access the secret. You can select multiple services. For more information, refer to Service access.
Select the
```
Add
```
button.

Warning

You cannot view the value of a secret after you create it. However, you can edit the secret to change the value.

When you add a secret, it is stored at the level where you created it. The lower levels inherit the secret from the level above it.

Override a secret

A secret override allows you to create a secret at a lower level that takes precedence over the secret at a higher level. You can only override a secret at the project and environment level. To learn more about overrides, refer to Override secrets.

To create an override, follow these steps:

Navigate to the secret table for the level where the secret is stored.
Select the triple dots icon for the secret you want to override.
Select the
```
Override secret
```
option.
Provide a new value and description for the secret.
Select the
```
Override
```
button.

Alternatively, you can prompt the override creation process when you are adding a new secret. If the key you enter already exists at a higher level, you will be prompted to create an override.

Edit a secret

To edit a secret, navigate to the secret table for the level where the secret is stored. Select the edit icon for the secret you want to edit, and modify the secret value, the description, or both. Select the

Edit

button to save the changes.

Delete a secret

To delete a secret, navigate to the secret table for the level where the secret is stored. Select the

Delete

icon for the secret you want to delete, and confirm the operation. If you delete an override, the secret reverts to the value stored at the level above it.

Warning

Deleting a secret that is in use by a service may cause the service to malfunction or stop working.

Documentation

Development

User Acquisition

Monetization

Industry