diff --git a/docs/extramural_login.md b/docs/extramural_login.md index 8d496d5..9aef66d 100644 --- a/docs/extramural_login.md +++ b/docs/extramural_login.md @@ -6,72 +6,101 @@ Follow the steps in this document to access your Azure Cloud Lab account for the - **Section 3 – Set Up the Microsoft Authenticator App** – *Takes about 5 minutes* - **Section 4 – Access Your Cloud Lab Account** – *Takes about 1 minute* -*If you’ve already completed the account setup steps in Sections 1 through 3, jump to Section 4, which provides instructions for logging in to your Cloud Lab account moving forward. If you need assistance at any point in this process, please contact the NIH Cloud Lab team at CloudLab@nih.gov.* +*If you’ve already completed the account setup steps in Sections 1 through 3, jump to [Section 4](#sec4), which provides instructions for logging in to your Cloud Lab account moving forward. If you need assistance at any point in this process, please contact the NIH Cloud Lab team at CloudLab@nih.gov.* ## Section 1 of 4 – Launch the Account Set Up Process - *Takes about 2 minutes* 1. Look through your inbox for an automated email from Microsoft Invitations on behalf of the National Institutes of Health. Open the email and copy your personalized invitation link (outlined in red below).*Note: If you can’t find the email, check your junk or spam folders before contacting CloudLab@nih.gov.* ![Open Email](/docs/images/AZ_gm_1.png) -2. Paste the link into an incognito or private browser (you may experience login issues if you don’t use an incognito or private browser). If an **NIH login screen** opens (below left), follow the steps in Version A of the next section of this document. If a **Microsoft login screen** opens (below right), follow the steps in Version B of the next section of this document. + +2. Paste the link into an incognito or private browser (you may experience login issues if you don’t use an incognito or private browser). If an **NIH login screen** opens (below left), follow the steps in [Version A of the next section](#sec2a) of this document. If a **Microsoft login screen** opens (below right), follow the steps in [Version B of the next section](#sec2b) of this document. ## Section 2 of 4 – Version A – Confirm Your Identity *– Takes about 2 minutes* *Follow these instructions if your invitation link took you to an NIH login screen.* + 1. Enter your university or institution email address and click "Next". Then, follow the prompts to sign in with your standard university or institution username and password. [image] + 2. If you are directed to a "More information required screen", click the "Next" button. [image] -3. Skip to Section 3, and follow the steps to set up the Microsoft Authenticator mobile app. + +3. [Skip to Section 3](#sec3), and follow the steps to set up the Microsoft Authenticator mobile app. ## Section 2 of 4 – Version B – Confirm Your Identity *– Takes about 2 minutes* *Follow these instructions if your invitation link took you to a Microsoft login screen. Please note that these steps may look slightly different if your account has been linked with Microsoft in the past.* + 1. Enter the email address you used to submit the Cloud Lab Account Request Form and click "Next" (first image below). You will likely receive a message that the account doesn’t exist – that’s normal! Click the "Create one" link (second image below). *Note: If you already have a Microsoft account tied to the email address you used to submit the Account Request Form, follow the prompts to log in with your Microsoft password and then jump to the last few steps in this section.* [image] + 2. If prompted, create a password for your new Microsoft account and then click "Next". [image] + 3. If prompted, provide your first and last name. Then click "Next". [image] + 4. Check your email for a confirmation code (if you don’t see it, check your junk or spam folders). Copy the code, return to the Microsoft login screen, enter the code where prompted, uncheck the promotional email option, and click "Next". [image] + 5. If prompted, complete any additional verification steps. When you’re done, you may see a confirmation notice on screen. If prompted, advance to the next screen. [image] + 6. If prompted, accept the permissions requested by the National Institutes of Health. This will enable us to move cloud credits into your account. [image] + 7. If you are directed to a "More information required screen", click the "Next" button. [image] -8. Advance to Section 3, and follow the steps to set up the Microsoft Authenticator mobile app. + +8. [Advance to Section 3](#sec3), and follow the steps to set up the Microsoft Authenticator mobile app. + ## Section 3 of 4 – Set Up the Microsoft Authenticator Mobile App – *Takes about 5 minutes* *To keep the NIH environment safe for all researchers, Cloud Lab participants must use the Microsoft Authenticator mobile app to confirm their login attempts. **Please note that the next few steps switch back and forth between your personal or work smartphone and your computer.*** + 1. **On your computer:** At this point, you should see a "Keep your account secure" message on your screen. You can disregard this message for now and move to the next step. [image] + 2. **On your smartphone:** Check whether you have the Microsoft Authenticator mobile app installed on your personal or work smartphone. If you don’t already have it, use the App Store or Google Play to install it. [image] + 3. **On your computer:** Once the app is installed on your smartphone, click the “Next” button on your computer screen. [image] + 4. **On your smartphone:** Open the Microsoft Authenticator mobile app (first image below), accept any permissions, and skip any welcome messages until you’re at the home screen. Click the "+" sign (second image below) and then select the "Work or school account" option (third image below). In the menu that opens, select "Scan a QR code" (last image below), which will open your smartphone’s camera. [image] + 5. **On your computer:** Click the "Next" button. A QR code should appear on your computer screen (second image below). [image] + 6. **On your smartphone:** Use your camera to scan the QR code. + 7. **On your computer:** Click the "Next" button. A "Let’s try it out" message should appear on your computer screen (second image below). [image] + 8. **On your smartphone:** A notification should appear prompting you to confirm the login attempt. Enter the number from your computer screen into the Microsoft Authenticator app notification window and tap "Yes". [image] + 9. **On your computer:** A “Notification approved” message should appear. Click the "Next" button and then click "Done". [image] -10. **On your computer:** A Cloud Lab terms of use screen should appear. Click the document title to open and review it. Then click “Accept.” After accepting the terms of use, you may be redirected to an “Apps dashboard” screen (second image below). Disregard this screen and move to the final section of this document. + +10. **On your computer:** A Cloud Lab terms of use screen should appear. Click the document title to open and review it. Then click “Accept.” After accepting the terms of use, you may be redirected to an “Apps dashboard” screen (second image below). Disregard this screen and move to the [final section](#sec4) of this document. [image] + ## Section 4 of 4 – Access Your Cloud Lab Account – *Takes about 1 minute* *Congratulations! At this point, your account is set up, and you’re ready to log in. In the future, repeat the steps in this section each time you want to access your Cloud Lab account.* + ***Important:** If you plan to use Azure OpenAI services with your Cloud Lab account, you may want to submit Microsoft’s mandatory [OpenAI enablement request form](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUNTZBNzRKNlVQSFhZMU9aV09EVzYxWFdORCQlQCN0PWcu) now ([step-by-step instructions available here](https://github.com/STRIDES/NIHCloudLabAzure/blob/model_access_doc/docs/azure_model_access.md) if needed). Once you submit the form, you can expect to get access to OpenAI within two to ten business days. You only need to complete this step once.* 1. Launch the Azure portal by visiting [portal.azure.com](https://portal.azure.com/). If a login screen opens, sign in with the credentials you used to set up your account (either your university/institution username and password or your Microsoft username and password). 2. If your computer prompts you to approve the sign in attempt (first image below), enter the code that appears on your computer screen into the Microsoft Authenticator notification that pops up on your smartphone and then tap “Yes” (second image below). [image] + 3. You should now arrive at the Azure homepage. You can cancel or advance through any welcome content. [image] + 4. Check the area to the left of your profile icon under your username. If this area is blank or contains your university or institution’s name, click your profile icon and select the "Switch directory" option. *Note: If this area already says "National Institutes of Health", you are all set and ready to use your account.* + 5. In the list of directories toward the bottom of the screen, find the "National Institutes of Health" option and click the "Switch" button next to it. [image] + 6. Once you see "National Institutes of Health" listed next to your profile icon at the top right of the screen, you are all logged in and ready to use your $500 of Cloud Lab credits. Check out our [Azure Jumpstart page](https://cloud.nih.gov/resources/cloudlab/azure-jumpstart/) for ideas on what to do next! [image]