KnowBe4
  • 20 Jun 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

KnowBe4

  • Dark
    Light
  • PDF

Article summary

KnowBe4 provides Security Awareness Training for anti-phishing behavior, social engineering and ransomware attacks, and general security awareness.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Users

Parameters

  1. Host Name or IP Address (required) - The hostname or IP address of the KnowBe4 server. Use one of the following values:
    • Accounts on the US server (located at training.knowbe4.com) - Use https://us.api.knowbe4.com
    • Accounts on the EU server (located at eu.knowbe4.com) - Use https://eu.api.knowbe4.com
  2. API Key (required) - The Reporting API key from Knowbe4. Used to pull data from the KnowBe4 console for reporting purposes. For details, see APIs.
  3. Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
  4. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection. Refer to ​Advanced Configuration for Adapters.

  1. Remove fields without value from the latest fetch - By default, all adapters keep the last known value of each field, in case that field was not populated during the last fetch. Select this option to remove fields without value from the latest fetch.
  2. User status include list (optional, default: empty) - Specify a comma-separated list of user statuses.
    • If supplied, all connections for this adapter will only fetch users whose status is in the specified list.
    • If not supplied, all connections for this adapter will fetch all users.
  3. Ignore archived users (required, default: False) - Select this option so that all connections for this adapter do not fetch archived users from KnowBe4.

APIs

Axonius uses the KnowBe4 API.

You are required to enable the Reporting API key in KnowBe4 and then create the API key to work with this adapter.

To enable the Reporting API key in KnowBe4

  1. From the KnowBe4 console, click your email address at the top-right corner of the page and select Account Settings.
  2. Navigate to **Account Integrations> API.
  3. Under Reporting API, select the Enable Reporting API Access checkbox.

To create the API key

  1. Under Reporting API, click Reporting API.
  2. In the Reporting API subtab that opens, click + Create New API Token.
  3. In the Create New API Token dialog, enter the following information:
    • Name - A descriptive name for this API token.
    • Status - Enable or disable the API token.
  4. Click Create Token. The Reporting API Token pop-up window opens.
  5. Copy the Reporting API Token into API Key. Make sure to 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.
  6. Click OK.



Was this article helpful?

What's Next