Skip to content

KnowBe4 Security Awareness Training (KSAT) is a security awareness training platform designed to train and test employees through simulated social engineering attacks such as phishing. This guide walks you through the steps to gather the necessary information and configure your KSAT account for the purpose of creating a security awareness integration.

Prerequisites

Before you begin, ensure that you have:

  • Access to the KnowBe4 console.
  • Access to a KnowBe4 user account with administrator permissions for the account you are integrating.
  • Knowledge of the region hosting your KnowBe4 instance.

Required API Token Permissions

Due to restrictions on the KnowBe4 KSAT Graph API, a KnowBe4 Diamond or SAT Advanced subscription type is required to create a security awareness integration.

ProductScopesPurpose
KSATRead OnlyRead data about phishing campaigns, phishing simulation tests, and users

Generating API Credentials

  1. Log in to the KnowBe4 console with a user account that has administrator permissions for the account you are integrating.
  2. Click on your email address on the top right of the page, then click Account Settings.
  3. Select Account Integrations > API from the sidebar on the left.
  4. In the section titled Product API, ensure that the slider titled KSAT Graph API Access is enabled. Click on the slider if it is not enabled.
  5. Click the link titled Product API.
  6. In the tab titled Product API, click + Create New API Token.
  7. Fill in the field titled Name.
  8. In the field titled Products, select the required products and scopes listed under Required API Token Permissions.
  9. In the field titled Expiration Date, select an expiration date for this token.
  10. In the dropdown titled User, select the user responsible for managing this API token.
  11. Click Create Token, take note of the value displayed, and store it in a safe location.
  12. Click OK.
  13. You have now created a new KnowBe4 Product API Token. Proceed to the next section, Configuring the Integration.

For more information on creating and managing KnowBe4 Product API Tokens, see the KnowBe4 Product API Overview knowledge base article.

Configuring the Integration

To configure a new KnowBe4 Security Awareness Training (KSAT) Security Awareness integration, provide each of the values as defined below:

Integration ParameterDescription
SecretThis is the Product API Token value generated in the steps above.
RegionThe region hosting your KnowBe4 instance. This value can be determined by the URL you use to log in. For help determining the proper region to select, see the KnowBe4 Learner Support Troubleshooting knowledge base article.