diff options
Diffstat (limited to 'doc/administration/moderate_users.md')
-rw-r--r-- | doc/administration/moderate_users.md | 104 |
1 files changed, 32 insertions, 72 deletions
diff --git a/doc/administration/moderate_users.md b/doc/administration/moderate_users.md index 3095f696978..b30294c5fe0 100644 --- a/doc/administration/moderate_users.md +++ b/doc/administration/moderate_users.md @@ -1,6 +1,6 @@ --- stage: Govern -group: Authentication and Authorization +group: Authentication info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments type: howto --- @@ -57,9 +57,7 @@ To approve or reject a user sign up: 1. Select **Admin Area**. 1. Select **Overview > Users**. 1. Select the **Pending approval** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Approve** or **Reject**. +1. For the user sign up you want to approve or reject, select the vertical ellipsis (**{ellipsis_v}**), then **Approve** or **Reject**. Approving a user: @@ -73,31 +71,24 @@ GitLab administrators can block and unblock users. ### Block a user -To completely prevent access of a user to the GitLab instance, -administrators can choose to block the user. +Prerequisite: -Users can be blocked [via an abuse report](../administration/review_abuse_reports.md#blocking-users), -by removing them in LDAP, or directly from the Admin Area. To do this: +- You must be an administrator for the instance. -1. On the left sidebar, select **Search or go to**. -1. Select **Admin Area**. -1. Select **Overview > Users**. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Block**. +You can block a user's access to the instance. When you block a user, they receive an email notification that their account has been blocked. After this email, they no longer receive notifications. A blocked user: -A blocked user: +- Cannot sign in or access any repositories, but all of their data remains in those repositories. +- Cannot use slash commands. For more information, see [slash commands](../user/project/integrations/gitlab_slack_application.md#slash-commands). +- Does not occupy a seat. For more information, see [billable users](../subscriptions/self_managed/index.md#billable-users). -- Cannot sign in. -- Cannot access Git repositories or the API. -- Does not receive any notifications from GitLab. -- Cannot use [slash commands](../user/project/integrations/gitlab_slack_application.md#slash-commands). -- Does not consume a [seat](../subscriptions/self_managed/index.md#billable-users). +To block a user: -Personal projects, and group and user history of the blocked user are left intact. +1. On the left sidebar, select **Search or go to**. +1. Select **Admin Area**. +1. Select **Overview > Users**. +1. For the user you want to block, select the vertical ellipsis (**{ellipsis_v}**), then **Block**. -NOTE: -Users can also be blocked using the [GitLab API](../api/users.md#block-user). +To report abuse from other users, see [report abuse](../user/report_abuse.md). For more information on abuse reports in the Admin area, see [resolving abuse reports](../administration/review_abuse_reports.md#resolving-abuse-reports). ### Unblock a user @@ -107,9 +98,7 @@ A blocked user can be unblocked from the Admin Area. To do this: 1. Select **Admin Area**. 1. Select **Overview > Users**. 1. Select the **Blocked** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Unblock**. +1. For the user you want to unblock, select the vertical ellipsis (**{ellipsis_v}**), then **Unblock**. The user's state is set to active and they consume a [seat](../subscriptions/self_managed/index.md#billable-users). @@ -136,44 +125,27 @@ GitLab administrators can deactivate and activate users. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/22257) in GitLab 12.4. -To temporarily prevent access by a GitLab user that has no recent activity, -administrators can choose to deactivate the user. - -Deactivating a user is functionally identical to [blocking a user](#block-and-unblock-users), -with the following differences: +You can temporarily deactivate a user who has no recent activity. -- It does not prohibit the user from logging back in via the UI. -- Once a deactivated user logs back into the GitLab UI, their account is set to active. +The user you deactivate must be dormant. When you deactivate a user, their projects, group, and history remain. A deactivated user: -A deactivated user: +- Cannot access repositories or the API. +- Cannot use slash commands. For more information, see [slash commands](../user/project/integrations/gitlab_slack_application.md#slash-commands). +- Does not occupy a seat. For more information, see [billable users](../subscriptions/self_managed/index.md#billable-users). -- Cannot access Git repositories or the API. -- Does not receive any notifications from GitLab. -- Cannot use [slash commands](../user/project/integrations/gitlab_slack_application.md#slash-commands). -- Does not consume a [seat](../subscriptions/self_managed/index.md#billable-users). - -Personal projects, and group and user history of the deactivated user are left intact. +Deactivation is similar to blocking, but there are a few important differences. Deactivating a user does not prohibit the user from signing into the GitLab UI. A deactivated user can become active again by signing in. -NOTE: -Users are notified about account deactivation if -[user deactivation emails](../administration/settings/email.md#user-deactivation-emails) are enabled. - -A user can be deactivated from the Admin Area. To do this: +To deactivate a user from the Admin Area: 1. On the left sidebar, select **Search or go to**. 1. Select **Admin Area**. 1. Select **Overview > Users**. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Deactivate**. +1. For the user you want to deactivate, select the vertical ellipsis (**{ellipsis_v}**) and then **Deactivate**. +1. On the dialog, select **Deactivate**. -For the deactivation option to be visible to an administrator, the user: +Email notifications stop after deactivation. GitLab sends email notifications to users when their account has been deactivated. For more information about this feature, see [user deactivation emails](../administration/settings/email.md#user-deactivation-emails). -- Must have a state of active. -- Must be [dormant](#automatically-deactivate-dormant-users). - -NOTE: -Users can also be deactivated using the [GitLab API](../api/users.md#deactivate-user). +To deactivate users with the GitLab API, see [deactivate user](../api/users.md#deactivate-user). For information about permanent user restrictions, see [block and unblock users](#block-and-unblock-users). ### Automatically deactivate dormant users @@ -244,9 +216,7 @@ To do this: 1. Select **Admin Area**. 1. Select **Overview > Users**. 1. Select the **Deactivated** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Activate**. +1. For the user you want to activate, select the vertical ellipsis (**{ellipsis_v}**), then **Activate**. The user's state is set to active and they consume a [seat](../subscriptions/self_managed/index.md#billable-users). @@ -274,9 +244,7 @@ Users can be banned using the Admin Area. To do this: 1. On the left sidebar, select **Search or go to**. 1. Select **Admin Area**. 1. Select **Overview > Users**. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Ban user**. +1. For the user you want to ban, select the vertical ellipsis (**{ellipsis_v}**), then **Ban user**. The banned user does not consume a [seat](../subscriptions/self_managed/index.md#billable-users). @@ -288,24 +256,19 @@ A banned user can be unbanned using the Admin Area. To do this: 1. Select **Admin Area**. 1. Select **Overview > Users**. 1. Select the **Banned** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Unban user**. +1. For the user you want to unban, select the vertical ellipsis (**{ellipsis_v}**), then **Unban user**. The user's state is set to active and they consume a [seat](../subscriptions/self_managed/index.md#billable-users). -### Delete a user +## Delete a user Use the Admin Area to delete users. 1. On the left sidebar, select **Search or go to**. 1. Select **Admin Area**. 1. Select **Overview > Users**. -1. Select the **Banned** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Delete user**. +1. For the user you want to delete, select the vertical ellipsis (**{ellipsis_v}**), then **Delete user**. 1. Type the username. 1. Select **Delete user**. @@ -317,10 +280,7 @@ You can also delete a user and their contributions, such as merge requests, issu 1. On the left sidebar, select **Search or go to**. 1. Select **Admin Area**. 1. Select **Overview > Users**. -1. Select the **Banned** tab. -1. Optional. Select a user. -1. Select the **{settings}** **User administration** dropdown list. -1. Select **Delete user and contributions**. +1. For the user you want to delete, select the vertical ellipsis (**{ellipsis_v}**), then **Delete user and contributions**. 1. Type the username. 1. Select **Delete user and contributions**. |