Distributing apps from Qlik Sense Enterprise on Windows to Qlik Sense Enterprise SaaS

When you publish apps to streams in Qlik Sense Enterprise on Windows, you may also want to distribute the apps to your Qlik Sense Enterprise SaaS deployment. By making configurations in Qlik Sense Enterprise on Windows and in your cloud tenant, you can automate the distribution to cloud so that apps are automatically distributed to your Qlik Sense Enterprise SaaS deployment when you publish them to a stream.

Prerequisites

To distribute an app from Qlik Sense Enterprise on Windows to Qlik Sense Enterprise SaaS you need the following:

• Qlik Sense Enterprise on Windows.
• Multi-Cloud Setup Console (available by adding /api/msc to your existing Qlik Sense Enterprise on Windows server name: https://<server name>/api/msc).
• Qlik Sense Enterprise SaaS tenant.
• A license that includes multi-cloud. Either of the following:

  • The same signed license key for Qlik Sense Enterprise on Windows and Qlik Sense Enterprise SaaS.

  • Different license keys, where the cloud attributes are enabled and on-prem is activated through a signed license.

Configurations

The following is a high-level description of the configuration steps.

1. Set up a deployment in the Multi-Cloud Setup Console.

2. Create a multi-cloud identity provider configuration in the tenant.

3. Create the distribution policy in the Qlik Management Console (QMC) of your Qlik Sense Enterprise on Windows server.

Setting up a deployment in the Multi-Cloud Setup Console

Do the following:

1. Open the Multi-Cloud Setup Console by adding /api/msc to your existing Qlik Sense Enterprise on Windows server name: https://<server name>/api/msc.

2. Click the Deployments tile.

3. Click Set up new in the bottom-left corner.

4. Enter a deployment name.

   You will use this name in the distribution policy.

5. Enter the API endpoint, that is, your tenant address.

   Example: https://my-tenant.eu.qlikcloud.com.

6. For Audience, enter qlik.api.

7. Select Use local bearer token.

   Information noteUsing a local bearer token simplifies setup. If you do not use it, you need to enter Client ID, Client secret, and Token endpoint instead.

8. Click Copy to clipboard.

   You need the local bearer token in the identity provider configuration.

9. Click Apply.

Creating the identity provider configuration

Do the following:

1. Open the Management Console in your Qlik Sense Enterprise SaaS tenant and select Identity provider in the menu to the left.

2. Click Create new.

   The Create identity provider configuration window is opened.

3. Under Type, select Multi-cloud.

4. Optionally, enter a description.

5. In the Local bearer token box, paste the token you copied in the deployment setup.

Creating the distribution policy

Do the following:

1. In the QMC of Qlik Sense Enterprise on Windows, open the Cloud distribution section and select Distribution policies.

2. Click Create new.

3. In the Create rule from template list, select Distribution_App.

4. Name the distribution policy.

5. Under Basic, verify that the resource filter value is App_* and the action Distribute is selected.

6. In the rule editor keep the values subject, name, =, and value. In the last field, you only need to add the name of the deployment you created earlier (in Setting up a deployment in the Multi-Cloud Setup Console). Let us assume it is deployment.

   The Conditions box in the Advanced section should then have the following string: ((subject.name="deployment")).

7. Click Validate rule.

   The rule syntax is checked, and, if valid, a confirmation is displayed.

8. Click Apply to save the rule.

This is a simple example of app distribution where all apps that are published to a stream also are distributed to your Qlik Sense Enterprise SaaS tenant. By using custom properties you can make more granular rules for app distribution, see Distribution policies - using custom properties.