Duo: Difference between revisions

From UMIACS
Jump to navigation Jump to search
No edit summary
No edit summary
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[https://www.duo.com Duo] is the multi-factor authentication ([[MFA]]) solution for both UMD centralized information technology resources (DivIT) and UMIACS local resources.  Multi-factor solutions ensure that you have something you know (i.e. your password) and something you have (phone/tablet/token).  This ensures that phishing and other attempts to secure your password do not result in an account compromise and protect you and your data from unauthorized access.
[https://www.duo.com Duo] is the multi-factor authentication ([[MFA]]) solution for both UMD centralized information technology resources (DivIT) and UMIACS local resources.  Multi-factor solutions ensure that you have something you know (i.e. your password) and something you have (phone/tablet/token) when trying to authenticate.  This ensures that phishing and other attempts to secure your password do not result in an account compromise and protect you and your data from unauthorized access.


<b>Enrollment is discrete and must be done for both UMD (if you have a UMD appointment) and UMIACS individually</b>.  You can enroll the same phone for both of these services, but not the same token (if you use a token for UMD already).  The UMIACS Single Sign-On and our [[VPN]] require Duo authentication.   
<b>Enrollment is discrete and must be done for both UMD (if you have a UMD appointment) and UMIACS individually</b>.  You can enroll the same phone for both of these services, but not the same hardware token (if you use a token for UMD already).  The UMIACS Single Sign-On and our [[VPN]] require Duo authentication.   


[[File:duo_login.png|400px|thumb|left|Duo Login Prompt]]
[[File:duo_login.png|400px|thumb|left|Duo Login Prompt]]
Line 13: Line 13:
Users can manage their UMIACS Duo settings as part of the required login to the [https://intranet.umiacs.umd.edu/directory/info Directory Application].  Please follow the Duo guide for [https://guide.duo.com/manage-devices Managing Devices] when you see the Duo login prompt.
Users can manage their UMIACS Duo settings as part of the required login to the [https://intranet.umiacs.umd.edu/directory/info Directory Application].  Please follow the Duo guide for [https://guide.duo.com/manage-devices Managing Devices] when you see the Duo login prompt.


We suggest users register using a mobile phone or tablet that is always in your personal possession.  If/When you upgrade or dispose of your currently registered phone/tablet please consider enrolling your new device before getting rid of your old device.  Activation of your new device will require you to successfully authenticate with a currently registered device.  If you no longer have the device but have kept the mobile phone number registered you can select <b>Call Me</b> to have Duo call you to authenticate your session to manage/enroll your devices.  If you do not have access to your previous device(s) or the phone number you will need to contact [mailto:staff@umiacs.umd.edu UMIACS staff] for assistance.
We suggest you register using a mobile phone or tablet that is always in your personal possession.  If/When you upgrade or dispose of your currently registered phone/tablet, please consider enrolling your new device before getting rid of your old device.  Activation of your new device will require you to successfully authenticate with a currently registered device.  If you no longer have the device but have kept the same phone number, you can select <b>Call Me</b> to have Duo call you to authenticate your session to manage/enroll your devices.  If you do not have access to your previous device(s) or the phone number, you will need to contact [mailto:staff@umiacs.umd.edu UMIACS staff] for assistance.


[[File:duo_offline.png|400px|thumb|left|Duo Offline One-Time Code]]
==Offline Use==
<gallery mode="packed-hover" widths=260px heights=260px style="float:right;">
Image:duo_offline1.png|Duo Offline One-Time Code
Image:duo_offline2.png|Entering Your Code
</gallery>


==Offline Use==
For use when phone data or calls are not available, there are 2 options.  
For use when phone data or calls are not available there are 2 options.  


For people with the Duo app installed on their phone or tablet they can use the app, without any internet connection to generate a one time code that can be used to authenticate to Duo. This will be the secondary login for the VPN or the passcode option in the Duo pane of web authentication. To get this code from the app, open the app and tap on the entry labeled Duo-protected UMIACS. This will expand that item in the list to include a 6 digit passcode.
You may use the Duo App on their phone or tablet—without any internet connection—to generate one-time codes that will allow you to authenticate to Duo. This code will be the input for the secondary login screen for the VPN or the <code>passcode</code> option in the Duo pane of web authentication. To get a code from the app, open the app and tap on the entry labeled "Duo-protected UMIACS.This will present a 6 digit passcode.


Alternatively hardware tokens can be used with Duo. Hardware tokens must be enrolled by the Technical staff, so if you are interested in procuring a hardware token for use with Duo, please contact staff@umiacs.umd.edu
Alternatively, hardware tokens can be used with Duo. Hardware tokens must be enrolled by the Technical staff, so if you are interested in procuring a hardware token for use with Duo, please contact staff@umiacs.umd.edu.


==Services==
==Services==
Line 30: Line 33:
* [[GitLab]]
* [[GitLab]]
* [[Jira]]
* [[Jira]]
* [[OBJbox | Object Storage]]
* [[OBJ | Object Storage]]
* [[VPN]]
* [[VPN]]
* [https://intranet.umiacs.umd.edu/directory Directory]
* [https://intranet.umiacs.umd.edu/directory Directory]
* [https://intranet.umiacs.umd.edu/requests Requests]
* [https://intranet.umiacs.umd.edu/requests Requests]
* MediaWiki log ins
</div>
</div>


==FAQ==
==FAQ==
;I can no longer clone HTTPS Git repositories in [[GitLab]]. How do I work around this?
; I can no longer clone HTTPS Git repositories in [[GitLab]]. How do I work around this?
: Since we require more than just your username/password to log into [[GitLab]] you can not use your UMIACS credentials directly for accessing HTTPS Git repositories.  We encourage users to setup [https://gitlab.umiacs.umd.edu/help/ssh/README.md#ssh SSH] keys instead but if you have a case where you need to use HTTPS you can use a [https://gitlab.umiacs.umd.edu/help/user/profile/personal_access_tokens.md Personal Access Token] to accomplish this.  Ensure when you create the token that you are selecting it has <code>API</code> scope.  You would then use your username and then the token as the password.  Treat this token as a personal secret as it is sufficient to act as your account within Gitlab.
: Since we now require more than just your username/password to log into [[GitLab]], you cannot use your UMIACS credentials directly for accessing HTTPS Git repositories.  We encourage users to setup [https://gitlab.umiacs.umd.edu/help/ssh/README.md#ssh SSH] keys instead.  If you have a case where you need to use HTTPS, you can use a [https://gitlab.umiacs.umd.edu/help/user/profile/personal_access_tokens.md Personal Access Token] to accomplish this.  Ensure that you create the token with <code>API</code> scope.  You would then use your username and then the token as the password.  Treat this token as a personal secret, as it is sufficient to act as your account within GitLab.
 
;How do I authenticate with a Token?
: We only currently support YubiKey tokens for our Duo deployment.  You can follow the instructions from [https://guide.duo.com/tokens Yubico] just remember you will need to tap the YubiKey once you select the '''Enter a Passcode''' field.  It will create a pass code (will look something like ''kffuastenhldrhfhadafdarivuntddugrvjvllddjjuget'') and send a return.


__NOTOC__
; How do I authenticate with a Token?
: We only currently support YubiKey tokens for our Duo deployment.  You can follow the instructions from [https://guide.duo.com/tokens Yubico];  you will need to tap the YubiKey once you select the '''Enter a Passcode''' field.  It will create a passcode (will look something like ''kffuastenhldrhfhadafdarivuntddugrvjvllddjjuget'') and send a return.

Revision as of 14:37, 6 January 2021

Duo is the multi-factor authentication (MFA) solution for both UMD centralized information technology resources (DivIT) and UMIACS local resources. Multi-factor solutions ensure that you have something you know (i.e. your password) and something you have (phone/tablet/token) when trying to authenticate. This ensures that phishing and other attempts to secure your password do not result in an account compromise and protect you and your data from unauthorized access.

Enrollment is discrete and must be done for both UMD (if you have a UMD appointment) and UMIACS individually. You can enroll the same phone for both of these services, but not the same hardware token (if you use a token for UMD already). The UMIACS Single Sign-On and our VPN require Duo authentication.

Duo Login Prompt

Enrollment

Please refer to Duo's Enrollment guide which has comprehensive information on how to enroll your devices. The recommended place at UMIACS to sign in to enroll is our Directory application.

We encourage users to enroll with their smart phone as it provides the most seamless experience. We also support iOS/Android Tablets, landlines, and U2F FIDO authenticator tokens (though these do not work with our VPN or MFA SSH services).

Management

Users can manage their UMIACS Duo settings as part of the required login to the Directory Application. Please follow the Duo guide for Managing Devices when you see the Duo login prompt.

We suggest you register using a mobile phone or tablet that is always in your personal possession. If/When you upgrade or dispose of your currently registered phone/tablet, please consider enrolling your new device before getting rid of your old device. Activation of your new device will require you to successfully authenticate with a currently registered device. If you no longer have the device but have kept the same phone number, you can select Call Me to have Duo call you to authenticate your session to manage/enroll your devices. If you do not have access to your previous device(s) or the phone number, you will need to contact UMIACS staff for assistance.

Offline Use

For use when phone data or calls are not available, there are 2 options.

You may use the Duo App on their phone or tablet—without any internet connection—to generate one-time codes that will allow you to authenticate to Duo. This code will be the input for the secondary login screen for the VPN or the passcode option in the Duo pane of web authentication. To get a code from the app, open the app and tap on the entry labeled "Duo-protected UMIACS." This will present a 6 digit passcode.

Alternatively, hardware tokens can be used with Duo. Hardware tokens must be enrolled by the Technical staff, so if you are interested in procuring a hardware token for use with Duo, please contact staff@umiacs.umd.edu.

Services

The following UMIACS services are secured with our Duo MFA solution.

FAQ

I can no longer clone HTTPS Git repositories in GitLab. How do I work around this?
Since we now require more than just your username/password to log into GitLab, you cannot use your UMIACS credentials directly for accessing HTTPS Git repositories. We encourage users to setup SSH keys instead. If you have a case where you need to use HTTPS, you can use a Personal Access Token to accomplish this. Ensure that you create the token with API scope. You would then use your username and then the token as the password. Treat this token as a personal secret, as it is sufficient to act as your account within GitLab.
How do I authenticate with a Token?
We only currently support YubiKey tokens for our Duo deployment. You can follow the instructions from Yubico; you will need to tap the YubiKey once you select the Enter a Passcode field. It will create a passcode (will look something like kffuastenhldrhfhadafdarivuntddugrvjvllddjjuget) and send a return.