Distributing apps to Qlik Cloud
When you publish apps to streams in Client-Managed Qlik Sense, you may also want to distribute the apps to your Qlik Cloud deployment. By making configurations in Client-Managed Qlik Sense and in your cloud tenant, you can automate the distribution to cloud so that apps are automatically distributed to your Qlik Cloud deployment when you publish them to a stream.
Distributed apps in Qlik Cloud
When an app in Client-Managed Qlik Sense is distributed, a copy of the app is made available in a managed space in the Qlik Cloud tenant.
In Qlik Cloud, the app functions similarly to an app that has been published to a managed space, with the following exception:
-
Data model viewer is not visible to anyone who opens the app. This includes users with Owner and Can manage roles in the managed space.
After the app is distributed to Qlik Cloud, the app is now Staged and ready to be made available to users. Tenant and analytics administrators make the app available by setting a space for the app in the Administration activity center. For more information, see Setting the space for staged apps.
Prerequisites
To distribute an app from Client-Managed Qlik Sense to Qlik Cloud, 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 Deployments 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 Copy to clipboard.
You need the local bearer token in the identity provider configuration.
- Click Apply.
Creating the identity provider configuration
Do the following:
-
Open the Administration activity center in your Qlik Cloud 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 us 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 Cloud tenant. By using custom properties you can make more granular rules for app distribution, see Distribution policies - example.