Description
Email-based account discovery allows users to find a Parallels RAS farm by entering their email address instead of manually entering the farm server address. Native Parallels Clients support discovering Parallels RAS farms by email address.
Prerequisites
- A DNS TXT record must be configured for the users’ email domain.
- The TXT record must point to the Parallels RAS Secure Gateway.
- You must know the Secure Gateway hostname and listening port.
Configure the DNS TXT record
Create a TXT record in the forward lookup zone for the users’ email domain.
Use the following host name:
_prlsclient
Set the TXT record value in the following format:
hostname:port/theme;connmode=X;authmode=X
The parameters are defined as follows:
| Parameter | Description |
|---|---|
hostname |
Hostname of the server where the Secure Gateway resides. |
port |
Port on which the Secure Gateway listens for incoming connections. |
theme |
Theme used by the connection. |
connmode |
Connection mode. Possible values are 0 Gateway mode, 1 Direct mode, 2 Gateway SSL, and 3 Direct SSL. |
authmode |
Authentication type. Possible values are 0 Credentials, 1 SSO, 2 Smart Card, 3 Web (SAML), and 4 Web + Credentials for Windows clients. |
Examples of valid TXT record values include:
hostname
hostname:port
hostname:port/theme
[ipv6]:port
hostname;connmode=2;authmode=1
Connect to a farm using an email address
- Open Parallels Client.
- In the main Parallels Client window, click File > New Connection. The New Connection dialog opens.
- Enter your email address and click Next.
- Verify that the Server, Connection mode, and Friendly name fields are populated automatically, then click Next.
- In the Authentication type list, select the required authentication method.
- Enter the required authentication information and click Connect.
Authentication methods
- Credentials: Enter the username and password used to authenticate to the remote server. Select Save Password if permitted by your organization.
- Smart Card: Insert the smart card when prompted and enter the associated PIN.
- Single Sign-On: Use the local system credentials. This option is available when the Single Sign-On module is installed with Parallels Client.
- Web (SAML): Authenticate through the configured SAML identity provider.
- Web + Credentials: Use the web-based authentication flow followed by credentials where supported by the Windows client.
Note: The available authentication methods depend on the authentication modes configured for the Parallels RAS farm and the capabilities of the installed Parallels Client.
Was this article helpful?
Tell us how we can improve it.