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.
If you have NOT signed in to your AVD account yet, if this is the first time to signin, you will need to follow the instructions listed here:
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 (see this article for links to download an AVD client: How to Choose and Download the Proper Azure Virtual Desktop (AVD) Client) and click the icon.
Figure 1: Standard "Windows" App
2. Sign In to Your Trimble ERP Cloud Account in the "Windows" App
2. Sign In to Your Trimble ERP Cloud Account in the "Windows" App
Using your "viewpoint.cloud" account, you should now sign in to the application.
Click the "Sign In" button.
Fill in your full "Viewpoint.cloud" username into the following signin screen.
Click Next.
Figure 2: Enter Full Trimble / Viewpoint Cloud AVD username
4. Enter Your Password and Click Sign In.
Figure 3: Enter Password and Click Sign In
5. Use Your MFA to Complete Sign In
Approve the signin on your Authenticator app OR enter the appropriate code.
Figure 4a: Approve With Authenticator
Figure 4b: Enter Code
2.1. First Sign In Only Steps
2.1. First Sign In Only Steps
The following set of steps are only applicable to your first sign in to AVD.
1. Microsoft will ask you to set up multifactor authentication (MFA). Please click the "Next" button.
Figure 3: Begin MFA Set Up
2. 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.
3. Please click "Next".
Figure 4: Click Next for Preferred Option
Figure 5: Choose an Optional Alternative Second Authentication Factor
4. 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
5. 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.
6. Once installed, please tap the icon on your mobile device to start the application.
Figure 7: tap the Authenticator icon
7. On your mobile device Tap the plus icon
Figure 8: Tap the plus icon
8. Tap the option to add a work or school account.
Figure 9: work or school account
9. Tap "Scan QR code".
Figure 10: tap scan QR code
10. 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
11. 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
12. 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
13. 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
14. 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
2.2 Regular Sign in Steps (Continued)
2.2 Regular Sign in Steps (Continued)
1. 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.
2. 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...
3. Access Your Resources
The first screen
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