Native Integrations
      Back to home
      1. Gradient Support Center
      2. Vendor Integrations
      3. Native Integrations

      KnowBe4 Security Awareness Training (KSAT)

      Overview and Configuration Guide: Integrating KnowBe4 KSAT with Gradient

      Overview

      This integration enables partners to synchronize the latest active user counts from their KnowBe4 customer accounts, ensuring accurate billing based on the actual number of active users rather than the originally ordered seat count.

      How to Connect with KnowBe4 KSAT

      To connect and configure the KnowBe4 integration, please click to navigate to the following:

      1. How to Generate API Keys
      2. Connect to KnowBe4
      3. Map Accounts and Services

      Requirements

      To connect with the KnowBe4 integration in Reconcile, you’ll need:

      • API Key

      • API URL

      When submitting API requests, you will need to use the correct API URL:

      • US server: https://training.knowbe4.com/graphql
      • EU server: https://eu.knowbe4.com/graphql
      • CA server: https://ca.knowbe4.com/graphql
      • UK server: https://uk.knowbe4.com/graphql
      • DE server: https://de.knowbe4.com/graphql

      How to Generate API Keys

      1. Login to your KnowBe4 Management Console with your administrator credentials.
      2. Once logged in in, click on Account Settings in the user settings dropdown.
      3. In Account Settings, click on API Keys: Manage your API Tokens.
      4. Click Create New API Token.
      5. Select the Read Only scope and set the expiration date as far in the future as possible.
      6. Complete any additional required details and click Create Token to generate a new API key.

      Connect KnowBe4

      1. Login to Gradient.
      2. Navigate to the Integrations tab.
      3. Select the KnowBe4 integration and click Connect.
      4. Enter the API Key and API URL retrieved from the previous steps.
      5. Click Authenticate.
      6. Once successfully authenticated, accounts and services will be generated, and the integration will be updated to a pending status. You can click the status refresh button or simply refresh your browser if you are unable to proceed to the next step.

      Map Accounts and Services

      Note: If you need further details on account and service mapping, click here.

      1. Map Accounts and Services

        • When setting up the integration for the first time, accounts are automatically matched if there's an exact match between your vendor and PSA.
        • For accounts not automatically matched:
          • Use the filter button beside the account names on the right, or
          • Use the search bar on the left to find PSA accounts.
        • Drag and drop the PSA accounts from the left to match them with vendor accounts on the right.

      2. Proceed to Service Mapping

        • Once accounts are mapped, click "Next" to access the Service Mapping step.
        • Align services or products from your PSA, displayed on the left, with the corresponding vendor services or SKUs on the right. For ConnectWise PSA users, search by Product ID.
        • Ensure at least one account and one service mapping is completed to finish the configuration.
        • After mapping the services, click "Next".

      3. Finalize Configuration

        • Review your service configurations and click "Finish" to complete the setup.
        • This will initiate a sync. The "Sync Status" indicator at the top-right will start spinning, showing that a sync is in progress.
        • Once the sync is complete, the "Refresh" button will light up pink, indicating the sync is complete. Click that button to see the vendor usage data populated.
        • Use the filter or sort options to jump to the connected services and start reviewing and approving usage!

      Top