## Set up Qlik Sense Cloud

URL: https://docs.atlan.com/apps/connectors/business-intelligence/qlik-sense-cloud/how-tos/set-up-qlik-sense-cloud

> :::warning Who can do this? You will need your Qlik Sense Cloud tenant administrator to complete these steps - you may not have access yourself.

:::warning Who can do this?
 You will need your Qlik Sense Cloud tenant administrator to complete these steps - you may not have access yourself.

:::

## Invite a new user

To [invite a new user](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-invite-users.htm) for Atlan to use when integrating with Qlik Sense Cloud:

1. Log in to your Qlik Sense Cloud instance.
2. From the upper right corner of your Qlik Sense Cloud instance, click the **menu icon** and then click **Management Console**.
3. In the left menu under _Governance_ in the _Management Console_, click the **Users** tab.
4. From the top right of the _Users_ page, click **Invite** to invite a new user.
5. In the _Invite users_ dialog, for _Email addresses_, enter the email address of the new user that you want to invite and click **Invite**. 

You can also set up roles and groups for robust access management.

## Set permissions

:::info **Did you know?** 
 Atlan does **not** make any API requests or queries that will update the objects in your Qlik Sense Cloud instance.

:::

Once you've invited a new user, ensure that the new user has the following minimum permissions for [crawling Qlik Sense Cloud](https://docs.atlan.com/llms/connectors/qlik-sense-cloud/crawl-qlik-sense-cloud/llms.txt):

- [Assign _developer_ role](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-roles.htm#anchor-5) to the new user to allow the creation of API keys.
- Ensure that the new user has `List`, `Read`, and `Open` permissions to spaces, apps, data, sheets, charts, and connections in Qlik Sense Cloud.

In order to ensure that the new user has the above permissions to Qlik Sense Cloud objects, the new user can either be the creator of the objects, have access to the [shared or managed spaces](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/Spaces.htm) where the objects are located, or the [objects need to be made public](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Share/make-public-or-private.htm). 

:::warning
The API credential must have access to **all** spaces in Qlik Sense Cloud. If it can't access a space, assets from that space are silently marked as Archived after a crawl—no error is raised.
:::

## Enable API key creation

Once you have created a new user and ensured the necessary permissions, you will need to enable API key creation for that user.

To enable API key creation for the new user:

1. From the upper left corner of your Qlik Sense Cloud instance, click the menu icon and then click **Management Console**.
2. In the left menu under _Management Console_, click the **Settings** tab.
3. From _Settings_, scroll down to _API keys_ and enter the following details:
 1. For _Enable API keys_, toggle the slider on to enable the creation of API keys.
 2. For _Change maximum token expiration_, enter a value for allowed maximum token age.
 3. For _Change maximum of active API keys per user_, enter a value for the maximum number of active API keys that a user may have in the tenant.
4. Refresh the _Management Console_ page and navigate to the left menu to view a new tab for _API keys_.

## Generate API key

Once API key creation has been enabled, the new user can [generate API credentials](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm#anchor-3) for crawling Qlik Sense Cloud.

To generate an API key for [crawling Qlik Sense Cloud](https://docs.atlan.com/llms/connectors/qlik-sense-cloud/crawl-qlik-sense-cloud/llms.txt):

1. Log in to your Qlik Sense Cloud instance as the new user. (If you just completed the steps above, you'll need to log out from the tenant admin account first.)
2. From the top right of your Qlik Sense Cloud instance, click your **profile avatar** and then click **Profile settings**.
3. From the left menu under _Management_, click **API keys**.
4. From the upper right of the _API keys_ page, click **Generate new key**. 
5. In the _Generate a new API key_ dialog, enter an API key description and select an expiration time within the allowed maximum token age. 
6. Click **Generate** to generate an API key.
7. From the resulting dialog, copy the generated API key value and save it in a temporary location.

:::warning

The API key is only displayed once. You need to copy and save the value since there is no way to see that specific key again. You will have to generate a new key if you do not copy it.

:::

---