Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Boxiang Sun
gitlab-ce
Commits
d650c308
Commit
d650c308
authored
Jun 05, 2019
by
Evan Read
Committed by
Achilleas Pipinellis
Jun 05, 2019
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Clarify and improve 2FA configuration information
parent
40e3d11b
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
16 additions
and
19 deletions
+16
-19
doc/security/img/two_factor_authentication_group_settings.png
...security/img/two_factor_authentication_group_settings.png
+0
-0
doc/security/img/two_factor_authentication_settings.png
doc/security/img/two_factor_authentication_settings.png
+0
-0
doc/security/two_factor_authentication.md
doc/security/two_factor_authentication.md
+16
-19
No files found.
doc/security/img/two_factor_authentication_group_settings.png
deleted
100644 → 0
View file @
40e3d11b
19 KB
doc/security/img/two_factor_authentication_settings.png
deleted
100644 → 0
View file @
40e3d11b
9.7 KB
doc/security/two_factor_authentication.md
View file @
d650c308
...
@@ -16,39 +16,35 @@ enforce everyone to set up 2FA, you can choose from two different ways:
...
@@ -16,39 +16,35 @@ enforce everyone to set up 2FA, you can choose from two different ways:
-
Enforce on next login.
-
Enforce on next login.
-
Suggest on next login, but allow a grace period before enforcing.
-
Suggest on next login, but allow a grace period before enforcing.
In the Admin area under
**Settings**
(
`/admin/application_settings`
), look for
After the configured grace period has elapsed, users will be able to log in but
the "Sign-in Restrictions" area, where you can configure both.
won't be able to leave the 2FA configuration area at
`/profile/two_factor_auth`
.
To enable 2FA for all users:
1.
Navigate to
**Admin area > Settings > General**
(
`/admin/application_settings`
).
1.
Expand the
**Sign-in restrictions**
section, where you can configure both.
If you want 2FA enforcement to take effect on next login, change the grace
If you want 2FA enforcement to take effect on next login, change the grace
period to
`0`
.
period to
`0`
.
---
## Enforcing 2FA for all users in a group
![
Two factor authentication admin settings
](
img/two_factor_authentication_settings.png
)
---
If you want to enforce 2FA only for certain groups, you can:
## Enforcing 2FA for all users in a group
1.
Enable it in the group's
**Settings > General**
page.
1.
Optionally specify a grace period as above.
If you want to enforce 2FA only for certain groups, you can enable it in the
To change this setting, you need to be administrator or owner of the group.
group settings and specify a grace period as above. To change this setting you
need to be administrator or owner of the group.
If there are multiple 2FA requirements (i.e. group + all users, or multiple
If there are multiple 2FA requirements (i.e. group + all users, or multiple
groups) the shortest grace period will be used.
groups) the shortest grace period will be used.
---
![
Two factor authentication group settings
](
img/two_factor_authentication_group_settings.png
)
---
## Disabling 2FA for everyone
## Disabling 2FA for everyone
There may be some special situations where you want to disable 2FA for everyone
There may be some special situations where you want to disable 2FA for everyone
even when forced 2FA is disabled. There is a rake task for that:
even when forced 2FA is disabled. There is a rake task for that:
```
```
sh
# Omnibus installations
# Omnibus installations
sudo
gitlab-rake gitlab:two_factor:disable_for_all_users
sudo
gitlab-rake gitlab:two_factor:disable_for_all_users
...
@@ -56,5 +52,6 @@ sudo gitlab-rake gitlab:two_factor:disable_for_all_users
...
@@ -56,5 +52,6 @@ sudo gitlab-rake gitlab:two_factor:disable_for_all_users
sudo
-u
git
-H
bundle
exec
rake gitlab:two_factor:disable_for_all_users
RAILS_ENV
=
production
sudo
-u
git
-H
bundle
exec
rake gitlab:two_factor:disable_for_all_users
RAILS_ENV
=
production
```
```
**
IMPORTANT: this is a permanent and irreversible action. Users will have to
CAUTION:
**Caution:**
reactivate 2FA from scratch if they want to use it again.
**
This is a permanent and irreversible action. Users will have to
reactivate 2FA from scratch if they want to use it again.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment