How do I setup my KnowBe4 Integration?

The KnowBe4 integration enables Adoptech to import training enrolment and completion data from KnowBe4's security awareness platform.

This integration helps organisations:

• Track security awareness training completion across the organisation

• Demonstrate that employees are receiving required security training

• Provide automated audit evidence for training programmes

• Support ISO 27001, SOC 2 and Cyber Essentials compliance activities

---

Prerequisites

Before configuring the integration, ensure you have:

1. An active KnowBe4 account

2. A KnowBe4 API key

3. Your KnowBe4 domain URL (e.g. training.knowbe4.com or eu.knowbe4.com)

---

What Data We Collect

Once connected, Adoptech retrieves read-only information from KnowBe4, including:

• Training enrolment records including course or campaign name

• Completion status and completion date for each enrolment

• Enrolment state and expiry information

• Training campaign details including name, start date, end date and active status

• User email address associated with each enrolment

---

What We Use the Data For

The imported data is used to:

• Verify that employees have completed required security awareness training

• Generate automated compliance evidence for security training controls

• Track training completion rates across the organisation

---

What do I need to get started?

You will need to have permissions within KnowBe4 to amend the settings.  

You will also need Security Manager or Admin role with Adoptech to set up the integration

How do I configure KnowBe4?

1. Go to Account Settings

2. Under Account Integrations,
   1. select API
   2. under Product API enable KSAT GraphQL API Access
      
   3. click on Product API
   4. select Create New API Token 
      
      1. Name: enter a descriptive name for this API token.
      2. Products: select KSAT
      3. Scopes: select Read Only 
      4. Expiration Date: Select the date when the API token should expire. When this token expires, KSAT will not be able to send data to the product. To continue sending data to the product, you’ll need to create a new API token.
      5. User: In this drop-down menu, select the user responsible for managing this API token. For example, you could select a user who has administrator access to the product.
      6. Status: select Enable 
         
         
         
   5. Click Create Token.
   6. The Product API Token pop-up window will open.
      1. Click the Product API token to copy the token. Save your copied API token somewhere that you can easily access. After you close this window, you will not be able to view this token again.
      2. Click OK.

How do I configure Adoptech?

Once you have generated the API token in KnowBe4 you can create the integration in Adoptech.

1. Select Apps and Integrations page from the LHS menu
    
2. Find the KnowBe4 tile and click On Connect
   
3. Enter the API key generated above into the API Key field and your domain into the Domain field, then click on the orange Connect button
   
   1. 1. Note that your domain is determined by where your Knowbe4 account is set up.
         1. For clients that have subscribed to Knowbe4 through Adoptech, this will always be: eu.knowbe4.com
         2. For other clients, below are the various Knowbe4 domains:
            1. Accounts on the US server, located at training.knowbe4.com, must use the base URL of training.knowbe4.com/graphql.
            2. Accounts on the EU server, located at eu.knowbe4.com, must use the base URL of eu.knowbe4.com/graphql.
            3. Accounts on the CA server, located at ca.knowbe4.com, must use the base URL of ca.knowbe4.com/graphql.
            4. Accounts on the UK server, located at uk.knowbe4.com, must use the base URL of uk.knowbe4.com/graphql.
            5. Accounts on the DE server, located at de.knowbe4.com, must use the base URL of de.knowbe4.com/graphql.

Your organisation's KnowBe4 training should now sync with Adoptech and be visible on the users' profiles on the People page.