This article provides instructions to enable the Single Sign-On (SSO) feature for Appspace Cloud.

With SSO, Appspace Cloud accounts can now be configured to integrate with Security Assertion Markup Language (SAML) 2.0 compliant identity providers, allowing for seamless and secure connections using a single set of credentials, simplifying username and password management.

When you login to Appspace, your credentials are authenticated by the identity provider, and a SAML assertion is sent to Appspace via the web browser to allow the login access to Appspace. Please ensure you have configured a trusted Identity Provider before you enable SSO with Appspace.

Prerequisite

 
  • An Identity Provider that is SAML 2.0 compliant
  • IdP Metadata XML file or the SSO URL
  • An x.509 Certificate
  • Account Owner privileges
 
 

Enable Single Sign-On (SSO)

  1. Log in to the Account Management Portalhttps://account.appspace.com ) with your Account Owner credentials.
  2. Click the Settings tab, and the Account Authentication tab in the side panel.
  3. In the AUTHENTICATION METHOD section, select Single Sign-On (SSO) as the authentication method, to view additional SSO configurations.
  4. In the SINGLE SIGN-ON (SSO) SETTINGS section, select the desired Login Method:
    • SSO onlyUsers must log in with Single Sign-On credentials.
    • SSO or Appspace CredentialsUsers can login with their Single Sign-On credentials and their Appspace credentials.
  5. In the IDENTITY PROVIDER (IDP) INFORMATION section, drop or upload the IdP metadata XML file, or manually enter the SSO URL and X.509 Certificate details in the relevant fields.
  6. In the GENERATING SERVICE PROVIDER (SP) METADATA section, select the desired Data binding (IdP to SP) option:
    • Redirect Users are redirected to the Identity Provider. SSO details will be passed in a query string with “?SAMLRequest=……” as part of the URL.
    • Post SSO details are passed using the POST method. Ensure the Identity Provider has direct access to the Appspace Server for this method to work.
  7. Optionally, you may enable the following features:
  8. Once all SSO configurations have been made, click Save.
 

Setting Up Pass-Through Authentication

Important

Please contact Appspace Support to enable pass-through authentication on cloud.

Pass-through Authentication allows you to provide users in your organization that exist in an external Identity provider (IdP), with access to published channels through Appspace App on smartphones or tablets without consuming Premium User IDs. This is accomplished by providing you unlimited Basic User IDs which are automatically applied to users authenticated via SSO or LDAP that has been configured for Appspace.

  1. In the PASS-THROUGH AUTHENTICATION section, enter in the E-mail Domain of your organization.
  2. Once done, click Save.
 

Setting Up Just-In-Time Provisioning (JIT)

Just-In-Time Provisioning allows you to enable the automatic creation of users on the Appspace account if they do not exist.
 
  1. In the JUST-IN-TIME PROVISIONING (JIT) section, slide the Enable JIT? slider to ON.
  2. Enter in the User group in which the new users will be assigned to.
    Note
    By default, the SAML attributes are mapped to firstname and lastname of the IdP configuration.
  3. Optionally, click the Show advanced configuration link, if you would like to map the SAML attributes to a value that matches your IdP implementation
  4. Enter in the JIT condition Attribute Name and Attribute Value Regex.

    Note

    The SAML identification attribute flag, Attribute=”appspace-role” and Value=”^platform-user$”

    This value is a regular expression. If the attribute value matches this regular expression then the user is provisioned via JIT.
    Regular expressions allow very flexible matching for the wide array of IdP configurations.

    This allows you to only provision platform users for some employees, while allowing for pass-through access. By default, this looks for an attribute called “appspace-role” with a value of “platform-user$”, however this is designed to be flexible and has a regex match. You could also make it match all users by setting it to something like attribute = ‘mail’ value = ‘.*’ (regex wildcard that will match any email value)

  5. Enter in the SAML attributes mapping for the First name and Last name.
 

Disable Single Sign-On (SSO)

  1. Log in to the Account Management Portalhttps://account.appspace.com ) with your Account Owner credentials.
  2. Click the Settings tab, and the Account Authentication tab in the side panel.
  3. In the AUTHENTICATION METHOD section, select Default (cloud.appspace.com) as the authentication method.
Related Articles
Browse By Category