> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pwnbook.app/llms.txt
> Use this file to discover all available pages before exploring further.

# KnowBe4

> View phishing simulation results and security awareness training completion rates from KnowBe4 in Pwnbook.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/pwnbook/logos/knowbe4.svg" alt="KnowBe4" style={{ height: "32px", marginBottom: "16px" }} />

## Overview

KnowBe4 is a security awareness training platform with phishing simulation capabilities. The Pwnbook integration imports phishing campaign click rates and training completion data so security teams can track human risk factors alongside technical vulnerability findings.

## Prerequisites

* A KnowBe4 account (Platinum or Diamond tier for API access)
* Admin access in KnowBe4 to generate API keys
* Admin or Owner access in Pwnbook

## Credentials required

| Field       | Description                                                        |
| ----------- | ------------------------------------------------------------------ |
| **API Key** | API key from KnowBe4 Account Settings → Account Integrations → API |

<Note>API access is available on KnowBe4 Platinum and Diamond subscription tiers. If you don't see the API section, contact KnowBe4 to confirm your plan includes API access.</Note>

## Setup

<Steps>
  <Step title="Get your KnowBe4 API key">
    1. In KnowBe4, go to **Account Settings → Account Integrations → API**.
    2. Click **Generate API Key** (or copy your existing key if one is already generated).
    3. Copy the key — it begins with a long alphanumeric string.

    <Warning>The API key is shown once. If you lose it, you'll need to regenerate, which invalidates the old key.</Warning>
  </Step>

  <Step title="Configure in Pwnbook">
    1. Go to **Organization Settings → Marketplace → KnowBe4**.
    2. Paste your **API Key**.
    3. Click **Save & Test** — Pwnbook verifies access by fetching your account details.
  </Step>
</Steps>

## What gets synced

### Phishing simulations

| Data                | Description                                               |
| ------------------- | --------------------------------------------------------- |
| **Campaign name**   | The phishing simulation campaign                          |
| **Click rate**      | Percentage of users who clicked the phishing link         |
| **Open rate**       | Percentage who opened the email                           |
| **Reported rate**   | Percentage who reported the email as phishing             |
| **Data entry rate** | Percentage who submitted credentials on the phishing page |
| **Campaign dates**  | Start and end date of each simulation                     |

### Training

| Data                 | Description                                                   |
| -------------------- | ------------------------------------------------------------- |
| **Enrollment count** | Number of users enrolled in each training module              |
| **Completion rate**  | Percentage of enrolled users who completed training           |
| **Overdue count**    | Users who haven't completed assigned training by the due date |
| **Module name**      | The specific training content                                 |

## Workbench card

The KnowBe4 workbench card shows:

* Current phishing-prone percentage (rolling 12-month)
* Latest campaign click rate with trend indicator
* Training completion rate

## Viewing in Pwnbook

The full KnowBe4 view shows:

* **Phishing** tab: campaign history with click/report rates and trend over time
* **Training** tab: module completion rates and overdue user counts

## Disconnecting

1. Go to **Organization Settings → Marketplace → KnowBe4**.
2. Click **Disconnect**.
3. Confirm.