You can grant Atlas users access to Atlas organizations. Assign user roles to enforce permission levels for Atlas users.
We recommend that you create a minimum of two users with the Organization Owner role to ensure that access to an organization does not depend on a single user.
Important
Project Invitation Deprecation
The Atlas release on September 13, 2023 deprecates project invitations.
When you invite an organization member to projects within the organization, the user is automatically granted access to those projects and doesn't receive any invitations. When you invite a user to projects in an organization that the user doesn't belong to, the user receives a single invitation to the organization, which includes access to all of the projects that you grant them access to. Invitations expire after 30 days.
Required Access
To perform any of the following actions, you must have Project Access Manager or Organization Owner access to Atlas.
Add Users to an Organization
Important
Atlas limits Atlas user membership to a maximum of 500 Atlas users per organization.
To invite a user to your organization using the Atlas CLI, run the following command:
atlas users invite [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas users invite.
To invite users to an organization using the Atlas UI:
In Atlas, go to the Applications page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click Applications in the sidebar under the Identity & Access section.
The Applications page displays.
Invite Users to the organization.
Click Invite Users.
From the Add Users page, enter the new user's email address or Jira username in the combo box.
After typing in the email address, either press Enter or click on the email address beneath the New User header under the combo box.
Repeat for any additional users.
Choose the roles for the new Users.
By default, each user is given the Organization Member role. To change or add additional roles for each user, click the role dropdown menu, then select the checkboxes for each role you want the user to have in the organization.
Invite the Users.
Click Add Users to Organization.
When you invite an organization member to projects within the organization, the user is automatically granted access to those projects and doesn't receive any invitations. When you invite a user to projects in an organization that the user doesn't belong to, the user receives a single invitation to the organization, which includes access to all of the projects that you grant them access to. Invitations expire after 30 days.
Note
Inviting Federated Users
If your organization uses federated authentication, Atlas adds eligible federated users directly as active members instead of sending invitations. To learn more, see Inviting Federated Users.
View Active Users and Outgoing Invitations in an Organization
View Active Users
To list all users in your organization using the Atlas CLI, run the following command:
atlas organizations users list [options]
To return the details for a user you specify using the Atlas CLI, run the following command:
atlas users describe [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas organizations users list and atlas users describe.
View Pending User Invitations
To list all pending invitations to the organization you specify using the Atlas CLI, run the following command:
atlas organizations invitations list [options]
To return the details for one pending invitation to the organization you specify using the Atlas CLI, run the following command:
atlas organizations invitations describe <invitationId> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas organizations invitations list and atlas organizations invitations describe.
Modify or Cancel a Pending User Invitation
To update one pending invitation to the organization you specify using the Atlas CLI, run the following command:
atlas organizations invitations update [invitationId] [options]
To delete one pending invitation to the organization you specify using the Atlas CLI, run the following command:
atlas organizations invitations delete <invitationId> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas organizations invitations update and atlas organizations invitations delete.
To view users in an organization using the Atlas UI:
In Atlas, go to the Applications page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click Applications in the sidebar under the Identity & Access section.
The Applications page displays.
This page lists:
Users who are members of your Atlas organization.
Pending users who have not accepted the invitation to join the organization or its project within the organization.
To cancel an invitation, click to the right of the pending user.
Edit User's Role in an Organization
Note
You can't edit roles for specific users on the Access Manager page if you configure role mappings for IdP groups.
To edit a user's role in an organization:
In Atlas, go to the Applications page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click Applications in the sidebar under the Identity & Access section.
The Applications page displays.
Select the new role or roles for the user from the menu.
Remove Users from an Organization
Note
You cannot remove the last Organization Owner from an organization.
To remove a user from an organization:
In Atlas, go to the Applications page.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
Click Applications in the sidebar under the Identity & Access section.
The Applications page displays.