Configure single sign-on using SAML

Single sign-on with SAML can be used with applications running in a browser.

SAML is a standard for exchanging authentication data between security domains. SAML is an XML-based protocol that uses security tokens containing assertions to pass information about a user between an identity provider and a service provider and enables web-based authentication scenarios including single sign-on across all ARIS Connect runnables.

Please contact your LDAP administrator before you change any configuration.

Prerequisite

Server

Client

Web browser supports JavaScript.

The following steps must be taken to use SSO:

Procedure

  1. The single sign-Oo configuration options must be set in the ARIS Administration.
  2. ARIS must be registered as a trusted service provider at the SAML identity provider.

You configured SSO.

Configuration options in ARIS Administration

You need to configure SSO for the servers.

Prerequisite

Procedure

  1. Log in to the ARIS Administration.
  2. Click the arrow next to your name.
  3. Click Administration.
  4. Click Configuration.
  5. Switch to User management.
  6. Click the arrow next to SAML.
  7. Click General.
  8. Click Edit Edit.
  9. Enable Use SAML.
  10. Enter the ID of the identity provider in the Identity provider ID field.
  11. Enter the ID of the service provider in the Service provider ID field.
  12. Enter the end point of the identity provider that is used for single sign-on in the Single sign-on URL field.
  13. Enter the end point of the identity provider that is used for single log-out in in the Single logout URL field.

You have configures SSO using SAML in ARIS Administration. If you use multiple LDAP systems, the user names must be unambiguous through all LDAP systems. Otherwise no SSO is possible.

Please note that SSO (single sign-on) using SAML will not work in case of multiple LDAP servers and same login names (even with different entities) in different LDAP systems.

Register ARIS as a trusted service provider

Establish a circle of trust between the identity provider and the service provider.

Procedure

  1. Open a browser.
  2. Enter the following URL into the address bar:

    https://<SERVERNAME>/umc/rest/saml/metadata.xml?tenant=<TENANTID>

  3. iptables -t nat -A PREROUTING -i <network interface> -p tcp --dport <port n
  4. Upload the file into your SAML identity provider.

Your system is configured to be used with single sign-on and SAML.

Troubleshooting

Detailed information on SAML authentication issues can be found in the log files of ARIS Administration located in

<Your installation folder>\ARIS10.0\server\bin\work\work_umcadmin_<size>\base\logs

Example

C:\SoftwareAG\ARIS10.0\server\bin\work\work_umcadmin_m\base\logs