Service users provide a secure alternative to using personal credentials for API access. This approach addresses security and audit concerns by enabling least-privilege permissions and better access control.
- Eliminates security risks from shared personal credentials
- Provides audit trail for API access
- Enables granular permission control through user groups
- Supports least-privilege access principles
Create service users
- Click tab.
- Select the Users tab.
- Click Create Service User.
- Enter a service username (for example, "finance team").
- Optionally add a description.
- Optionally assign user groups to define permissions. Note: Service users cannot be assigned to the workspace owner group.
- Click Create to save the user or Create another to create additional users.
Edit service users
Service users control which APIs and resources the account can access. All API keys for the service account inherit these permissions. When you change permissions, the changes apply immediately to all keys.
- Click .
- Select the Users tab.
- Click the ellipsis next to the service user for which you want to edit the details and click edit.
- You can edit the user details, assigned user groups, roles and security policies as required. Additionally, you may choose to regenerate or delete the existing API key. Regenerating the API key will retain the key's ID , and will only regenerate the API Secret. Note: Copy the secret immediately and store it securely. The secret is displayed only once and cannot be retrieved later.
- Once modified, click Save to apply the details to the service user.
Managing API keys for service users
Managed service accounts enable organizations to create service users with granular, API-level permissions for secure integrations and third-party access without using personal API keys.
Each service account can have up to two API keys. You can use multiple keys to support key rotation without disrupting integrations. Keys inherit all permissions from their associated service account.
To generate API keys for the service users
-
Click .
-
Within the Users tab, select the service user for which you want to generate the API key.
-
Within the details tab, navigate to the API key section and click Generate API Key.
-
Enter a name for the API key.
-
Click Generate.
The API key is now created and active. You can use it for integration and authentication. The key inherits all permissions from the service account.