Authentication against SAP Signavio

In this page, we will show you how to set up the authentication for SAP Signavio out of LeanIX step-by-step. This is necessary to define which SAP Signavio instance you want to synchronize with.

In the Credentials tab, fill in all mandatory credentials:

1. Configuration Name

Feel free to give your configuration a meaningful name. This is especially useful if you have multiple configurations, e.g., for multi-tenancy.

2. SAP Signavio URL

Fill in the SAP Signavio URL. For the SAP Signavio SaaS offering, the URL depends on the instance you're using:

  • https://editor.signavio.com (Europe)
  • https://app-us.signavio.com (US)
  • https://app-au.signavio.com (Australia)
  • https://app-jp.signavio.com (Japan)
  • https://app-ca.signavio.com (Canada)
  • https://app-sgp.signavio.com (Singapore)
  • https://app-kr.signavio.com (South Korea)

3. Username & Password

Next, enter the username and password of the user you want to use to authenticate with SAP Signavio. Make sure that the user has the required permissions, e.g., to read processes or to create dictionary items.

To integrate with the API of SAP Signavio, we advise assigning an 'API Edition' license to a designated technical user. This dedicated license enables the user to bypass the Single Sign-On (SSO) login process, facilitating seamless API operations. Please note, that users set up with this license will not be able to access the application via the User Interface (UI).

If an 'API Edition' license isn't readily available in your workspace, initiate a support incident with SAP Signavio to request one. Take note that the 'API Edition ' license will be provided at no additional cost.

📘

Recommendation to use 'API Edition' license

Utilizing the credentials of a user associated with any license other than 'API Edition' consumes a paid license, which will incur additional cost.

4. Tenant ID

If the username and password you configured have permission to access multiple Signavio workspaces, make sure to specify the Tenant ID of the workspace you want to integrate with. If not, you may leave this field empty.

📘

Information

If you leave the field empty, the integration will try to retrieve the Tenant ID from Signavio using the provided credentials. If this is successful, it will fill the form field for you.

Alternatively, the Tenant ID can be found under "Workspace information" in SAP Signavio. The Tenant ID only needs to be added in case several workspaces are used. If there is only one, the Tenant ID should be transferred automatically.

5. Login Parameters

In case your Signavio instance requires additional parameters when logging in, feel free to define them in this form field as a comma-separated list, e.g., key1=value1,key2=value2

6. Managing User

By default, changes to your workspace will be done by the service account of the integration. In this case, the changes in the audit log will show the username integration-signavio. If you want to define more fine-grained permissions or have different usernames for different Signavio integration configurations, you may also choose any of your Technical Users from the list.

7. Use Proxy Server

🚧

This option is deprecated

If you want to enable an IP address filtering on your Signavio Instance or need to open a firewall to your on-premise instance, please ask your Customer Success Manager to provide you with our respective IP range for outbound traffic of the region of your LeanIX workspace is hosted in.

If you tick the checkbox Use Proxy Server, all traffic (inbound and outbound) of the integration will be routed through a central proxy server in Europe, having the IP address 23.97.217.0. This can slow down the performance of the integration significantly, especially if you are hosted in a different region.

8. Activate the integration

Check the box "Active" to activate SAP Signavio for your workspace and save the settings. The integration will now validate your credentials and also try to authenticate. If everything works fine, you should end up on the "Basic" tab to configure what you want to map between LeanIX and SAP Signavio.