> For the complete documentation index, see [llms.txt](https://docs.clusterdesign.io/newhub-cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clusterdesign.io/newhub-cloud/newhub-cloud/workspaces/integrations/qlik-cloud/how-to-integrate.md).

# How to integrate

:warning: **Important! NewHub uses OAuth M2M Impersonation.**

If you sign up to NewHub with <john.doe@company.com> and you **do not have** an user <john.doe@company.com> within your Qlik Cloud tenant, <mark style="color:yellow;">**you'll not see any apps or spaces.**</mark>

To integrate Qlik Cloud into your NewHub workspace, you must use OAuth.

1. Navigate to the OAuth section of your Qlik Cloud administration area.

<figure><img src="https://1265645095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdLuVeVnq2f2nZwAgn3A0%2Fuploads%2FtHoki8kFHJMnb2AUbCkr%2Fimage.png?alt=media&amp;token=8ef7c979-ab6d-445f-a8b7-c8d69e5b1101" alt=""><figcaption><p>OAuth section location inside a Qlik Cloud tenant</p></figcaption></figure>

2. Create the OAuth configuration for NewHub Cloud
   1. Choose <mark style="color:yellow;">**Web**</mark>
   2. Add a name for your OAuth configuration (ex: **NewHub Cloud**)
   3. Check the following scopes: <mark style="color:yellow;">**user\_default, admin\_classic,  identity.subject:read**</mark>
   4. On the '**Add allowed origins**' field, add <mark style="color:yellow;">**<https://app.newhub.com>**</mark>
   5. Mark the <mark style="color:yellow;">**Allow Machine-To-Machine (M2M)**</mark> checkbox;
   6. Mark the <mark style="color:yellow;">**Allow M2M user impersonation**</mark> checkbox
   7. Click on **Create**
   8. A popup will appear with your <mark style="color:yellow;">**Client ID**</mark> and <mark style="color:yellow;">**Client Secret**</mark>. You must copy these since you will need it later.
   9. You must change the <mark style="color:yellow;">**Consent Method**</mark> for the OAuth configuration to <mark style="color:yellow;">**trusted**</mark>.

The whole process can be seen in the GIF below.

<figure><img src="https://1265645095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdLuVeVnq2f2nZwAgn3A0%2Fuploads%2FmKkZvJan49ma9ttlxtMY%2F1_oauth_complete.gif?alt=media&amp;token=f7beb54a-62a3-4d2e-8ba6-93fb07364c84" alt=""><figcaption><p>OAuth configuration creation for NewHub Cloud integration </p></figcaption></figure>

3. Now that you have your Client ID and Secret, head to <https://app.newhub.com> to finish your configuration
   1. Add your <mark style="color:yellow;">Qlik Cloud hostname</mark>
   2. Add your <mark style="color:yellow;">Client ID</mark>
   3. Add your <mark style="color:yellow;">Client Secret</mark>

      *Ps. If you lost your Client Secret, you can generate a new one within your OAuth configuration, on Qlik Cloud.*
   4. Click <mark style="color:yellow;">Connect and save</mark>
   5. You should see a success message if all steps were correctly followed.
   6. Click on the back arrow at the top left corner of the page to <mark style="color:yellow;">go back to the Home Page</mark>.
   7. You should see all Qlik Cloud spaces and apps available to your user.

The whole process can be seen in the GIF below.

<figure><img src="https://1265645095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdLuVeVnq2f2nZwAgn3A0%2Fuploads%2FicKOqqtsm9IdrS2JoRAX%2F1_oauth_newhub_config.gif?alt=media&amp;token=2577383e-d576-4f5c-8bd2-6778d5e29fdf" alt=""><figcaption></figcaption></figure>