How do I setup my KnowBe4 Integration?

This help article outlines the steps required to connect Adoptech to KnowBe4

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.