Embedded Files
Author: Eric Vasbinder
CRITICAL NOTE: this article is ONLY applicable to users who log in to our RDP terminal services to access Vista or other client-side applications that are hosted in our cloud.
This article does NOT apply to Trimble ID SSO sign ends or to sign ins with Vista Remote Link (VRL), UNLESS those VRL users are making use of our older login name format "VIEWPOINT\username.code"
IMPORTANT
Logging in to AVD via a real, installable client program is our preferred option to experience RDP in our cloud over AVD. If you cannot use a real, installed, native application, you may also log in to AVD/RDP with a web browser.
Please see the following cloud FAQ article for step by step instructions on how to log in via the web client:
Logging In - Via Azure Virtual Desktop (AVD) Web Client (BACKUP ONLY)
CRITICAL NOTE - POSSIBLE LOGIN ERROR WORKAROUND
CRITICAL NOTE - POSSIBLE LOGIN ERROR WORKAROUND
You may encounter an error during the login process that says, "User does not exist in tenant" or "Sorry, but we are having trouble signing you in." The cause of this may be your cached Microsoft credentials from your existing, primary, AD/Azure AD account. Please walk through signing in to the AVD client using your regular, primary Azure AD (Entra ID) account first, then unsubscribe from the newly added account in the Remote Desktop client. Then proceed through the steps below to log in with your real, Trimble AVD account, which has a different username from your standard Microsoft Azure AD account.
For more details, and step by step instruction on how to work around this problem with cached Microsoft credentials, please set up an AVD subscription using your actual AD account (e.g. "email@company.com", then set up another with your new AVD Viewpoint cloud account (e.g. "first.lastname.code@viewpoint.cloud"). This should all be done in the AVD Client. Then, once added, please remove the redundant entry (should be blank) for your main Azure AD account.
Step by Step Login to Your AVD Account
Step by Step Login to Your AVD Account
The following series of steps will walk you through the process of logging into your Azure Virtual Desktop (AVD) account. Please remember these steps are exactly the same, no matter which AVD client is being used.
1. Find Your Installed AVD Client
1. Find Your Installed AVD Client
Use your computer's search function, or find the icon in the start menu, etc. to open your AVD client of choice and double click the icon.
Figure 1: Standard Windows RDP Client
2. Add the Subscription for Your Cloud Applications
2. Add the Subscription for Your Cloud Applications
You'll notice that you do not have any resources or published applications listed as you have yet to log in. As such, you'll need to "Subscribe" to your resources. Please click on either the blue "Subscribe" button OR, click the "Three Dot" menu and then "Subscribe".
Figure 2: Click Your Subscribe option of Choice - either works
2. Standard Microsoft Sign In Steps
2. Standard Microsoft Sign In Steps
The following steps are applicable two every time you log into AVD via the web browser client.
You will be presented with a Microsoft Azure AD style login screen that should look very familiar to those of you who currently use Azure Active Directory (AAD) or Microsoft / Office 365.
Please enter your account's name, which should be in the following format. (NOTE: If you do not know your company code, please reach out to your Trimble Viewpoint ERP Cloud systems administrator):
Username: firstinitial.lastname.companycode@viewpoint.cloud
Click Next
Figure 1: Enter your username
4. Enter your password and click Sign In. Please note, if you have used any of our RDP terminal services options in the past, such as cloudworkspace by NetApp, your password should be the same as your previous account.
Figure 2: enter your password and click sign in
First Sign In Only Steps
First Sign In Only Steps
The following set of steps are only applicable to your first sign in to AVD.
5. Microsoft will ask you to set up multifactor authentication (MFA). Please click the "Next" button.
Figure 3: Begin MFA Set Up
6. You will now be able to choose the MFA option that you would like to use. We highly recommend the Microsoft Authenticator application as it tends to be quite convenient and more secure than other options, such as SMS cell phone text messaging. However, if you wish you may click the "I want to set up a different method" link on the bottom left which will allow you to choose between SMS text and a Google authenticator style time-based code (.a.k.a. TOTP).
NOTE: We will only be documenting the steps to use Microsoft Authenticator. For steps to set up the other two optional methods instead, please see Microsoft online help documentation.
7. Please click "Next".
Figure 4: Click Next for Preferred Option
Figure 5: Choose an Optional Alternative Second Authentication Factor
8. Click next on the following screen. After doing so, your computer's screen will show a QR code which can be scanned in the following steps.
Figure 6: clicking next will show the QR code needed
9. Download and install the Microsoft Authenticator app on your phone or tablet. Please note, the application is available from both the Apple App Store as well as the Google Play Store. Merely search for Microsoft Authenticator.
10. Once installed, please tap the icon on your mobile device to start the application.
Figure 7: tap the Authenticator icon
11. On your mobile device Tap the plus icon
Figure 8: Tap the plus icon
12. Tap the option to add a work or school account.
Figure 9: work or school account
13. Tap "Scan QR code".
Figure 10: tap scan QR code
14. Your mobile device will now show the screen to scan the QR code that is on your computer's monitor. Hold your mobile device's camera so that the QR code is displayed within the box. The Microsoft Authenticator application will automatically add the account as part of the next step.
Figure 11: scan the QR code
15. AVD will send a notification to your phone or tablet, while at the same time displaying a number on your computer's screen. Inside the notification on your mobile device please enter the number displayed on your computer's screen. Once entered please click "yes".
Figure 12: screen on the computer
Figure 13: screen to enter number on app
16. Once you have entered the number and tapped a yes on the mobile application, if you are successful you will receive a notification approved message on your computer. Please click "next" on that screen.
Figure 14: notification approval message
17. On your mobile device, you will know the process of adding your account to your Microsoft Authenticator application is complete when your new account is shown in the app.
Figure 15: account added to the app
18. You will receive a notification on your computer saying that your new MFA method has been successfully added to your account. Please click done to continue
Figure 16: click "done" to continue
Regular Sign in Steps (Continued)
Regular Sign in Steps (Continued)
19. In the future, when logging into your AVD account, you may be prompted to enter a number into your Microsoft Authenticator application on your mobile device. This should be very similar to the items listed above in step 15.
20. Once you have entered the MFA number prompt, you will then be asked if you wish to Stay Signed in. Please select your preferred option.
Figure 15: To stay signed in or not to stay signed in - that is the question...
21. Once you have logged in, your RDP/AVD client will automatically show the feed icons that are appropriate for your AVD account.
Welcome to the use of Trimble Viewpoint ERP cloud with Azure virtual desktop!
Figure 16: your published app feed icons
changelog
Wednesday, 15 November 2023 at 02:10PM:
Updated to remove confusing link for workaround for cached credentials.
Monday, 13 November 2023 at 02:53PM:
Couple of minor word changes
Wednesday, 08 November 2023 at 08:01AM:
removed screenshot of MSFT app store client as it is still in beta and quite non-functional compared to the real, downloadable windows program.
Monday, 16 October 2023 at 04:32PM:
Added link to KB about problems with cached AAD creds.
Tuesday, 10 October 2023 at 04:13PM:
Screenshot updates
Tuesday, 26 September 2023 at 10:21AM:
Updated to be rich client login ONLY.
Monday, 25 September 2023 at 10:10PM:
Initial Publication
tags: Azure Virtual Desktop, AVD, New RDP Method, CloudWorkspace Replacement, NetApp Replacement, NetApp EOL, CloudWorkspace EOL, logging in to AVD web client, AVD web login, log in to AVD web
Page updated
Report abuse