Distributing apps to a single Qlik Cloud tenant
This topic demonstrates how to connect Qlik Sense Enterprise on Windows with a Qlik Cloud tenant and configure a distribution policy to distribute apps to the cloud.
In this example, we cover basic distribution, where all apps published to a stream are automatically distributed to a single cloud tenant. For a more advanced distribution scenario using custom properties, see Distributing apps to multiple Qlik Cloud tenants using custom properties.
Prerequisites
- 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.
- A Qlik Cloud tenant with support for managed spaces (not Trials, Standard, or Business editions).
Before you start
Obtain the URL for your Qlik Cloud tenant:
-
Look for the URL in the welcome email sent by Qlik when your tenant was set up.
-
Alternatively, log in to your tenant and select About from your user profile menu. Here you will find the tenant hostname. The URL format is https://<tenant-hostname>. Example: https://your-tenant.eu.qlikcloud.com
Set up a deployment
Perform the following steps to set up a multi-cloud deployment:
-
Create a deployment in Qlik Sense Enterprise on Windows.
-
Create an identity provider configuration in Qlik Cloud.
-
Test the connection between Qlik Sense Enterprise on Windows and Qlik Cloud
The deployment will be called Region1.
Create a deployment
Do the following:
-
In the Qlik Management Console (QMC), open Cloud distribution and select Deployment setup.
-
Click Set up new.
-
For Deployment name, enter Region1. The name will be used in the distribution policy.
-
For API endpoint, enter the tenant URL.
-
For Audience, enter qlik.api.
-
Select Use local bearer token.
- Click Apply.
-
Copy and save the local bearer token. You need this token for the identity provider configuration in Qlik Cloud.
Before testing the connection, create the identity provider configuration in the next step.
Create an identity provider configuration
Do the following:
-
Log in to your first Qlik Cloud tenant and open the Management Console .
-
Go to Identity provider and click Create new.
-
For Type, select Multi-cloud.
-
Optionally, enter a description.
-
Paste the local bearer token from the deployment setup into the Local bearer token field.
-
Click Create.
Test the connection
Do the following:
-
Return to your deployment in the QMC and click Test connection.
Once the secure connection to Qlik Cloud is established, you can create a distribution policy to distribute apps to your cloud deployment.
Create a 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, open the Cloud distribution section and select Distribution policies.
-
Click Create new.
-
In the Create rule from template list, select Distribution_App.
-
Enter a name for the policy. For example, Distribute to cloud deployments.
-
Under Basic, verify that the resource filter value is App_* and that the action Distribute is selected.
-
In the rule editor:
-
Keep the values subject, name, =, and value.
-
In the last field, add the name of the deployment you created: Region1.
-
The Conditions box in the Advanced section should contain the following string: ((subject.name="Region1")).
-
-
Click Validate rule. The rule syntax is checked and a confirmation is displayed.
-
Click Apply to save the settings.
Create a distribution task
Create a distribution task to trigger the distribution of apps. For detailed instructions, see Creating and editing distribution tasks.
Check the distribution status
You can view a list of distributed apps, along with their status and the date of the last distribution, on the App distribution status page. For details on the available fields, see App distribution status.
Ensure that your apps have been successfully distributed to the Region1 deployment.
Manage user access to the apps in Qlik Cloud
Distributed apps can be found in the Management Console in Qlik Cloud. Initially, these apps will have a status of Staged, meaning they haven't been assigned to a space yet.
A tenant or analytics administrator must move the apps to the appropriate managed space for user access. App access is then governed by the users' roles within the space. For more information, see Managing permissions in managed spaces.
Do the following:
-
Log in to your first Qlik Cloud tenant and open the Management Console.
-
Go to Content > Apps.
-
Set the status filter to Staged.
-
On the app you want to move, click and select Set space.
-
Select a space from the list and click Confirm.
The app is moved to the space.