Managing Users and User Groups
Managing Users
Creating New User
The Administration | Users page provides the Create user account option.
When creating a user account, only a username is required. If only the default authentication is used, the password is required as well. Any new user is automatically added to the All Users group and inherits roles and permissions defined for this group. If you do not use per-project permissions, you can specify here whether a user should have administrative permissions or not. Otherwise, you can assign roles to this user later.
Editing User Account
To edit/delete a user account, click its name on the Users tab of the Administration | Users page.
General tab The tab provides several panes allowing you to modify various user account settings: The General pane allows modifying the user's name, email address and password if you have appropriate permissions. Users can change their own username only if free registration is allowed. The administrator can always change the username of any user. The Authentication Settings pane allows editing usernames for different authentication modulessuch as LDAP and Windows Domain. The Version Control Username Settings pane allows viewing and editing the default usernames for different VCS used by the current user. Since TeamCity 9.1, multiple usernames are supported for a VCS root type and for a separate VCS root: several newline-separated values can be used for each VCS username.
The names set here will be used to:
show builds with changes committed by a user with such VCS username on the Changes page
highlight such builds on the Projects page if the appropriate option is selected,
notify the user on such builds when the Builds affected by my changes option is selected in notifications settings.
Watched Builds and Notifications displays the notification rules configured for this user account.
Groups tab Use this tab to review the groups the user belongs to, and add/remove the user from groups. Roles This tab is available only if per-project permissions are enabled at the Server Configuration page. Use this tab to view the roles assigned to the user directly and inherited from groups. The roles assigned directly can be modified/removed here. Notification Rules Please, refer to Subscribing to Notifications for details.
Assigning Roles to Users
There are several ways to assign roles to one or several users:
To assign a role to a specific user, on the Users tab for the user click View roles in the corresponding column. In the Roles tab, click Assign role.
To assign a role to multiple users, on the Users tab, check the boxes next to the usernames and use the Assign roles button at the bottom of the page.
To assign a role to all users in a group, on the Groups tab click View roles for the group in question, then assign a role on the group level. When assigning a role, you can:
Select whether a role should be granted globally, or in particualr projects.
Replace existing roles with the newly selected. This will remove all roles assigned to user(s)/group and replace them with the selected one instead.
Managing User Groups
Creating New Group
Open the Administration | Groups page and сlick Create new group.
Specify the group name. TeamCity will create an editable Group Key, which is a unique group identifier.
When creating a group, you can select the parent group(s) for it. All roles and notification rules configured for the parent group will be automatically assigned to the current group. To place the current group to the top level, deselect all groups in the list.
Editing Group Settings
To edit a group, click its name on the Groups tab. You can modify the list of users, roles and permissions and notification settings.
The All Users group includes all users and cannot be deleted. However, you can modify its roles and notification settings.
The Roles tab allows you to view and edit (assign/unassign) default roles for the current group. These roles will be automatically assigned to all users in the group. Default roles for a user group are divided in two groups:
roles inherited from a parent group. Inherited roles can not be unassigned from the group.
roles assigned explicitly to the group
To assign a role for the current group explicitly, click the Assign role link. To view permissions granted to a role, click the View roles permissions link. You can also specify notification rules to be applied to all users in the current group. To learn more about notification rules, please refer to Subscribing to Notifications.
Adding Multiple Users to Group
On the Users and Groups page, select the users, click the Add to groups button, and check the groups where these users should be added. Note, that all these users will inherit the roles defined for the group.