KnowBe4

Configure the action connector for KnowBe4.

In this guide, you'll configure the integration between KnowBe4 and Radiant to automatically enroll users in additional training after simulated phishing attacks. Users who clicked on malicious links or downloaded malicious files will be added to a KnowBe4 smart group and enrolled in remedial phishing training.

Available actions

The following action is available after you set up the KnowBe4 action connector. Keep in mind, additional permissions are required.

  • Enroll in phishing training

Prerequisites

This configuration requires the following:

Create a Product API Token in KnowBe4

Create the Product API token to share with Radiant Security. The token will allow the app to authenticate to KnowBe4.

  1. Login to your KMSAT console, click your email address at the top-right corner of the page and select Account Settings

  2. Navigate to Account Integrations > API

  1. Click User Event API

  2. On the Create New API Token page, fill in the Name field with Radiant Security App

  3. Click Create Token

  4. Under Key, click the copy icon to copy the API token you just created

Note: Be sure to save the API token as it will be needed in the next section.

Add the action connector in Radiant Security

Add the new action connector to Radiant Security.

  1. From the navigation menu, select Settings > Action Connectors

  2. Click + Add Connector

  3. Select KnowBe4 from the menu and click Credentials

  4. Under Required Credentials, add the following:

  • User Event API: The Product API Token that you copied from the KMSAT console.

  • Base URL: Select the appropriate base URL depending on where your KnowBe4 account is located. From the drop-down, choose from the following options:

  1. Click Add Connector to save the connector configuration

Create a smart group from custom event criteria

Create a smart group in KnowBe4. When users match the custom event criteria, they will be automatically added to this smart group.

Note: It may take up to 1 hour from an event publish until the user is added to the smart group. This is dependent on KnowBe4’s background processing and is not configurable.

  1. Log in to your KMSAT console and navigate to Users > Groups.

  2. Click the + Create New Group button at the top-right corner of the page.

  3. Enter a group name in the Group Name: Radiant Security Impacted User

  4. Select the Make this a Smart Group checkbox.

  5. Click Create Group. When you click this button, the Smart Group’s overview page will open.

  6. From this page, click the Smart Group Criteria drop-down menu and select the criteria type Custom Event Criteria.

  7. Fill in the criteria using the information below:

    • Condition: Must

    • Event Type: Radiant Security Impacted Users

    • Event Source (optional): <blank>

    • Event External Id (optional): <blank>

    • Description (optional): Radiant Security enrolled user in training

    • Matcher: Greater than

    • Count: 0

    • Time Frame: Any

Create a remedial training campaign

Finally, add the newly created smart group to a new or existing remedial training campaign. Follow the KnowBe4 documentation to complete these steps.

Last updated