All Products
Search
Document Center

WUYING Terminal:Log on to a desktop client

Last Updated:Jan 06, 2025

You can access Alibaba Cloud Workspace services such as Elastic Desktop Service (EDS) and Cloud Phone from a desktop client (Windows client or macOS client). This topic describes how to log on to a desktop client.

Important

In this topic, the Windows client of Alibaba Cloud Workspace V7.7 is used as an example. If your experience does not match the description in this topic, you may be using a different Alibaba Cloud Workspace client or your client is outdated. You must update your client to the latest version.

Simplified logon method

Alibaba Cloud Workspace terminals support multiple logon methods, such as single sign-on (SSO) and multi-factor authentication (MFA), and provide various advanced features. This section describes only the username-password-based logon method that is suitable for most scenarios. To learn about other logon methods and the advanced features of Alibaba Cloud Workspace terminals, see Alternative logon methods and advanced features.

Prerequisites

  • Cloud resources are assigned to you. After the administrator assigns you a cloud computer, you can obtain logon credentials, such as the organization ID, office network ID, username, and password, from the inbox of the email address specified by the administrator.

  • The client is installed. For more information, see Obtain and install a desktop client.

Procedure

  1. Open the Windows client, select Enterprise Edition in the upper part of the page, select the service agreement check box, enter an organization ID or office network ID from the received logon credentials, and then click the icon. pg_enter_orgid_or_networkid.png

  2. Enter the username and password, and then click the icon.

    Note

    If you log on to the client for the first time, use the initial password provided. You will then be prompted to specify a new password by following on-screen instructions. The initial password is valid for three days. If the initial password expires, click Forgot Password to obtain a new initial password.

    pg_enter_username_and_pw.png

    After you log on to the client, cloud resources, such as cloud computers, that your administrator assigns to you are displayed.

  3. On the cloud resource list, click the connect icon on a cloud resource card to use the resource.

Alternative logon methods and advanced features

This section describes the related concepts, alternative logon methods, and advanced features of Alibaba Cloud Workspace terminals. If you use username-password-based logon and do not require advanced features, see Simplified logon.

Background information

Roles of Alibaba Cloud Workspace users fall into the following categories:

  • End users: individuals who access cloud computers from Alibaba Cloud Workspace terminals. Example: Jack, a designer from a design company.

  • Administrators: O&M personnel who are responsible for resource purchase and renewal, resource creation and assignment, policy creation and binding, O&M and monitoring, and end user management. Example: Steven, the IT administrator of the company in which the designer Jack works.

image

Prerequisites

  • A user account is created for you and a cloud computer or cloud phone is assigned to the account. If you are an administrator, purchase and assign cloud resources as described in the following topics.

  • Logon credentials are obtained. After the administrator purchases and assigns EDS resources to you, you can receive logon credentials as an end user, such as the organization ID, office network ID, username, and password. The query methods of logon credentials vary based on the account type and the account activation type.

    Note

    For information about account types and their differences, see the "Account systems" section of the Overview topic.

    • Convenience accounts

      • Administrator-activated: Administrators configure logon credentials and password reset notifications in the EDS console and deliver the logon credentials to end users offline. Cloud Phone supports only administrator-activated convenience accounts.

      • User-activated: End users can obtain the logon credentials and password reset notifications from their inboxes of the email addresses specified by the administrator.

    • Enterprise Active Directory (AD) accounts: Administrators deliver the logon credentials to end users offline.

Procedure

  1. Launch the Windows client.

  2. Select Enterprise Edition in the upper-left corner and select the service agreement check box in the lower part of the logon page.

  3. Select a logon method.

    Username-password logon

    On the logon page, the username-password logon is used by default. If another logon method is displayed and you want to switch to the username-password logon method, click Account Sign-in.

    1. Enter the organization ID or office network ID and click the icon to proceed.

      Note

      Logon with an organization ID allows access to all Alibaba Cloud Workspace resources within the current user account, regardless of the office network to which each resource belongs. However, logon with an office network ID allows access only to the Alibaba Cloud Workspace resources in a specific office network within the current user account. For more information, see the "Compare office network IDs and organization IDs" section of the Configure logon settings topic.

    2. Perform one of the following operations based on SSO is enabled for the organization ID or the office network:

      What is SSO?

      SSO is a secure communication technology that helps users quickly access multiple application systems. SSO implements logon based on identity federation. It allows users to access all trusted systems after the users log on to one of the systems.

      • If SSO is disabled, enter the username and your custom password, and click the icon to proceed. If you want to be automatically logged on without the need to enter the username and password in the following period of time, select Auto Sign-in.

        Note
        • The first time you log on to the Alibaba Cloud Workspace client, use the initial password. Then, you are prompted to specify a new password by following the on-screen instructions. The next time you log on to the client, use the new password.

        • The initial password is valid for three days. If the initial password expires or you forget your custom password, click Forgot Password to reset the password as prompted.

        Important

        If you enter an incorrect password for 10 consecutive times, the account is locked for 20 minutes.

      • If SSO is enabled, enter the SSO username and password as prompted, and click the icon to proceed.

    QR code-based logon

    If you have logged on to an Android client, you can scan the QR code to log on to the Windows client.

    1. Open the Android client, click the ic_scanner.png icon in the upper-right corner, and then scan the QR code on the left side of the logon page of the Windows client.

      Note

      Only the Android client of Alibaba Cloud Workspace V7.0 or later supports QR code scanning.

    2. On the Android client, click Confirm Sign In on the confirmation page.

  4. Conditional. If your administrator has enabled MFA for your cloud computer, enter the dynamic password that is generated by the virtual MFA device.

    What is MFA?

    MFA is a simple and effective authentication method used to enhance security. After you activate MFA for office networks or organization IDs, Alibaba Cloud Workspace terminals require end users to go through two-level verification every time they log on.

    • First-level: Enter the correct username and password.

    • Second-level: Enter the dynamic code generated by the virtual MFA device.

      Note

      Time-based One-Time Password (TOTP) is a widely used multi-factor authentication protocol. Applications on mobile phones or other devices that support TOTP are called virtual MFA devices. Several examples of virtual MFA devices are Google Authenticator and Microsoft Authenticator. When MFA is activated, end users must enter a six-digit code dynamically generated by their virtual MFA devices when they log on to Alibaba Cloud Workspace terminals. This prevents unauthorized access due to compromised passwords.

    For more information about MFA, see Configure MFA.

    Note

    Before you use MFA, associate a virtual MFA device with your account as prompted. Alibaba Cloud Workspace supports various virtual MFA applications, such as Alibaba Cloud App and Google Authenticator App, that run based on the time-based one-time password (TOTP) algorithm.

  5. Conditional. If your administrator has enabled client logon verification, obtain the verification code that is sent to your associated email address and enter the verification code when you use a new logon device.

    Note

    The client logon verification feature applies only when you access your cloud computer over the Internet. The feature does not apply if you access your cloud computer over an Alibaba Cloud virtual private cloud (VPC).

  6. After you log on to the client, Alibaba Cloud Workspace services are displayed as cards or icons. Click a card or an icon to access Alibaba Cloud Workspace services.

    Note

    If the cloud computer is in the Stopped or Hibernated state, start or wake up the cloud computer.

FAQ

What do I do if the Windows client unexpectedly exits when I launch it?

This issue may be caused by the disabled port 55556. To resolve the issue, perform the following operations:

  1. Go to the directory in which the client is installed.

    By default, the client is installed in C:\Program Files (x86)\Wuying Cloud Computer.

  2. Open the bin folder, find the sdbus_daemon.conf file, and edit the file in a text editor.

  3. Change the port number.

    The default port number is 55556. You must change the port number to another port number that is not occupied. The port number ranges from 0 to 65535.修改端口号

  4. Relaunch the client.

Note

If the issue persists, check whether the root certificate of the Windows OS on the local PC is valid.

What do I do if I do not have the logon credentials?

Your administrator creates an account for you and assigns cloud resources to your account. The logon credentials are sent to the email address that is associated with your account. If you are unsure of the associated email address, contact your administrator. If you are the administrator, follow the instructions that are described in the Prerequisites section to create an account, purchase cloud resources, and assign the cloud resources to the account.

What do I do if the initial password that is included in the logon credentials becomes invalid, or if I forget the custom password?

On the password-based logon page, click Forgot password and enter your username and email address as prompted. The system sends another initial password to the email address. Use the initial password to log on to the client and configure a custom password.

Note
  • You can reset your password on the client only if you use a convenience account. Enterprise AD accounts are managed by enterprise AD systems. If you use an enterprise AD account and you want to reset the password, contact your administrator.

  • If an error message indicating an invalid email address appears when you reset the password, contact your administrator.

What do I do if I cannot log on to my client due to network exceptions?

In the upper-right corner of the client logon page, click the icon and select Settings. In the Settings panel, choose Network > Basic Diagnosis and click Diagnose to check whether network issues exist. If the network is normal but you still cannot log on to your client, contact your administrator.

What do I do if no cloud computer is displayed or an error message indicating that cloud computers fail to be assigned appears after I log on to my client?

Cloud computers are assigned by administrators. If you cannot find any cloud computer, contact your administrator. For more information, see What do I do if no cloud computer is displayed on the Alibaba Cloud Workspace client of an end user?

For information about how to resolve this issue, see FAQ about clients.

What to do next

For information about how to configure and use the client, see Configure and use a Windows client or a macOS client.

After you log on to an Alibaba Cloud Workspace terminal, you can view, use, and manage the assigned cloud resources.

For information about how to use cloud computers, see Use cloud computers.