Services
Services allow 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.
For use cases that only require pull/read access to a repository, you may wish to 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":
![Screenshot 2023-01-13 at 17.35.12.png 1344](https://files.readme.io/cd599fa-Screenshot_2023-01-13_at_17.35.12.png)
Services
You are then presented with the Service creation form. Just give your Service a name, and optionally add a description and choose any teams in your organization that you wish to add the service to.
![Screenshot 2023-01-13 at 17.37.24.png 654](https://files.readme.io/a9f0a05-Screenshot_2023-01-13_at_17.37.24.png)
Service Creation Form
Get Service API Key
To obtain the Service API Key, click the key itself to reveal it or click the paperclip icon to copy the key:
![Screenshot 2023-01-13 at 17.38.00.png 1353](https://files.readme.io/c462cf6-Screenshot_2023-01-13_at_17.38.00.png)
Service Account API key
Get Service Username
The Service username is displayed under the Service Name:
![Screenshot 2023-01-13 at 17.40.14.png 1436](https://files.readme.io/9e86974-Screenshot_2023-01-13_at_17.40.14.png)
Service Username
Refresh a Service API Key
Click the orange "Refresh API Key" button to generate a new Service API Key.
![Screenshot 2023-01-13 at 17.41.11.png 1371](https://files.readme.io/f2195cb-Screenshot_2023-01-13_at_17.41.11.png)
Refresh Service Button
You must then confirm that you wish to refresh the Service API Key
![refresh-service-account-form.png 1296](https://files.readme.io/451407c-refresh-service-account-form.png)
Refresh Service Confirmation
Delete a Service
Click the red "Delete Service" button to permanently delete the Service and its associated API Key:
![Screenshot 2023-01-13 at 17.42.36.png 1363](https://files.readme.io/0188aac-Screenshot_2023-01-13_at_17.42.36.png)
Delete Service Button
You must then confirm that you wish to delete the Service:
![Screenshot 2023-01-13 at 17.43.40.png 650](https://files.readme.io/45c6aad-Screenshot_2023-01-13_at_17.43.40.png)
Delete Service Confirmation
Updated over 1 year ago