Community
Questions Library
Docs
Blog
Events
Swag
Github
Slack
JupiterOne
Discussions
Release Notes
Contact Us
KnownBe4 - AskJ1 Community
<main> <article class="userContent"> <h2 data-id="knowbe4-jupiterone-integration-benefits">KnowBe4 + JupiterOne Integration Benefits</h2> <ul><li><p>Visualize KnowBe4 user groups, users, training campaigns, and modules in the<br> JupiterOne graph.</p></li> <li><p>Map KnowBe4 users and their associated trainings to the JupiterOne employee.</p></li> <li>Monitor changes to user groups, users, training campaigns, and modules using<br> JupiterOne alerts.</li> </ul><h2 data-id="how-it-works">How it Works</h2> <ul><li><p>JupiterOne periodically fetches KnowBe4 groups, users, and trainings to update<br> the graph.</p></li> <li><p>Write JupiterOne queries to review and monitor updates to the graph.</p></li> <li>Configure alerts to take action when the JupiterOne graph changes.</li> </ul><h2 data-id="requirements">Requirements</h2> <ul><li><p>JupiterOne requires the site for where your account is located and an API<br> key/token.</p></li> <li><p>You must have permission in JupiterOne to install new integrations.</p></li> </ul><h2 data-id="support">Support</h2> <p>If you need help with this integration, please contact<br><a rel="nofollow" href="https://support.jupiterone.io">JupiterOne Support</a>.</p> <h2 data-id="integration-walkthrough">Integration Walkthrough</h2> <h3 data-id="in-knowbe4">In KnowBe4</h3> <p>You can generate a new key in your<br><a rel="nofollow" href="https://training.knowbe4.com/account/info#api-settings">KnowBe4 Account Settings</a><br> under the API section. Be sure to request a key for the <strong>Reporting API</strong> not<br> the <strong>User Event API</strong>. After checking the <code class="code codeInline" spellcheck="false" tabindex="0">Enabled Reporting API Access</code><br> checkbox, you must press the <code class="code codeInline" spellcheck="false" tabindex="0">Save Changes</code> button at the bottom. Refresh the<br> page to ensure that the changes were saved. Once confirmed, copy the API Token.<br> It'll be used in the next section.</p> <p>KnowBe4 APIs are available to Platinum and Diamond customers only. See the<br><a rel="nofollow" href="https://developer.knowbe4.com/reporting/">KnowBe4 API Reference Guide</a> for more<br> info.</p> <h3 data-id="in-jupiterone">In JupiterOne</h3> <ol><li>From the top navigation of the J1 Search homepage, select <strong>Integrations</strong></li> <li>Scroll to the <strong>KnowBe4</strong> integration tile and click it.</li> <li>Click the <strong>Add Configuration</strong> button and configure the following settings:</li> </ol><ul><li><p>Enter the <strong>Account Name</strong> by which you'd like to identify this KnowBe4<br> account in JupiterOne. Ingested entities will have this value stored in<br><code class="code codeInline" spellcheck="false" tabindex="0">tag.AccountName</code> when <strong>Tag with Account Name</strong> is checked.</p></li> <li><p>Enter a <strong>Description</strong> that will further assist your team when identifying<br> the integration instance.</p></li> <li><p>Select a <strong>Polling Interval</strong> that you feel is sufficient for your monitoring<br> needs. You may leave this as <code class="code codeInline" spellcheck="false" tabindex="0">DISABLED</code> and manually execute the integration.</p></li> <li><p>Enter the <strong>Site</strong> of your KnowBe4 account, either US or EU.</p></li> <li>Enter the <strong>API Key</strong> configured in your KnowBe4 account.</li> </ul><ol start="4"><li>Click <strong>Create Configuration</strong> once all values are provided.</li> </ol><h2 data-id="how-to-uninstall">How to Uninstall</h2> <ol><li>From the top navigation of the J1 Search homepage, select <strong>Integrations</strong></li> <li>Scroll to the <strong>KnowBe4</strong> integration tile and click it.</li> <li>Identify and click the <strong>integration to delete</strong>.</li> <li>Click the <strong>trash can</strong> icon.</li> <li>Click the <strong>Remove</strong> button to delete the integration.</li> </ol><p><br></p> <h2 data-id="data-model">Data Model</h2> <h3 data-id="entities">Entities</h3> <p>The following entities are created:</p> <table><thead><tr><th>Resources</th> <th>Entity <code class="code codeInline" spellcheck="false" tabindex="0">_type</code></th> <th>Entity <code class="code codeInline" spellcheck="false" tabindex="0">_class</code></th> </tr></thead><tbody><tr><td>KnowBe4 Account</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_account</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Account</code></td> </tr><tr><td>KnowBe4 Group</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user_group</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">UserGroup</code></td> </tr><tr><td>KnowBe4 Phishing Campaign</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_campaign</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Training</code></td> </tr><tr><td>KnowBe4 Phishing Security Test</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Assessment</code></td> </tr><tr><td>KnowBe4 Phishing Security Test Results</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test_result</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Record</code></td> </tr><tr><td>KnowBe4 Training Campaign</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">training_campaign</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Training</code></td> </tr><tr><td>KnowBe4 Training Module</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">training_module</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">Training</code>, <code class="code codeInline" spellcheck="false" tabindex="0">Module</code></td> </tr><tr><td>KnowBe4 User</td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">User</code></td> </tr></tbody></table><h3 data-id="relationships">Relationships</h3> <p>The following relationships are created:</p> <table><thead><tr><th>Source Entity <code class="code codeInline" spellcheck="false" tabindex="0">_type</code></th> <th>Relationship <code class="code codeInline" spellcheck="false" tabindex="0">_class</code></th> <th>Target Entity <code class="code codeInline" spellcheck="false" tabindex="0">_type</code></th> </tr></thead><tbody><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_account</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_campaign</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_account</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">training_campaign</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_account</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_account</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user_group</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_campaign</code></td> <td><strong>CONTAINS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user_group</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test_result</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test</code></td> <td><strong>CONTAINS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_phishing_security_test_result</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">training_campaign</code></td> <td><strong>ASSIGNED</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user_group</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">training_campaign</code></td> <td><strong>HAS</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">training_module</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">training_module</code></td> <td><strong>ASSIGNED</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> </tr><tr><td><code class="code codeInline" spellcheck="false" tabindex="0">knowbe4_user</code></td> <td><strong>COMPLETED</strong></td> <td><code class="code codeInline" spellcheck="false" tabindex="0">training_module</code></td> </tr></tbody></table><p><br></p> </article> </main>
.png)