KnowBe4 API Integration

Overview

This document provides instructions on how to connect to an API to import data from this application into your instance of Zilla.

In this guide, you will:

Launch your application from inside Zilla
Set up an API configuration
Send your data securely to Zilla

Step-by-Step Instructions

KnowBe4 APIs only provide users and groups data, they do not provide permissions. Zilla recommends using our ZUS integration to sync user permissions as documented here.

Steps to get required configs

Base URL depends on where your KnowBe4 account is located (more details).
- Accounts on the US server (located at training.knowbe4.com) must use us.api.knowbe4.com.
- Accounts on the EU server (located at eu.knowbe4.com) must use eu.api.knowbe4.com.
- Accounts on the CA server (located at ca.knowbe4.com) must use ca.api.knowbe4.com.
- Accounts on the UK server (located at uk.knowbe4.com) must use uk.api.knowbe4.com.
- Accounts on the DE server (located at de.knowbe4.com) must use de.api.knowbe4.com.

To generate a new API key navigate to your KnowBe4 Account Settings > Account Integrations > API section. Enable Reporting API Access and click Save Changes.
Click on Reporting API and it will redirect you to the API key creation page.
Click + Create New API Token to create an API key, copy the token for use in a future step for syncing data to Zilla.

Setup KnowBe4 Application Integration on Zilla

Visit the Zilla application and login using your admin credentials and then click Add Application in the top right.
A window with a search bar appears, type in KnowBe4 in the search bar and hit enter. KnowBe4 app entry will appear at the top of the list, click Add to Applications button to the right.
Fill in the form with appropriate details and then click Add to Applications.
You will have the KnowBe4 app added into applications tab section, click on it.
A detailed view of KnowBe4 application appears. Click Sync now in top right corner.
Enable API Integration and fill in the Base URL and API Key config details collected from the earlier steps. Click Next.
Click Next and the sync will begin.
Click on Done, then Close.

When you have finished with all the steps above, review the information in Zilla that was synced.

Having trouble? Try our Troubleshooting articles or contact support@zillasecurity.com.