To configure Security Assertion Markup Language (SAML)-based single sign-on (SSO), you must establish a trust relationship between Elastic Desktop Service and your identity provider (IdP). This is done by configuring SAML on both Elastic Desktop Service as the service provider (SP) and your IdP. Once configured, users can use SSO to log on to EDS terminals. This topic describes how to configure SSO based on SAML 2.0.
Background
Single sign-on (SSO) is a secure communication technology that allows you to efficiently access multiple trusted application systems with a single sign-on. SSO implements logon based on identity federation.
For more information, see Configure logon methods.
Configure SSO in an office network
Configure Elastic Desktop Service as an SP
Obtain the SAML service provider (SP) metadata file from the Elastic Desktop Service console.
Log on to the EDS enterprise console.
In the left-side navigation pane, choose Networks & Storage > Office Network.
In the top navigation bar, select a region.
On the Office Network page, find the target office network for which SSO is enabled, and click its office network ID.
On the office network details page, click the Other Information tab, and then click Download Application Metadata File next to Application Metadata.
In your IdP, create a SAML service provider configuration and use the metadata file to configure Elastic Desktop Service as a trusted SAML SP.
Configure your IdP in Elastic Desktop Service
On the office network details page, click the Other Information tab, and turn on the SSO switch.
After you enable SSO, your IdP's logon page replaces the standard username and password logon page on EDS terminals.
Next to IdP Metadata, click Upload to upload your IdP's metadata file.
NoteThe metadata file is typically an XML file. It contains the IdP's logon service URL and the X.509 public key certificate used to verify the IdP's SAML assertion signatures.
Create corresponding users
In Elastic Desktop Service, create users that correspond to your IdP users. For more information, see Create a convenience account or Create and manage enterprise AD accounts.
When you create a user, you can set a password. This password does not need to match the corresponding IdP user's password.
Configure SSO in an organization
Configure your IdP in Elastic Desktop Service
In the left-side navigation pane, choose Users > Enterprise Identity Source.
On the Enterprise Identity Source page, do one of the following:
If you have not added an enterprise identity source, click the SAML card.
If an enterprise identity source already exists, click Add Enterprise Identity Source. Then, in the Add Enterprise Identity Source panel, click the SAML card.
In the Add Enterprise Identity Source panel, configure the following parameters and click OK.
Parameter
Description
Name
A name to identify your IdP.
Type
Select SAML.
IdP Metadata
Click Upload to upload your IdP's metadata file.
Account Type
The supported account types are convenience account and enterprise AD account. If you select enterprise AD account, you must also select an AD domain.
Configure Elastic Desktop Service as an SP
Obtain the SAML SP metadata file from the Elastic Desktop Service console.
In the left-side navigation pane, choose Users > Enterprise Identity Source.
On the Enterprise Identity Source page, find the target enterprise identity source and click Edit in the Actions column.
In the Edit Enterprise Identity Source panel, click Download File below Application Metadata.
In your IdP, create a SAML SP configuration and use the metadata file to configure Elastic Desktop Service as a trusted SAML SP.
Create corresponding users
In Elastic Desktop Service, create users that correspond to your IdP users. For more information, see Create a convenience account or Create and manage enterprise AD accounts.
When you create a user, you can set a password. This password does not need to match the corresponding IdP user's password.
Related topics
For examples of implementing SSO between Elastic Desktop Service and specific IdPs, see the following topics: