In this article, you will learn how to integrate Code42’s Incydr product with SecurityCoach. Once the integration is complete, data provided by Code42 will be available for use in the SecurityCoach tab of your KnowBe4 Security Awareness Training (KSAT) console. This data can be viewed in SecurityCoach reports and used to create detection rules for real-time coaching campaigns. For general information about SecurityCoach, see our SecurityCoach Product Manual.

Creating Your Code42 API Client

Before you can set up this integration in your KSAT console, you will need to create an API client in your Code42 console. Code42 API client credentials are needed to complete the Setting Up the Integration in Your KSAT Console section of this article.

To create the API client, follow the steps below:

1. Log in to your Code42 console.
2. Navigate to Administration > Integrations > API Clients.
3. Click Create new API client. When you click this button, the Create new API client pop-up window will open.
4. In the Client name field, enter a name for your new API client.
5. Under API Permissions, enable the Read option for Alert Rules and Alerts and Sessions.
   

   

6. Click Save to create your new API client.
7. Copy and save the Client ID, Secret, and Base URL values somewhere that you can easily access. You will need these credentials again to complete the Setting Up the Integration in Your KSAT Console section below.

Setting Up the Integration in Your KSAT Console

Once you have created your API Client in your Code42 console, you can set up the integration in SecurityCoach by following the steps below:

1. Log in to your KSAT console and navigate to SecurityCoach > Setup > Security Vendor Integrations.
2. Locate the Code42 vendor tile and click Configure.

   

3. Enter the Client ID, Client Secret, and Base URL that you saved in the Creating Your Code42 API Client section of this article.

   

4. Click Authorize.

Mapping Your Users

After you’ve finished integrating Code42, you can map your users either through Mapping Rules (Recommended) or through a CSV File Upload. For more information about user mapping, see our Map Users in SecurityCoach article.

Once you’ve successfully authorized this integration, you can manage detection rules for Code42 on the Detection Rules subtab of SecurityCoach. For a full list of available system detection rules for this vendor, see our System Detection Rules by Vendor article.

Using the Integration

Once you’ve successfully authorized this integration, you can manage detection rules for Code42 on the Detection Rules subtab of SecurityCoach. For a full list of available system detection rules for this vendor, see our System Detection Rules by Can I Use with My Vendors? Aarticle.

Deleting the Integration in SecurityCoach

If you want to delete the Code42 integration from SecurityCoach, follow the steps below:

1. Log in to your KSAT console.
2. Navigate to SecurityCoach > Setup > Security Vendor Integrations.
3. Locate the Code42 vendor tile and click Edit.
4. Click Delete Integration near the bottom of the page.
5. A confirmation pop-up window will open. If you are sure you want to delete the integration, click Confirm.