Service Accounts

Services let you to create a Cloudsmith API Key not tied to a specific user. Services are ideal for any use case where you have automated processes (such as a CI/CD pipeline or similar) that requires write access to a repository.

If your use case only requires pull or read access to a repository, use an Entitlement Token.

Note

To create or manage Services for your organization, you need to have Owner or Manager permissions.

Create a Service

To create a Service, go to Services on your Cloudsmith organization's accounts page, and click "Create Service":

Fill Out the Service Creation Form: Enter a Name for your Service. Optionally, add a Description and select any Teams in your organization to associate with the Service.

Get Service Username

The Service username is displayed in the NAME column:

Get Service API Key

Copy Your API Key Immediately:

• Immediately copy the API key to your clipboard after it is created and store it securely.
• You will not be able to retrieve the API key again from Cloudsmith. However, you can rotate the key if needed.

Securely Store Your API Key

Use a trusted password manager or a dedicated secrets vault to store your API key securely.

Refresh a Service API Key

If you lose your API key or suspect it has been compromised, you'll need to refresh or rotate the key to generate a new one.

**How to Rotate: **Return to the Accounts->Services section, Under the API KEY column select the affected key, and click the "Refresh API Key" button to generate a new Service API Key.

You must then confirm that you wish to refresh the Service API Key

Delete a Service

Click the red "Delete Service" button to permanently delete the Service and its associated API Key:

You must then confirm that you wish to delete the Service: