Platform integration instructions

1. Using the Dropdown within the Onyxia Integration wizard, select the region where your KnowBe4 deployment is located

2. Log into your KnowBe4 account dashboard and navigate to account settings

   1. In order to access your KnowBe4 account dashboard you will need to be a platform admin

1. Under “Account Integrations” select API

1. Under “Product API” select “API Token”

1. Press “Create New API Token”

1. In the “Create New API Token wizard:
   1. Name the API key “Onyxia API Key”
   2. In products select “PhishER”
   3. Set the expiration date to two years into the future
   4. Select a user that the token will be associated with
   5. Press “Create Token”

1. Copy the generated API Token from KnowBe4 and paste it into the Onyxia integration wizard

Following these steps will successfully integrate your KnowBe4 PhishER platform with Onyxia.

Permissions

In order to access the KnowBe4 management dashboard a user must have admin access. As an admin, you can follow the steps below in order to grant admin access to a user in your organization.

The API token used for this integration is a Read-only reporting API. This gives Onyxia read-only permission to the KnowBe4 platform. At the time this integration was created there was no way to limit what data this API key can access.

1. Navigate to the Users tab in your KnowBe4 dashboard