ClearML/clearml-docs
1
0
Fork 0
mirror of https://github.com/clearml/clearml-docs synced 2025-06-11 09:05:37 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Enable setting service users as admins

Browse Source
This commit is contained in:
revital 2025-05-18 07:55:32 +03:00
parent 31a74f8b56
commit f1006f7074
1 changed files with 20 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/webapp/settings/webapp_settings_users.md
View File

@ -92,7 +92,7 @@ Service accounts are members of the `Users` group, meaning they can access the r
impersonation is enabled, a task run by the service account (i.e. by an agent or autoscaler using the service accounts'
credentials) is executed as if by the owner of the task, meaning it will have access to the task owner's configuration
vaults and to the resources that the task owner has access to. Impersonating an admin user does not mean the task's code
will have admin privileges.
will have admin privileges (see [Setting a Service Account as Administrator](#setting-a-service-account-as-administrator)).
In case impersonation is not enabled:
* If you run an agent with `--use_owner_token` then the agent will fail.
@ -103,6 +103,25 @@ In case impersonation is not enabled:
When a service account is created, an initial set of credentials is automatically generated. The dialog displays new
credentials, formatted as a ready-to-copy configuration file section.
### Setting a Service Account as Administrator
You can grant a service account administrator privileges, giving it the same access and capabilities as an admin user.
#### Prerequisite: Enable Admin Privileges for Service Accounts
To allow admin roles to be assigned to service accounts, you must enable support for admin service accounts on the server
in one of the following ways:
* **Set as an environment variable**: Set `CLEARML__services__organization__allow_service_user_admins=true` in the `apiserver` service environment
* **Edit the services/organization.conf file**: Set `allow_service_user_admins: true`
#### Assigning Admin Role to a Service Account
To assign an admin role to a service account:
1. Go to the **Service Accounts** table.
1. Click the service account you want to modify to open its details panel.
1. Select **Admin** toggle to grant administrator access.
### Service Account Credentials
To generate new credentials for a service account: