If you access the CloudBees platform with a CloudBees username and password, use multifactor authentication (MFA) to secure your CloudBees platform account.
| You can only use CloudBees multifactor authentication if you access the CloudBees platform with a CloudBees username and password. If you use Google social or GitHub OAuth credentials, you must set up multifactor authentication through Google or GitHub, respectively. |
Enabling MFA
The additional authentication step with multifactor authentication provides more security than a single account password. To use multifactor authentication, you must have a third-party authentication app, such as Google Authenticator, installed on your phone.
To enable MFA:
-
Select your name in the right corner of the title bar.
-
Select Edit profile.
-
Select ENABLE MULTIFACTOR AUTHENTICATION to display a QR code.
-
Open the authentication app on your phone, and then add a new account to the app.
-
In your authentication app, select the option to scan a QR code.
-
Hold your phone up to your computer screen so that it can scan the CloudBees QR code. Once it scans, a code appears on your phone.
-
In the CloudBees platform, select Enter code. Enter the code displayed in the authentication app, and then select CONTINUE.
-
A single-use recovery code is displayed. The recovery code enables you to sign in to CloudBees platform without your phone. Copy the code somewhere safe, and then select OK.
You have added MFA with your authentication app to your platform account, and you have a recovery code saved in case you lose access to your phone.
Signing in with MFA
To use MFA, sign in to the platform as usual with your CloudBees username and password, and then enter a verification code from your authentication app.
To sign in with MFA:
-
Sign in with your CloudBees username and password.
-
Enter the verification code from your authentication app.
-
Select the .
You are signed in to the platform using MFA.
Signing in with an MFA recovery code
If you lose access to your device, you can still sign in to the platform using a recovery code.
To sign in with a recovery code:
-
Sign in with your CloudBees username and password.
-
Select Use the recovery code.
-
Enter your recovery code from Enabling MFA.
Any recovery code that is used to sign in to the platform cannot be reused. -
Copy the displayed new recovery code somewhere safe.
-
Select I have safely recorded this code.
-
Select the .
You are signed in to the platform using your MFA recovery code, and have saved a copy of your new recovery code.