|
|
|
# Accessing GitLab
|
|
|
|
|
|
|
|
Commerce's GitLab instance is setup for multi-factor authentication. In order to use it you must have an Office of the Secretary Active Directory account.
|
|
|
|
|
|
|
|
Please provide feedback if you notice discrepancies in this guide or have suggestions for improving this guide.
|
|
|
|
|
|
|
|
Contact websolutions@doc.gov with feedback or assistance with the process described in this guide.
|
|
|
|
Complete the steps below to gain access to GitLab.
|
|
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
|
|
|
- You must have an email address from the Department of Commerce or one of its bureaus
|
|
|
|
- You must have access to access email sent to your government email address
|
|
|
|
- You must have a mobile phone
|
|
|
|
- You must have access to email sent to the above email address
|
|
|
|
- You must have an Okta Single Sign-On (SSO) account (described below)
|
|
|
|
- You must have a mobile phone and a two-factor authentication app (described below)
|
|
|
|
|
|
|
|
## Okta SSO account
|
|
|
|
|
|
|
|
If you have not registered for an OKTA SSO account, you will need to do so before you can access GitLab. For instructions on how to register, please refer to this [Knowledge Base Article](https://enterpriseservices.servicenowservices.com/ocio?id=kb_article_view&sysparm_article=kb0013733).
|
|
|
|
|
|
|
|
If you have issues accessing your OKTA SSO account, please contact the IT Service Desk (ITSD) by submitting a support ticket via the “Get Help” button on the [OCIO Self-Service Portal](https://commerce.servicenowservices.com/sp?sysparm_stack=no).
|
|
|
|
|
|
|
|
## Two-factor authentication app
|
|
|
|
|
| ... | ... | @@ -34,9 +37,9 @@ Create an account on the Commerce Web Solutions Authenticator (Authenticator) fo |
|
|
|
## Logging into GitLab for the first time
|
|
|
|
|
|
|
|
1. From a web browser, visit GitLab at https://git.commerce.gov/
|
|
|
|
1. **FOR USPTO EMPLOYEES**, please use the credentials you setup via the CWSA portal above in the Username and Password fields.
|
|
|
|
1. **FOR USPTO EMPLOYEES**, please use the credentials you setup via the CWSA portal above in the Username and Password fields
|
|
|
|
1. **All other DOC employees**, please use the `Okta SSO` login option (as seen in screenshot below)
|
|
|
|
1. Login to Gitlab with your DOC network credentials
|
|
|
|
1. Login to GitLab with your DOC network credentials
|
|
|
|
|
|
|
|
|
|
|
|
## Setup Two-factor authentication
|
| ... | ... | @@ -49,11 +52,11 @@ Create an account on the Commerce Web Solutions Authenticator (Authenticator) fo |
|
|
|
1. In your browser on the Gitlab QR code page, enter the six-digit PIN number from your phone's 2FA app into the PIN code field
|
|
|
|
1. Click Submit and 2FA will be enabled
|
|
|
|
|
|
|
|
**Note: Do not save the recovery codes** -- if your mobile phone is ever lost, a system administrator can temporarily disable 2FA on your account to allow you to login and perform this process again.
|
|
|
|
**Note: Do not save the recovery codes** -- if your mobile phone is ever lost, an incident may be submitted through the [OCIO Self-Service Portal](https://commerce.servicenowservices.com/sp?sysparm_stack=no) to temporarily disable 2FA on your account to allow you to login and perform this process again.
|
|
|
|
|
|
|
|
## Request access to specific projects and/or groups within Gitlab
|
|
|
|
|
|
|
|
1. If you need access to a specific project and/or group - please request membership access to that project and/or group from Gitlab admin user.
|
|
|
|
1. Please request membership access to any project and/or groups for which you need access.
|
|
|
|
|
|
|
|
## Future logins to GitLab
|
|
|
|
|
| ... | ... | |
