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
1
Merge Requests
1
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
nexedi
gitlab-ce
Commits
42f36268
Commit
42f36268
authored
Jun 02, 2015
by
Robert Speicher
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add 2FA docs
[ci skip]
parent
79aac2c1
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
67 additions
and
1 deletion
+67
-1
doc/workflow/README.md
doc/workflow/README.md
+2
-1
doc/workflow/two_factor_authentication.md
doc/workflow/two_factor_authentication.md
+65
-0
No files found.
doc/workflow/README.md
View file @
42f36268
...
...
@@ -11,6 +11,7 @@
-
[
Migrating from SVN to GitLab
](
migrating_from_svn.md
)
-
[
Project importing from GitHub to GitLab
](
import_projects_from_github.md
)
-
[
Project importing from GitLab.com to your private GitLab instance
](
import_projects_from_gitlab_com.md
)
-
[
Two-factor Authentication (2FA)
](
two_factor_authentication.md
)
-
[
Protected branches
](
protected_branches.md
)
-
[
Change your time zone
](
timezone.md
)
-
[
Keyboard shortcuts
](
shortcuts.md
)
...
...
doc/workflow/two_factor_authentication.md
0 → 100644
View file @
42f36268
# Two-factor Authentication (2FA)
Two-factor Authentication (2FA) provides an additional level of security to your
GitLab account. Once enabled, in addition to supplying your username and
password to login, you'll be prompted for a code generated by an application on
your phone.
By enabling 2FA, the only way someone other than you can log into your account
is to know your username and password
*and*
have access to your phone.
## Enabling 2FA
**In GitLab:**
1.
Log in to your GitLab account.
1.
Go to your
**Profile Settings**
.
1.
Go to
**Acount**
.
1.
Click
**Enable Two-factor Authentication**
.
TODO: Insert screenshot of 2FA page (with the "Can't scan the code?" text)
**On your phone:**
1.
Install a compatible application. We recommend [Google Authenticator].
1.
In the application, add a new entry in one of two ways:
*
Scan the code with your phone's camera to add the entry automatically.
*
Enter the details provided to add the entry manually.
**In GitLab:**
1.
Enter the six-digit pin number from the entry on your phone into the
**
Pin
code
**
field.
1.
Click
**Submit**
.
If the pin you entered was correct, you'll see a message indicating that
Two-factor Authentication has been enabled, and you'll be presented with a list
of recovery codes.
## Recovery Codes
Should you ever lose access to your phone, you can use one of the ten provided
backup codes to login to your account. We suggest copying or printing them for
storage in a safe place.
**Each code can be used only once**
to log in to your
account.
If you lose the recovery codes or just want to generate new ones, you can do so
from the
**Profile Settings**
>
**Acount**
page where you first enabled 2FA.
## Logging in with 2FA Enabled
Logging in with 2FA enabled is only slightly different than a normal login.
Enter your username and password credentials as you normally would, and you'll
be presented with a second prompt for an authentication code. Enter the pin from
your phone's application or a recovery code to log in.
TODO: Insert screenshot of 2FA login prompt?
## Disabling 2FA
1.
Log in to your GitLab account.
1.
Go to your
**Profile Settings**
.
1.
Go to
**Acount**
.
1.
Click
**Disable Two-factor Authentication**
.
[
Google Authenticator
]:
https://support.google.com/accounts/answer/1066447?hl=en
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