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 Client-Managed Qlik Sense to qlik you need the following:
- Qlik Cloud tenant.
- A license that includes multi-cloud. Either of the following
- The same signed license key for Qlik Sense Enterprise on Windows and Qlik Cloud.
Different signed license keys, where the Qlik Sense Enterprise on Windows license has the cloud attributes enabled.
Configurations
The following is a high-level description of the configuration steps.
-
Set up a deployment in the Qlik Management Console (QMC) of your Qlik Sense Enterprise on Windows server.
-
Create a multi-cloud identity provider configuration in the tenant.
-
Create the distribution policy in the QMC.
Setting up a deployment
Do the following:
-
From the QMC start page, open Cloud distribution.
-
Click Deployment setup.
-
Click Set up new in the bottom-left corner.
-
Enter a deployment name.
You will use this name in the distribution policy.
-
Enter the API endpoint, that is, your tenant address.
Example: https://my-tenant.eu.qlikcloud.com.
-
For Audience, enter qlik.api.
-
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. -
Click Apply.
-
Click Copy to clipboard.
You need the local bearer token in the identity provider configuration.
Tip noteBefore you can test the connection you need to create the identity provider configuration in the next step.
Creating the identity provider configuration
Do the following:
-
Open the Management Console in your Qlik Sense Enterprise SaaS tenant and select Identity provider in the menu to the left.
-
Click Create new.
The Create identity provider configuration window is opened.
-
Under Type, select Multi-cloud.
-
Optionally, enter a description.
-
In the Local bearer token box, paste the token you copied in the deployment setup.
Creating the distribution policy
Distribution policies are used to determine whether a published app can be distributed to one or more of the deployments in Qlik Cloud. Only published apps can be distributed.
Do the following:
-
In the QMC of Qlik Sense Enterprise on Windows, open Cloud distribution and select Distribution policies.
-
Click Create new.
-
In the Create rule from template list, select Distribution_App.
-
Name the distribution policy.
-
Under Basic, verify that the resource filter value is App_* and the action Distribute is selected.
-
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). Let's assume it is deployment.
The Conditions box in the Advanced section should then have the following string: ((subject.name="deployment")).
-
Click Validate rule.
The rule syntax is checked, and, if valid, a confirmation is displayed.
-
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.