Links

User Permissions

Like any enterprise product, Devtron supports fine grained access control to the resources based on:
  1. 1.
    Type of action allowed on Devtron resources (Create Vs View)
  2. 2.
    Sensitivity of the data (Editing image Vs Editing memory)
Access can be added to the User either directly or via Permission groups.

Role-based Access Levels

Devtron supports the following levels of access:
  1. 1.
    View only: User with View only access has the least privilege. This user can only view combination of environments, applications and helm charts on which access has been granted to the user. This user cannot view sensitive data like secrets used in applications or charts.
  2. 2.
    Build and Deploy: In addition to View only access, user with Build and deploy permission can build and deploy the image of the permitted applications and helm charts to the permitted environments.
  3. 3.
    Admin: User with Admin access can create, edit, delete and view permitted applications in the permitted projects.
  4. 4.
    Manager: User with Manager access can do everything that an Admin type user can do, in addition, they can also give and revoke access of users for the applications and environments of which they are Manager.
  5. 5.
    Super Admin: User with Super admin privilege has unrestricted access to all Devtron resources. Super admin can create, modify, delete and view any Devtron resource without any restriction; its like Superman without the weakness of Kryptonite. Super Admin can also add and delete user access across any Devtron resource, add delete git repository credentials, container registry credentials, cluster and environment.

User Roles And Permissions

1. Custom Applications

User Roles
View
Create
Edit
Delete
Build & Deploy
View
Yes
No
No
No
No
Build and Deploy
Yes
No
No
No
Yes
Admin
Yes
Yes
Yes
Yes
Yes
Manager
Yes
Yes
Yes
Yes
Yes
Super Admin
Yes
Yes
Yes
Yes
Yes

2. Helm Charts

User Roles
View
Deploy
Edit
Delete
View Only
Yes
No
No
No
View and Edit
Yes
Yes
Yes
No
Admin
Yes
Yes
Yes
Yes
Super Admin
Yes
Yes
Yes
Yes

3. User Access

User Roles
Add User Access
Edit User Access
Delete User Access
Manager
Yes
Yes
Yes
Super Admin
Yes
Yes
Yes

4. Global Configurations

User Role
Add Global Config
Edit Global Config
Delete Global Config
Super Admin
Yes
Yes
Yes

Add User

To add a user, go to the Authorization > User Permissions section of Global Configurations. Click Add user.
There are two types of permissions in Devtron:
Permission Type
Description
Specific permissions
Selecting Specific permission option allows you to manage access and provide the role-based access accordingly for:
  • Devtron Apps
  • Helm Apps
  • Kubernetes Resources
  • Chart Groups
Super admin permission
Selecting Super admin permission option will get full access to Devtron resources and the rest of the options will not be available.

Assign Super admin permission

To assign a super admin access, go to the Authorization > User Permissions section of Global Configurations.
  • Click Add user.
  • Provide the email address of a user. You can add more than one email address. Please note that email address must be same as that in the email field in the JWT token returned by OIDC provider.
  • Select Super admin permission and click Save.
  • A user now will have a Super admin access.
Note:
  • Only users with Super admin permission can assign super admin permissions to a user.
  • We suggest that super admin access must be given to the selected users only.

Assign Specific permissions

To assign a specific permission, go to the Authorization > User Permissions section of Global Configurations.
  • Click Add user.
  • Provide the email address of a user. You can add more than one email address. Please note that email address must be same as that in the email field in the JWT token returned by OIDC provider.
  • Select Specific permissions.
  • Select the group permission from the drop-down list, if required.
  • Selecting Specific permission option allows you to manage access and provide the role-based access accordingly for

Devtron Apps Permissions

In Devtron Apps option, you can provide access to a user to manage permission for custom apps created using Devtron.
Note: The Devtron Apps option will be available only if you install CI/CD integration.
Provide the information in the following fields:
Registry Type
Credentials
Project
Select a project from the drop-down list to which you want to give permission to the user. You can select only one project at a time. Note: If you want to select more than one project, then click Add row.
Environment
Select the specific environment or all environments from the drop-down list. Note: If you select All environments option, then a user gets access to all the current environments including any new environment which gets associated with the application later.
Application
Select the specific applications or all applications from the drop-down list corresponding to your selected Environments. Note: If you select All applications option, then a user gets access to all the current applications including any new application which gets associated with the project later .
Role
Select one of the roles to which you want to give permission to the user:
  • View only
  • Build and Deploy
  • Admin
  • Manager
You can add multiple rows for Devtron app permission.
Once you have finished assigning the appropriate permissions for the users, Click Save.

Helm Apps Permissions

In Helm Apps option, you can provide access to a user to manage permission for Helm apps deployed from Devtron or outside Devtron.
Provide the information in the following fields:
Registry Type
Credentials
Project
Select a project from the drop-down list to which you want to give permission to the user. You can select only one project at a time. Note: If you want to select more than one project, then click Add row.
Environment or cluster/namespace
Select the specific environment or all existing environments in default cluster from the drop-down list. Note: If you select all existing + future environments in default cluster option, then a user gets access to all the current environments including any new environment which gets associated with the application later.
Application
Select the specific application or all applications from the drop-down list corresponding to your selected Environments. Note: If All applications option is selected, then a user gets access to all the current applications including any new application which gets associated with the project later .
Role
Select one of the roles to which you want to give permission to the user:
  • View only
  • View & Edit
  • Admin
You can add multiple rows for Devtron app permission.
Once you have finished assigning the appropriate permissions for the users, Click Save.

Kubernetes Resources Permissions

In Kubernetes Resources option, you can provide permission to view, inspect, manage, and delete resources in your clusters from Kubernetes Resource Browser page in Devtron. You can also create resources from the Kubernetes Resource Browser page.
Note: Only super admin users will be able to see Kubernetes Resources tab and provide permission to other users to access Resource Browser.
To provide Kubernetes resource permission, click Add permission.
On the Kubernetes resource permission, provide the information in the following fields:
Registry Type
Credentials
Cluster
Select a cluster from the drop-down list to which you want to give permission to the user. You can select only one cluster at a time. Note: To add another cluster, then click Add another.
Namespace
Select the namespace from the drop-down list.
API Group
Select the specific API group or All API groups from the drop-down list corresponding to the K8s resource.
Kind
Select the kind or All kind from the drop-down list corresponding to the K8s resource.
Resource name
Select the resource name or All resources from the drop-down list to which you want to give permission to the user.
Role
Select one of the roles to which you want to give permission to the user and click Done:
  • View
  • Admin
You can add multiple rows for Kubernetes resource permission.
Once you have finished assigning the appropriate permissions for the users, Click Save.

Chart Group Permissions

In Chart group permission option, you can manage the access of users for Chart Groups in your project.
Note: The Chart group permission option will be available only if you install CI/CD integration.
NOTE: You can only give users the ability to create or edit, not both.
Action
Permissions
View
Enable View to view chart groups only.
Create
Enable Create if you want the users to create, view, edit or delete the chart groups.
Edit
  • Deny: Select Deny option from the drop-down list to restrict the users to edit the chart groups.
  • Specific chart groups: Select the Specific Charts Groups option from the drop-down list and then select the chart group for which you want to allow users to edit.
Click Saveonce you have configured all the required permissions for the users.

Edit User Permissions

Direct user permissions cannot be edited if you're using LDAP/Microsoft for SSO and 'auto-assign permission' is enabled. Permissions can only be managed via permission groups in such a scenario.
You can edit the user permissions by clicking on the downward arrow.
Edit the user permissions.
After you have done editing the user permissions, click Save.
If you want to delete the user/users with particular permissions, click Delete.