Changing corporate identity providers
This topic explains how to switch from an existing corporate identity provider (IdP) to a new one by deactivating the current IdP configuration and activating a new one.
Important considerations
-
Supported identity providers: Ensure your IdP supports either OpenID Connect (OIDC) or SAML protocols.
-
Recovery address: Always use the recovery address when changing IdPs to prevent the risk of locking yourself out during the change. For more information, see Recovering access to your tenant.
-
Multiple tenants: If you have multiple tenants under the same license, make sure they all use the same IdP to avoid the risk of duplicate license assignments.
-
Deactivation or deletion of corporate IdP: Deactivating or deleting your corporate IdP configuration will revert your tenant back to Qlik Account. For more information, see Identity providers in Qlik Cloud.
Removing Section Access table before configuring the corporate IdP
Before switching to your corporate IdP, remove or comment out the Section Access table in all apps, and perform a reload. After activating the IdP, recreate the Section Access table using the new identities provided by the IdP. Perform another reload to reactivate the table in the data model.
For information, see Managing data security with Section Access.
Managing content during IdP transition
Changing corporate IdPs can disrupt user access and the content they own. To minimize this, ensure that users' email addresses remain consistent across the transition, as this will help retain their associated content. Pay close attention to mapping content for existing users to their new corporate identities.
Configuring a new corporate IdP
Do the following:
-
Configure the interactive IdP in the Administration activity center, see Identity providers in Qlik Cloud.
-
Test the verification flow and ensure the result is successful. As a tenant admin, manually verify that the email and email_verified claims are present and with a value of true. This is important for successfully mapping content after the switch. Do not activate the IdP yet.
-
Examine the Users list for the tenant via the Administration activity center.
-
Identify users whose current email address does not match the corporate email address. When you switch IdPs to preserve content, the email addresses should match.
-
For users who do not have a matching email address, the tenant admin needs to manually move content to the new account.
-
Again, check the user list via the Administration activity center and verify that the correct corporate email addresses are now assigned to all users.
-
Activate the interactive IdP.
-
Open a new browser instance or an incognito window, to avoid conflict with existing login sessions. Access the tenant URL (<tenant>.<region>.qlikcloud.com/login) and verify that it takes you to the new interactive IdP.
-
Verify that previous corporate IdP content remains available to the user.
-
Open the Administration activity center and verify that the user has the new IdP subject assigned to their existing User ID.
-
Verify that the license assignments in the Administration activity center are still set correctly for all the users who have logged into the new corporate IdP.
-
Recreate the Section Access tables, see Changing corporate identity providers.