How-To Guides
      Back to home
      1. Knowledge Base
      2. Users & Logins
      3. How-To Guides

      Removing KnackHQ.com from your app's SSO Configuration, and replacing it with Knack.com

      How to update your Google Workspace or Microsoft Entra ID (Azure AD) SSO settings to remove knackhq.com, add knack.com, and optionally configure support for Next-Gen Apps (apps.knack.com).

      For Google Workspace:

               1. Access the Google Cloud Console:
      1. 2. Go to the Credentials Page:
        • From the left-hand menu, select "APIs & Services" > "Credentials"
        3. Select Your OAuth 2.0 Client ID:
        • Locate the OAuth 2.0 Client ID associated with your Knack application and click on its name to edit

      4. Update Authorized JavaScript Origins:

      Under the "Authorized JavaScript origins" section:

      • Remove any entries that reference knackhq.com.​
        • https://{accountSlug}.knackhq.com
      • Replace those entries with knack.com
        • https://{accountSlug}.knack.com

      *Optional*: Add the below URL to prepare for Knack's Next Gen Apps:​

      • https://apps.knack.com

      5. Update Authorized redirect URIs:

      Under the "Authorized redirect URIs" section:

      • Remove any entries that reference knackhq.com.​
        • https://{accountSlug}.knackhq.com/{appSlug}
      • Replace those entries with knack.com
        • https://{accountSlug}.knack.com/{appSlug}

      *Optional*: Add the below URL to prepare for Knack's Next Gen Apps:​

      • https://apps.knack.com/{accountSlug}/{appSlug}
      6. Save Changes:
        • Click the "Save" button to apply your updates.​

      Note: These URLs must be identical to the URL that is in the browser that initiates the login. It is also important that both Redirect and Origin URLs use the same domain/sub-domain.


      For Microsoft Entra ID (formerly Azure Active Directory):

      1. Access the Microsoft Entra Admin Center:
        Navigate to the Microsoft Entra admin center
      2. Navigate to App Registrations:
        • In the left-hand menu, select "App registrations"
      3. Select Your Knack Application:
        • Find and select the application associated with Knack.​
      4. Update Redirect URIs:
        • Under the "Manage" section, click on "Authentication"
        • In the "Redirect URIs" section, perform the following:​
          • Add New URI:
            • Click "Add a platform" and choose "Web".
            • Enter: https://apps.knack.com/{accountSlug}
            • Replace {accountSlug} with your specific account identifier.
          • Remove Old URI:
            • Delete any existing redirect URIs that reference knackhq.com.
      5. Save Changes:
        • Click the "Save" button to apply your updates.​

      Note: These URLs must be identical to the URL that is in the browser that initiates the login. It is also important that both Redirect and Origin URLs use the same domain/sub-domain.


      *For Customers Using Next-Gen Apps

      If you have requested early access to Next-Gen apps or already have access, or plan on using Next-Gen apps, please ensure that you add apps.knack.com to your SSO configuration.

      Not sure if you're using a Next-Gen App?

      • Go to a table in the builder and check the URL.
      • If the URL includes "builder-next", you are using a next-gen app and should update your configuration accordingly.

      Testing Your SSO Configuration:

      After updating your SSO settings, it is crucial to verify that everything functions correctly:​

      • Perform a Test Login:
        • Attempt to log in to your Knack application using SSO configuration is functioning correctly.