Skip to main content

Parallels RAS SAML integration

Multi-Factor Authentication (MFA) is an extra layer of security used when logging into websites or apps. Individuals are authenticated through more than one required security and validation procedure that only they know or have access to.

Security Assertion Markup Language (SAML) is a protocol for authenticating to web applications. SAML allows federated apps and organizations to communicate and trust one another’s users.

Arculix, as a SAML provider, improves the user login experience for Parallels RAS users with smart and convenient MFA.

Prerequisites

  • Configured Arculix instance and user account with administrative privileges for Arculix.

  • Configured Arculix LDAP Agent.

    For more information, see the Arculix LDAP Agent deployment guide.

  • User account with administrative privileges for the Parallels RAS server and console.

Note

Visit Parallels website for implementation of the Parallels RAS server.

Parallels RAS configuration

In this section, you'll configure Parallels RAS as a service provider (SP).

  1. Download the SAML metadata and certificate for your organization from Arculix.

    Metadata download: https://sso.acceptto.com/<myorganization>/saml/download/metadata

    View metadata: https://sso.acceptto.com/<myorganization>/saml/metadata

    Certificate download: https://sso.acceptto.com/<myorganization>/saml/download/cert

  2. Log in to your Parallels RAS server and open the RAS console. Then, navigate to Connection > SAML and click the + sign.

    parallels_add_saml.png

  3. In the Add Identity Provider wizard, set the following configurations.

    Name

    Set the name of the Identity Provider.

    For example, Arculix.

    Use with Theme

    Set to Default.

    Import Published IdP metadata

    Select this option and enter the download metadata URL from Arculix.

    For example, https://sso.acceptto.com/<myorganization>/saml/download/metadata

    parallels_idp_config.png

  4. Click Next.

  5. View the imported information on this page. Click Finish.

    parallels_idp_cert.png

  6. To apply the settings, click Apply.

    parallels_apply_settings.png

  7. On the Arculix SAML connection, right-click and select Properties.

    parallels_saml_properties.png

  8. Select the SP tab and copy the URLs.

    You will need these URLs for the Arculix side of the configuration in the next section.

    parallels_sp_urls.png

  9. Select the Attributes tab and do the following:

    • Select the Custom check box.

    • Change the SAML attribute to emailaddress.

    parallels_attributes.png

  10. Click OK, then Apply.

Arculix SAML configuration as an Identity Provider (IdP)

In this section, you'll add an application for Parallels RAS and set the SAML configuration settings. This will be the Identity Provider (IdP) side of the configuration.

  1. Log in to Arculix with an administrative account and go to Applications.

  2. Click Create New Application.

    Create new application

  3. In the New Application form, on the General tab, set the following configurations:

    Name

    Set the name of the application. This is the name to display for push notifications, in the Admin panel, Application portal, and audit logs.

    For example, Parallels.

    Type

    Set to SAML Service Provider.

    Out of Band Methods

    Select the allowed methods end users can choose to approve MFA requests.

    For example, Arculix Mobile app (push notifications), SMS, or Security Key.

    Message for MFA Requests

    Optional. Type a message displayed to end users when sending an MFA request via push notification, SMS, or email.

    arculix_new_app_parallels_001.png

  4. Select the SAML Service Provider Configuration tab, and set the following configurations:

    Issuer or Entity ID 

    Enter the SP entity ID from Parallels console.

    Log in URL 

    Enter Logon URL from Parallels console.

    NameID Format 

    Set to Email Address.

    Name Identifier 

    Set to Email.

    ACS URL 

    Enter the Reply URL from the Parallels console.

    Single Logout URL

    Enter the Logout URL from the Parallels console.

    Algorithm

    Set to RSA-SHA256.

    arculix_new_app_parallels_002.png

  5. On the same page, scroll down and click the Add New Attribute Assertion button and create a new attribute with the following configuration.

    Friendly Name

    Name

    Value

    Name Format

    Email

    emailaddress

    mail

    Unspecified

  6. Select the Sign Message check box.

  7. Save your changes.

Test your application integration

  1. Open a browser and go to the Parallels RAS gateway login page.

    For example, https://parallels.org-name.com/RASHTML5Gateway/.

  2. You will be redirected to the Arculix SSO page.

    Application login page with email

  3. After successful authentication, select your preferred MFA method to approve access to the Parallels RAS application.

    Select MFA method

  4. After approving the authentication attempt, you will be redirected to your Parallels RAS portal.

    parallels_dash.png

Support

If you have questions or need assistance, contact SecureAuth Support.

Sales

Want to learn more about our MFA solutions? Contact our Professional Services for a demo today.

Disclaimer

All product names, trademarks, and registered trademarks are the property of their respective owners.

All company, product, and service names used in this document are for identification purposes only. The use of these names, trademarks, and brands do not constitute an endorsement by the SecureAuth Corporation.

In this section: