Skip to main content

Leostream

Introduction#

Multi-factor authentication (MFA) is an extra layer of security used when logging into websites or apps to authenticate users through more than one required security and validation procedure. 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.

Leostream develops a vendor-neutral connection broker, which is software that maps end users to computing resources, such as desktops, that are hosted in a data center. A connection broker integrates end-user access points, including thin clients, laptops and Web browsers, with back-end systems hosting desktops and applications. It also integrates all other data center systems required for a virtual desktop infrastructure, including security, authentication, and load balancing systems.

Acceptto, as a SAML provider, improves the user login experience for Leostream users with convenient MFA. This manual illustrates how to configure Leostream with Acceptto’s single sign-on (SSO) solution.

Pre-Requisites#

  1. An Acceptto account with a configured Identity Provider and LDAP Agent (see this page for instructions).
  2. A user with administrative privileges for the Acceptto service.
  3. An organization identifier provided by Acceptto (organization slug).
  4. Leostream 9 or higher. SAML logins are currently supported only for user’s logging in using the Leostream Web client. Leostream Connect, thin client, and zero client logins do not support SAML-based authentication.
  5. A user with administrative privileges for Leostream.

Acceptto SAML Configuration as Identity Provider (IdP)#

  1. Log into the Acceptto Dashboard with an administrative account and go to Applications.

  2. Create a new application by selecting the Create New Application.

    Create new app

  3. In the New Application form, enter the following values under the General tab.

    • Name - The application name displayed in the admin panel and application portal and used for push notifications and audit logs. (e.g. Leostream)
    • Type - Select "SAML Service Provider" from the options
    • Out of Band Methods - Select the allowed methods for approving MFA requests
    • Message for MFA Requests - Enter the user-facing message for Push, SMS, and e-mail MFA requests (optional)

    New app settings

  4. Under the SAML Service Provider Configuration tab, enter the following values:

    • Issuer or Entity ID– Enter the Issuer/EntityID of your Leostream instance (e.g. LeostreamBroker). Sign in URL - The URL used to login to your Leostream (e.g. https://Leostream_FQDN /saml).
    • NameID Format - Select "Unspecified" from the dropdown menu.
    • Name Identifier - Select "userPrincipleName" from the dropdown menu.
    • Assertion Consumer Service (ACS) URL - Enter the URL on the service provider where the identity provider will redirect to with its authentication response (e.g. https://Leostream_FQDN /saml).

    App SAML settings

    • Click "Add New Attribute Assertion" button and create attributes like the below image:
    Friendly NameNameValueName Format
    EmailemailuserPrincipalNameurn:oasis:names:tc:SAML:2.0:attrname-format:unspecified
    LoginloginsAMAccountNameurn:oasis:names:tc:SAML:2.0:attrname-format:unspecified
    memberOfmemberOfmemberOfurn:oasis:names:tc:SAML:2.0:attrname-format:unspecified
    Last Namelastnamesnurn:oasis:names:tc:SAML:2.0:attrname-format:unspecified
    First Namefirstnamecnurn:oasis:names:tc:SAML:2.0:attrname-format:unspecified

    Asserted attributes

  5. Click Save to create the Application.

  6. Download your SAML IdP X509 certificate. Go to https://sso.acceptto.com/[organization identifier]/saml/download/cert to download the cert.pem file containing your certificate.

  7. Download your SAML metadata file. Go to https://sso.acceptto.com/[organization identifier]/saml/download/metadata to download your metadata file.

Configure Leostream as a SAML Service Provider#

After creating your Application in Acceptto, register it with Leostream by creating a SAML authentication server in your Connection Broker, as follows.

  1. Go to the Setup > Authentication Servers page.

  2. Click the Add Authentication Server link.

  3. Select SAML from the Type drop-down menu. You can add a single SAML IdP to your Connection Broker. Therefore, you will not see the SAML option in the Type drop-down menu if you already defined a SAML IdP. If you do not see the SAML option in the Type drop-down menu and your Authentication Servers page does not already list a SAML IdP, contact sales@leostream.com to enable SAML IdP integration in your Leostream environment.

  4. Enter a descriptive name in the Authentication Server Name field.

  5. In the SAML EntityID edit field, enter the unique Entity ID you specified when creating the Application in Acceptto.

  6. Under the Connection Settings section, enter the following values:

    • Identity Provider login URL - Enter the SingleSignOnService URL you obtain from the Metadata XML file you downloaded earlier from Acceptto.
    • Identity Provider XML Metadata - Enter the content of the Metadata XML file you downloaded earlier from Acceptto.

    Connection settings

  7. By default, after you created a SAML-based authentication server, the Connection Broker redirects all users to the Acceptto login URL when the user visits the Connection Broker login page. To allow users to bypass the SAML-based authentication server, select the Enable user logins without SAML check box.

  8. Click Save.

  9. Go to the Configuration > Assignments. Click Edit on your Acceptto Authentication Server. Enter memberOf in the Attribute field and select Contains in the Conditional box.

    User role and policy

  10. Add groups based on the Group name, which is case sensitive.

  11. Add the application pools and assign groups to them.

Test Your Setup#

  1. Go to your Leostream URL through a browser.

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

    Sign in page

  3. After successful authentication, you’ll see the Acceptto MFA options. Select your desired method. Next, approve the authentication request on your It'sMe mobile app.

    Acceptto MFA

  4. Finally, you will be redirected to your resource page.

    Resource page

Support#

If you require assistance, please email us at support@acceptto.com

Sales#

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

Disclaimer#

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