debian-mirror-gitlab/doc/user/project/members/index.md

250 lines
9.5 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
2021-09-04 01:27:46 +05:30
stage: Manage
2022-04-04 11:22:00 +05:30
group: Authentication and Authorization
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2021-09-04 01:27:46 +05:30
# Members of a project **(FREE)**
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
Members are the users and groups who have access to your project.
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
Each member gets a role, which determines what they can do in the project.
2018-03-17 18:26:18 +05:30
2022-05-07 20:08:51 +05:30
Project members can:
1. Be [direct members](#add-users-to-a-project) of the project.
1. [Inherit membership](#inherited-membership) of the project from the project's group.
1. Be a member of a group that was [shared](share_project_with_groups.md) with the project.
1. Be a member of a group that was [shared with the project's group](../../group/index.md#share-a-group-with-another-group).
```mermaid
flowchart RL
subgraph Group A
A(Direct member)
B{{Shared member}}
subgraph Project A
H(1. Direct member)
C{{2. Inherited member}}
D{{4. Inherited member}}
E{{3. Shared member}}
end
A-->|Direct membership of Group A\nInherited membership of Project A|C
end
subgraph Group C
G(Direct member)
end
subgraph Group B
F(Direct member)
end
F-->|Group B\nshared with\nGroup A|B
B-->|Inherited membership of Project A|D
G-->|Group C shared with Project A|E
```
2021-06-08 01:23:25 +05:30
## Add users to a project
2022-04-04 11:22:00 +05:30
> - [Changed](https://gitlab.com/gitlab-org/gitlab/-/issues/247208) in GitLab 13.11 from a form to a modal window [with a flag](../../feature_flags.md). Disabled by default.
> - Modal window [enabled on GitLab.com and self-managed](https://gitlab.com/gitlab-org/gitlab/-/issues/247208) in GitLab 14.8.
2022-05-07 20:08:51 +05:30
> - [Generally available](https://gitlab.com/gitlab-org/gitlab/-/issues/352526) in GitLab 14.9.
[Feature flag `invite_members_group_modal`](https://gitlab.com/gitlab-org/gitlab/-/issues/352526) removed.
2022-04-04 11:22:00 +05:30
2021-06-08 01:23:25 +05:30
Add users to a project so they become members and have permission
to perform actions.
Prerequisite:
2022-04-04 11:22:00 +05:30
- You must have the Maintainer or Owner role.
2021-06-08 01:23:25 +05:30
To add a user to a project:
2022-04-04 11:22:00 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
1. Select **Invite members**.
1. Enter an email address and select a [role](../../permissions.md).
1. Optional. Select an **Access expiration date**.
On that date, the user can no longer access the project.
2021-06-08 01:23:25 +05:30
1. Select **Invite**.
If the user has a GitLab account, they are added to the members list.
If you used an email address, the user receives an email.
2021-09-04 01:27:46 +05:30
If the invitation is not accepted, GitLab sends reminder emails two,
five, and ten days later. Unaccepted invites are automatically
deleted after 90 days.
If the user does not have a GitLab account, they are prompted to create an account
using the email address the invitation was sent to.
2021-06-08 01:23:25 +05:30
## Add groups to a project
2022-04-04 11:22:00 +05:30
> - [Changed](https://gitlab.com/gitlab-org/gitlab/-/issues/247208) in GitLab 13.11 from a form to a modal window [with a flag](../../feature_flags.md). Disabled by default.
> - Modal window [enabled on GitLab.com and self-managed](https://gitlab.com/gitlab-org/gitlab/-/issues/247208) in GitLab 14.8.
2022-05-07 20:08:51 +05:30
> - [Generally available](https://gitlab.com/gitlab-org/gitlab/-/issues/352526) in GitLab 14.9.
[Feature flag `invite_members_group_modal`](https://gitlab.com/gitlab-org/gitlab/-/issues/352526) removed.
2022-04-04 11:22:00 +05:30
2021-09-04 01:27:46 +05:30
When you add a group to a project, each user in the group gets access to the project.
Each user's access is based on:
- The role they're assigned in the group.
- The maximum role you choose when you invite the group.
2021-06-08 01:23:25 +05:30
Prerequisite:
2022-04-04 11:22:00 +05:30
- You must have the Maintainer or Owner role.
2022-05-07 20:08:51 +05:30
- Sharing the project with other groups must not be [prevented](../../group/index.md#prevent-a-project-from-being-shared-with-groups).
2021-06-08 01:23:25 +05:30
To add groups to a project:
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
2022-04-04 11:22:00 +05:30
1. Select **Invite a group**.
1. Select a group.
1. Select the highest [role](../../permissions.md) for users in the group.
1. Optional. Select an **Access expiration date**. On that date, the group can no longer access the project.
2021-06-08 01:23:25 +05:30
1. Select **Invite**.
The members of the group are not displayed on the **Members** tab.
The **Members** tab shows:
- Members who are directly assigned to the project.
- If the project was created in a group [namespace](../../group/index.md#namespaces), members of that group.
## Import users from another project
You can import another project's users to your own project. Users
retain the same permissions as the project you import them from.
Prerequisite:
2022-04-04 11:22:00 +05:30
- You must have the Maintainer or Owner role.
2021-06-08 01:23:25 +05:30
To import users:
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
2022-05-07 20:08:51 +05:30
1. Select **Import from a project**.
2021-06-08 01:23:25 +05:30
1. Select the project. You can view only the projects for which you're a maintainer.
1. Select **Import project members**.
2022-05-07 20:08:51 +05:30
After the success message displays, refresh the page to view the new members.
2018-03-17 18:26:18 +05:30
2020-01-01 13:55:28 +05:30
## Inherited membership
2021-09-04 01:27:46 +05:30
When your project belongs to a group, group members inherit their role
from the group.
2020-01-01 13:55:28 +05:30
2021-11-18 22:05:49 +05:30
![Project members page](img/project_members_v14_4.png)
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
In this example:
- Three members have access to the project.
- **User 0** is a Reporter and has inherited their role from the **demo** group,
which contains the project.
- **User 1** belongs directly to the project. In the **Source** column, they are listed
as a **Direct member**.
- **Administrator** is the [Owner](../../permissions.md) and member of all groups.
They have inherited their role from the **demo** group.
2021-10-27 15:23:28 +05:30
If a user is a direct member of a project, the expiration date can be updated. If membership is inherited from a parent group, the expiration date can be updated only from the parent group itself.
2021-09-30 23:02:18 +05:30
2021-09-04 01:27:46 +05:30
## Remove a member from a project
If a user is a direct member of a project, you can remove them.
If membership is inherited from a parent group, then the member can be removed only from the parent
group itself.
2021-10-27 15:23:28 +05:30
Prerequisites:
2021-09-04 01:27:46 +05:30
2022-04-04 11:22:00 +05:30
- You must have the Owner role.
2021-09-04 01:27:46 +05:30
- Optional. Unassign the member from all issues and merge requests that
are assigned to them.
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
To remove a member from a project:
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
2022-05-07 20:08:51 +05:30
1. Next to the project member you want to remove, select **Remove member**.
2021-10-27 15:23:28 +05:30
1. Optional. In the confirmation box, select the
**Also unassign this user from related issues and merge requests** checkbox.
1. To prevent leaks of sensitive information from private projects, verify the
2021-12-11 22:18:48 +05:30
user has not forked the private repository or created webhooks. Existing forks continue to receive
changes from the upstream project, and webhooks continue to receive updates. You may also want to configure your project
2021-10-27 15:23:28 +05:30
to prevent projects in a group
[from being forked outside their group](../../group/index.md#prevent-project-forking-outside-group).
2021-09-04 01:27:46 +05:30
1. Select **Remove member**.
2020-01-01 13:55:28 +05:30
2021-03-11 19:13:27 +05:30
## Filter and sort members
2020-01-01 13:55:28 +05:30
2021-03-11 19:13:27 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/21727) in GitLab 12.6.
> - [Improved](https://gitlab.com/groups/gitlab-org/-/epics/4901) in GitLab 13.9.
2021-04-17 20:07:23 +05:30
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/299954) in GitLab 13.10.
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
You can filter and sort members in a project.
2021-03-11 19:13:27 +05:30
2021-09-04 01:27:46 +05:30
### Display inherited members
2021-03-11 19:13:27 +05:30
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
2021-09-04 01:27:46 +05:30
1. In the **Filter members** box, select `Membership` `=` `Inherited`.
1. Press Enter.
2021-03-11 19:13:27 +05:30
2021-11-18 22:05:49 +05:30
![Project members filter inherited](img/project_members_filter_inherited_v14_4.png)
2021-03-11 19:13:27 +05:30
2021-09-04 01:27:46 +05:30
### Display direct members
2021-03-11 19:13:27 +05:30
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Project information > Members**.
2021-09-04 01:27:46 +05:30
1. In the **Filter members** box, select `Membership` `=` `Direct`.
1. Press Enter.
2021-03-11 19:13:27 +05:30
2021-11-18 22:05:49 +05:30
![Project members filter direct](img/project_members_filter_direct_v14_4.png)
2021-03-11 19:13:27 +05:30
### Search
You can search for members by name, username, or email.
2021-11-18 22:05:49 +05:30
![Project members search](img/project_members_search_v14_4.png)
2021-03-11 19:13:27 +05:30
### Sort
You can sort members by **Account**, **Access granted**, **Max role**, or **Last sign-in** in ascending or descending order.
2021-11-18 22:05:49 +05:30
![Project members sort](img/project_members_sort_v14_4.png)
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
## Request access to a project
2021-09-30 23:02:18 +05:30
GitLab users can request to become a member of a project.
2021-09-04 01:27:46 +05:30
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find the project you want to be a member of.
2021-09-04 01:27:46 +05:30
1. By the project name, select **Request Access**.
![Request access button](img/request_access_button.png)
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
An email is sent to the most recently active project maintainers.
Up to ten project maintainers are notified.
Any project maintainer can approve or decline the request.
2021-04-29 21:17:54 +05:30
2021-09-04 01:27:46 +05:30
If a project does not have any maintainers, the notification is sent to the
most recently active owners of the project's group.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
If you change your mind before your request is approved, select
**Withdraw Access Request**.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
## Prevent users from requesting access to a project
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
You can prevent users from requesting access to a project.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Prerequisite:
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
- You must be the project owner.
2018-03-17 18:26:18 +05:30
2022-01-26 12:08:38 +05:30
1. On the top bar, select **Menu > Projects** and find your project.
1. On the left sidebar, select **Settings > General**.
1. Expand **Visibility, project features, permissions**.
2021-09-04 01:27:46 +05:30
1. Under **Project visibility**, select **Users can request access**.
1. Select **Save changes**.
2021-02-22 17:27:13 +05:30
2021-09-04 01:27:46 +05:30
## Share a project with a group
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Instead of adding users one by one, you can [share a project with an entire group](share_project_with_groups.md).