All Products
Search
Document Center

WUYING Terminal:Log on to a desktop client

Last Updated:Sep 05, 2025

You can use WUYING services, such as WUYING Workspace and WUYING AppStreaming, from a desktop client (Windows client or macOS client). This topic describes how to log on to a desktop client.

Important

This topic uses the macOS client V7.13 and the Enterprise Edition as an example. If your client interface differs from the one described in this topic, you may be using a different or outdated version. We recommend that you update your client to the latest version.

Simplified version

The WUYING Terminal logon module supports multiple logon methods and advanced features, such as single sign-on (SSO) and multi-factor authentication (MFA). This simplified version demonstrates the standard username and password logon method, which applies to most users. For advanced features and other logon methods, see the Detailed version.

Prerequisites

  • An administrator has allocated cloud resources to you. Check the mailbox specified by your administrator for your logon credentials, including the organization ID or office network ID, username, and password.

  • You have installed the client. For more information, see Install and update a desktop client.

Procedure

  1. Open the Windows client, select Enterprise Edition in the upper part of the page, select the check box next to the privacy policy, 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 and cloud phones, 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.

Detailed version

The Detailed version explains related concepts, various logon methods, and advanced features. If you use the username and password logon method and do not need advanced features, see the more concise Simplified version.

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

  • An administrator has created an end user account for you and allocated WUYING service resources (cloud computers and cloud applications) to the account. If you are an administrator, you must first purchase and allocate cloud resources as described in the following topics.

  • You have received the logon credentials required to log on to the client. After an administrator purchases and allocates WUYING service resources, you, as an end user, will receive logon credentials, such as the organization ID or office network ID, username, and password. The method for obtaining logon credentials varies based on the end user account type and the activation type:

    Note

    For more information about end user account types and their differences, see End user account systems.

    • Convenience account

      • Administrator-activated type: The administrator sets the logon credentials and password reset notifications for the end user account in the WUYING Workspace console and informs the end user offline. WUYING AppStreaming supports only administrator-activated convenience accounts.

      • User-activated type: The logon credentials and password reset notifications for the end user account are sent to the end user's mailbox.

    • Enterprise Active Directory (AD) account: The administrator informs the end user offline.

Procedure

  1. Open the desktop client.

  2. Configure the network connection type:

    1. In the upper-right corner, click the icon and select Network Connection Configuration.

    2. In the Network Connection Configuration panel, select Internet or Enterprise Private Network, and click OK.

      Note

      Consult your enterprise IT administrator to determine which connection type to select.

  3. At the top, select Enterprise & Commercial Edition. At the bottom, agree to the privacy policy.

  4. Select a logon method.

    Username and password logon

    On the logon page, the username and password logon method is selected by default. If it is not selected, click Username And Password Logon.

    1. Enter the organization ID or office network ID from your logon credentials and click the icon.

      Note

      When you log on with an organization ID, you can access all WUYING resources under your account, regardless of the office network. When you log on with an office network ID, you can access only the WUYING resources that belong to that specific office network. For more information about the differences, see Differences between organization IDs and office network IDs.

    2. Perform one of the following operations based on whether the administrator has enabled single sign-on (SSO) for the organization ID or office network:

      What is SSO?

      Single sign-on (SSO) is a secure communication technology that helps users quickly access multiple application systems. It is also known as federated identity logon. SSO lets you log on once to access multiple trusted systems.

      • If SSO is not enabled, enter your username and password and click the icon. To stay logged on, you can select Auto-login.

        Note
        • When you log on for the first time, enter the initial password from your logon credentials and follow the prompts to set a custom password. Use this custom password for all future logons.

        • The initial password is valid for 3 days. If you are notified that your password has expired when you log on, or if you forget your password, click Forgot Password and follow the prompts to reset your password.

        Important

        Enter the correct password when you log on to the client. If you enter an incorrect password 10 consecutive times, the system automatically locks your account for 20 minutes. You cannot attempt to log on again for 20 minutes.

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

    Log on by scanning a QR code

    If you are already logged on to an Android client or iOS client, you can log on by scanning a QR code.

    1. Open the Android client or iOS client that you are logged on to. In the upper-right corner of the cloud resource list screen, click the icon and scan the QR code on the desktop client logon screen.

      Note

      Only V7.0 and later of the Android client or iOS client support QR code scanning.

    2. On the Confirm Logon screen on your Android client or iOS client, click Confirm Logon.

  5. (Conditional) If your administrator has enabled multi-factor authentication, enter the dynamic password 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 Set MFA for logon.

    Note

    If your IT administrator enables TOTP dynamic passwords, follow the on-screen prompts to attach a virtual MFA device the first time you log on. You can use various virtual MFA applications, such as Alibaba Cloud App and Google Authenticator.

  6. (Conditional) If your administrator has enabled client logon verification, you must obtain and enter a verification code from your email to complete the client logon when you log on from a new device.

    Note

    Client logon verification applies only when the network connection type is the Internet. It does not apply if the network connection type is an enterprise private network.

  7. After you log on, WUYING services are displayed as cards or icons. Click a service icon to access the service.

    Note

    If a cloud computer is in the Stopped or Hibernated state, you must first start it or wake it up.

FAQ

What do I do if the Windows client unexpectedly quits after I open 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 required logon credentials?

After an administrator creates an end user account and allocates cloud resources to the account, the logon credentials are sent to the mailbox associated with the account. If you are unsure of the associated mailbox, contact your administrator. If you are the administrator, follow the instructions in the Prerequisites section to create an end user account, purchase cloud resources, and allocate the resources.

What do I do if the initial password in the logon credentials expires, or if I forget my password?

On the username and password logon screen, click Forgot Password and follow the prompts to enter your username and enterprise mailbox . The system sends a new initial password to your mailbox . Use this initial password to set a custom password.

Note
  • Only convenience accounts support password resets from the client. AD accounts are controlled by the enterprise AD. For AD accounts, you can only reset your password during the first logon or when the password expires. For all other password reset requests, contact your administrator.

  • If an error message indicating an incorrect mailbox appears when you reset your password, and the error persists after multiple attempts, contact your administrator.

What do I do if I cannot log on to the client due to a network exception?

In the upper-right corner of the client logon screen, click the icon and select Settings. In the Settings window, select Network > Basic Diagnosis and click Diagnose. If the diagnosis shows no issues but you still cannot log on to the client, contact your administrator.

What do I do if no cloud computer is displayed or a message indicates that the cloud computer resource failed to be allocated after I log on to the 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 more FAQ, see Client FAQ.

What to do next

Enable and set auto-login

If you enable auto-login, you do not need to re-enter your logon credentials for a period of time after you log on.

  1. Open the desktop client. On the Username and Password Logon screen, select Auto-login.

    settings_auto_signin_on_startup.png

  2. (Optional) The default validity period for auto-login is 10 days. To change the validity period, log on, click the icon in the upper-right corner, and then click Security Center. On the Logon Security tab, select a new validity period in the Auto-login section.

    settings_auto_signin.png

Use cloud computers and cloud applications

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 resources, see the following topics:

Log out

Log out from the current terminal

On the cloud resource list screen, use one of the following methods to log out:

  • In the upper-left corner, click Log Out, and then click Log Out again in the confirmation dialog box.

  • In the upper-right corner, click the icon, and then select Log Out. In the confirmation dialog box, click Log Out again.

Log out from other terminals

  1. In the upper-right corner of the cloud resource list, click the icon and select Security Center.

  2. On the Device Management tab, find the other logged-in terminal and click Log Out.

    Note

    To ensure information security, you must enter a verification code to authenticate your identity before you log out.

    tab_signedin_devices