KnowBe4 + JupiterOne Integration Benefits
Visualize KnowBe4 user groups, users, training campaigns, and modules in the
JupiterOne graph.
Map KnowBe4 users and their associated trainings to the JupiterOne employee.
- Monitor changes to user groups, users, training campaigns, and modules using
JupiterOne alerts.
How it Works
JupiterOne periodically fetches KnowBe4 groups, users, and trainings to update
the graph.
Write JupiterOne queries to review and monitor updates to the graph.
- Configure alerts to take action when the JupiterOne graph changes.
Requirements
Support
If you need help with this integration, please contact
JupiterOne Support.
Integration Walkthrough
In KnowBe4
You can generate a new key in your
KnowBe4 Account Settings
under the API section. Be sure to request a key for the Reporting API not
the User Event API. After checking the Enabled Reporting API Access
checkbox, you must press the Save Changes button at the bottom. Refresh the
page to ensure that the changes were saved. Once confirmed, copy the API Token.
It'll be used in the next section.
KnowBe4 APIs are available to Platinum and Diamond customers only. See the
KnowBe4 API Reference Guide for more
info.
In JupiterOne
- From the top navigation of the J1 Search homepage, select Integrations
- Scroll to the KnowBe4 integration tile and click it.
- Click the Add Configuration button and configure the following settings:
Enter the Account Name by which you'd like to identify this KnowBe4
account in JupiterOne. Ingested entities will have this value stored in
tag.AccountName when Tag with Account Name is checked.
Enter a Description that will further assist your team when identifying
the integration instance.
Select a Polling Interval that you feel is sufficient for your monitoring
needs. You may leave this as DISABLED and manually execute the integration.
Enter the Site of your KnowBe4 account, either US or EU.
- Enter the API Key configured in your KnowBe4 account.
- Click Create Configuration once all values are provided.
How to Uninstall
- From the top navigation of the J1 Search homepage, select Integrations
- Scroll to the KnowBe4 integration tile and click it.
- Identify and click the integration to delete.
- Click the trash can icon.
- Click the Remove button to delete the integration.
Data Model
Entities
The following entities are created:
| Resources |
Entity _type |
Entity _class |
|---|
| KnowBe4 Account |
knowbe4_account |
Account |
| KnowBe4 Group |
knowbe4_user_group |
UserGroup |
| KnowBe4 Phishing Campaign |
knowbe4_phishing_campaign |
Training |
| KnowBe4 Phishing Security Test |
knowbe4_phishing_security_test |
Assessment |
| KnowBe4 Phishing Security Test Results |
knowbe4_phishing_security_test_result |
Record |
| KnowBe4 Training Campaign |
training_campaign |
Training |
| KnowBe4 Training Module |
training_module |
Training, Module |
| KnowBe4 User |
knowbe4_user |
User |
Relationships
The following relationships are created:
Source Entity _type |
Relationship _class |
Target Entity _type |
|---|
knowbe4_account |
HAS |
knowbe4_phishing_campaign |
knowbe4_account |
HAS |
training_campaign |
knowbe4_account |
HAS |
knowbe4_user |
knowbe4_account |
HAS |
knowbe4_user_group |
knowbe4_phishing_campaign |
CONTAINS |
knowbe4_phishing_security_test |
knowbe4_user_group |
HAS |
knowbe4_user |
knowbe4_user |
HAS |
knowbe4_phishing_security_test_result |
knowbe4_phishing_security_test |
CONTAINS |
knowbe4_phishing_security_test_result |
training_campaign |
ASSIGNED |
knowbe4_user_group |
training_campaign |
HAS |
training_module |
training_module |
ASSIGNED |
knowbe4_user |
knowbe4_user |
COMPLETED |
training_module |
.png)