RAS Management Portal
ProductsSupportPartnersDocumentation
English
English
  • Introduction
    • Parallels RAS release history
    • Overview
    • What's new
  • Installation and Configuration
    • Prerequisites
    • Installation
  • Get Started with RAS Management Portal
    • Log in to RAS Management Portal
    • Configure RAS Web Administration Service
    • RAS Management Portal user interface
  • Site Category
  • Farm Settings
    • Administrators
    • Mailbox
    • Licensing
  • Site Settings
    • Connection and authentication
    • Multi-factor authentication
      • Using RADIUS
      • Using Google Authenticator
      • Configuring MFA rules
    • FSLogix Profile Container
      • Configure managing existing profiles by Parallels RAS
      • Configure Site defaults and hosts for FSLogix
    • Universal Printing
    • Universal Scanning
  • Infrastructure
    • RD Session Hosts
      • Add an RD Session Host
      • Configure an RD Session Host
        • Using Site or host pool defaults
        • General
        • Agent Settings
        • User Profile
        • Desktop Access
        • Printing and Scanning
      • Manage an RD Session Host
        • Overview
        • Active Sessions
        • Running Resources
        • Running Processes
        • Troubleshooting
      • RDSH groups
    • Virtual Desktops Infrastructure
    • Certificates
      • Generate a self-signed certificate
      • Generate a certificate signing request (CSR)
      • Let's Encrypt certificates
        • Working with Let's Encrypt certificates
        • How Parallels RAS requests certificates from Let's Encrypt
      • Import a certificate from a file
      • Export a certificate to a file
      • Assign a certificate to Gateways and HALB
    • Gateways
      • Add a Gateway
      • Configure a Gateway
        • General
        • Mode
        • Network
        • SSL/TLS
          • Client and Server configurations
        • User Portal
          • Web
        • Wyse
        • Security
      • Managing Gateways
    • Connection Brokers
      • Configure RAS Connection Broker
      • Add a secondary Connection Broker
      • Manage RAS Connection Brokers
    • Providers
    • Site defaults
  • Sessions
    • Overview
    • Session information
    • User sessions
    • Running resources
  • Publishing
    • Publish an application
    • Publish a desktop
    • Publish a document
    • Publish a folder on the file system
    • Manage published resources
      • Manage published applications
      • Manage published desktops
      • Manage folders
      • Site defaults (Publishing)
      • Using filtering rules
      • Configuring preferred routing
  • Monitoring
    • Overview
    • Install RAS Performance Monitor
    • Enable monitoring in RAS Management Portal
    • Viewing performance metrics
    • Configure RAS Performance Monitor Security
  • Updating RAS Agents
  • Help and Support
  • Appendix
    • Microsoft license requirements in Parallels RAS
    • Port reference
      • Parallels Client
      • Web browsers
      • HALB
      • RAS Secure Gateway
      • RAS Connection Broker
      • RAS Console
      • SSRS
      • RAS Reporting
      • RAS Web Administration Service (REST/Management Portal)
      • RAS PowerShell
      • RAS Provider Agent
      • RAS Enrollment Server
      • RAS RD Session Host Agent
      • RAS Guest Agent
      • RAS Remote PC Agent
      • Tenant Broker
      • Active Directory and Domain Services ports
      • Azure Virtual Desktop
    • RAS performance counters
Powered by GitBook

© 2025 Parallels International GmbH. All rights reserved.

On this page
  • Choosing authentication type
  • Authentication domains
  • Changing domain password
  • Allowed devices

Was this helpful?

Export as PDF
  1. Site Settings

Connection and authentication

To manage connection and authentication settings, navigate to Site Settings > Connection.

Choosing authentication type

When users connect to a Site, they are authenticated before they are logged in. To configure authentication type, in the Connection pane, select Authentication and then select one of the following:

  • Credentials. The user credentials are validated by the Windows system on which RAS is running. The credentials used for Windows authentication are also used to log in to an RDP session.

  • Smart Card. Smart card authentication. Similar to Windows authentication, smart card credentials can be shared between both RAS and RDP. Hence, smart card credentials only need to be entered once. Unlike Windows authentication, the user only needs to know the smart card’s PIN. The username is obtained automatically from the smart card, so the user doesn't need to provide it.

  • Web (SAML). SAML SSO authentication.

  • Web + Credentials. The same as Web (SAML), but users are prompted to enter credentials when they launch a published application.

Note that if smart card authentication is disabled, RAS Connection Broker will not hook the Local Security Authority Subsystem Service (LSASS). Smart card authentication can be used in Parallels Client for Windows, Mac, and Linux. Please also note that smart cards cannot be used for authentication if Parallels Client is running inside an RDP session.

A valid certificate must be installed on a user device in order to use smart cards. To do so, you need to import the certificate authority root certificate into the device’s keystore.

A certificate must meet the following criteria:

  • The "Key Usage" field must contain digital signature.

  • The "Subject Alternative Name" (SAN) field must contain a user principal name (UPN).

  • The "Enhanced Key Usage" field must contain smart card logon and client authentication.

Authentication domains

To specify a domain (or multiple domains) against which the authentication should be performed, select one of the following:

  • Specific: Select this option and type a specific domain name.

  • All trusted Domains. If the information about users connecting to Parallels RAS is stored in different domains within a forest, select the All Trusted Domains option to authenticate against multiple domains.

  • Use client domain if specified. Select this option to use the domain specified in the Parallels Client connection properties. If no domain name is specified on the client side, the authentication is performed according to the settings above.

  • Force clients to use NetBIOS credentials. If this option is selected, the Parallels Client will replace the username with the NetBIOS username.

Note: If a certificate on your smart card does not contain a user principal name (UPN) in the "Subject Alternative Name" (SAN) field (or if it doesn't have the "Subject Alternative Name" field at all) you have to disable the Force clients to use NETBIOS credentials option.

Recommendation: After changing domain names or some other authentication related changes, you should clear cached session IDs. At this time, this can only be done from the RAS Console, where you need to click the Clear cached session IDs button on the Settings tab.

In order to authenticate users sessions against users specified on a standalone machine, you must enter the [workgroup_name] / [machine_name] instead of the domain name. For example if you would like to authenticate users against a list of local users on a machine called SERVER1 that is a member of the workgroup WORKGROUP, enter the following in the domain field: WORKGROUP/SERVER1.

Changing domain password

You can configure Parallels Client to use a custom URL for changing domain passwords.

To make Parallels Client use a custom URL for changing domain passwords:

  1. Select Use a custom link fro the "Change domain password" option.

  2. Add the link to the text field below.

Allowed devices

PreviousSite SettingsNextMulti-factor authentication

Was this helpful?

In the Allowed devices pane, specify whether clients must have the latest security patches in order to connect to the Farm. This option must normally be selected to protect your environment from vulnerabilities. You should only clear it if you must use an older version of Parallels Client with no security patches installed. For more information, please see the following KB article: .

https://kb.parallels.com/en/125112