Skip to main content Skip to complementary content

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:

  1. In the Qlik Management Console (QMC), open Cloud distribution and select Deployment setup.

  2. Click Set up new.

  3. For Deployment name, enter Region1. The name will be used in the distribution policy.

    Deployment configuration pane.

    The deployment configuration pane with input fields.
  4. For API endpoint, enter the tenant URL.

  5. For Audience, enter qlik.api.

  6. Select Use local bearer token.

  7. Click Apply.
  8. 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:

  1. Log in to your first Qlik Cloud tenant and open the Management Console .

  2. Go to Identity provider and click Create new.

  3. For Type, select Multi-cloud.

    IdP configuration pane in Qlik Cloud.

    The IdP configuration pane with input fields.
  4. Optionally, enter a description.

  5. Paste the local bearer token from the deployment setup into the Local bearer token field.

  6. 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:

  1. In the QMC, open the Cloud distribution section and select Distribution policies.

  2. Click Create new.

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

    Distribution policy configuration pane.

    Configuration pane for distribution policies showing input fields.
  4. Enter a name for the policy. For example, Distribute to cloud deployments.

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

  6. 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")).

  7. Click Validate rule. The rule syntax is checked and a confirmation is displayed.

  8. 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.

Status of app distribution.

The App distribution status page showing status of apps distributed to Region1.

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:

  1. Log in to your first Qlik Cloud tenant and open the Management Console.

  2. Go to Content > Apps.

  3. Set the status filter to Staged.

    Apps table in Qlik Cloud.

    The Apps page in Qlik Cloud with filter for Staged apps. Option to Set space for app showing.
  4. On the app you want to move, click More and select Set space.

  5. Select a space from the list and click Confirm.

    The app is moved to the space.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!