Introduction
This guide explains how to create a new user in Jenkins and configure permissions for that user using the Matrix-based Authorization Strategy. As an administrator, you can add and manage Jenkins users and assign permissions based on their roles and responsibilities within the CI/CD environment.
Prerequisites
- Jenkins installed and accessible.
- Administrative access to Jenkins.
- Administrator credentials.
- Permission to manage users and security settings.
Implementation
Step 1: Navigate to “Manage Jenkins.”
- Log in to Jenkins with administrative credentials.
- From the Jenkins dashboard, click Manage Jenkins.
Step 2: Access User Management
- Under Manage Jenkins, click Users.
Step 3: Create a New User
- Click the + Create User button to initiate the user creation process.
Step 4: Provide User Details
Enter the required details for the new user:
- Username: Enter a unique username.
- Password: Set a secure password.
- Full Name: Enter the user’s full name.
- Email Address: Provide a valid email address.
After entering the details, click Save to create the user.
Permission Management Using Matrix-based Authorization Strategy
The matrix-based authorization strategy allows administrators to assign specific Jenkins permissions to individual users.
Step 5: Navigate to Security Settings
- Click Manage Jenkins.
- Select Security.
- In the Authorization section, select Project-Based Matrix Authorization Strategy.
Step 6: Configure Permissions
Under the Project-Based Matrix Authorization Strategy section, you will see a permissions table.
- Find the row corresponding to the user you created.
- Select the permissions required for that user.
- Assign permissions based on the user’s role and responsibilities.
Step 7: Configure the Permission Matrix
The permission matrix contains permissions related to areas such as the following:
- Overall
- Credentials
- Agent
- Job
- Run
- View
- SCM
- Lockable Resources
Select the required permissions according to the user’s responsibilities.
After configuring the permissions, scroll to the bottom of the page and click Save to apply the changes.
Permission Options
The following are some of the permission options available in the matrix:
- Administrator: Grants full administrative control over Jenkins.
- Read: Allows the user to view information.
- Create, Delete: Provides the ability to create or delete entities.
- ManageDomains: Manages domain-related settings.
- Update, View: Allows updating or viewing settings or entities.
- Build, Configure, Connect, Disconnect: Controls actions related to builds, configuration, and connections.
- Discover, Move, Workspace, Replay: Manages discovery, movement, workspace, and replay options.
- Tag, Reserve, Steal, Unlock: Controls actions related to version control systems and resources.
FAQs
1. How do I create a user in Jenkins?
Log in with administrator credentials, navigate to Manage Jenkins → Users, and click Create User. Enter the required user details and save the configuration.
2. What is Matrix-based Authorization in Jenkins?
Matrix-based authorization allows administrators to assign individual permissions to Jenkins users based on their required access.
3. Can I give different permissions to different Jenkins users?
Yes. Each user can be assigned specific permissions according to their role and responsibilities.
4. What is a project-based matrix authorization strategy?
Project-Based Matrix Authorization allows permissions to be controlled at the project level, giving administrators more granular control over user access.
5. What permissions should be given to a Jenkins user?
Permissions should be assigned based on the user’s responsibilities. Avoid granting administrative permissions unless the user requires full Jenkins administration access.
Related Articles
How to Upgrade Jenkins to 2.414
Learn the steps involved in upgrading Jenkins to version 2.414 and maintaining the Jenkins environment.
Read the Jenkins upgrade guide
How to Schedule a Job in Jenkins
Learn how to configure scheduled jobs in Jenkins to automate recurring CI/CD tasks.
Read the Jenkins job scheduling guide
How to Configure Bitbucket Credentials in Jenkins
Learn how to configure Bitbucket credentials in Jenkins for accessing repositories during CI/CD workflows.
Read the Bitbucket credentials guide
Talk to our experts
Looking for the right technology solution for your business? Our team of experts can help you with development, cloud, DevOps, design, and a wide range of other technology needs. Get in touch with our team here.