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

# KnowBe4

> Connect KnowBe4 KMSAT to Iru Compliance with a read-only API token sent as a Bearer token to collect security awareness training and phishing test evidence.

### About KnowBe4

Iru collects **training campaigns**, **phishing simulations**, **enrollments**, and **completion** status via the KnowBe4 API using **`Authorization: Bearer`**. **API access** requires **Platinum** or **Diamond**; tokens **must** include an **expiration** date at creation.

### How It Works

```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

| Detail             | Value               |
| ------------------ | ------------------- |
| **Category**       | Security awareness  |
| **Authentication** | Bearer token        |
| **Plans**          | Platinum or Diamond |

Official references: [Product API overview](https://support.knowbe4.com/hc/en-us/articles/10495383627155-Product-API-Overview), [Developer portal](https://developer.knowbe4.com/).

### Prerequisites

* **Admin** role in KMSAT.
* **API** section visible under **Account Settings** (tier-dependent).

### Connect KnowBe4 to Iru

<Tabs>
  <Tab title="KnowBe4">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to KnowBe4 KMSAT">
        Open your KnowBe4 **KMSAT** admin experience and sign in with a user who can manage **Account Settings** and **API** tokens.
      </Step>

      <Step title="Open Account Settings">
        From the main navigation, open **Account Settings** (or **Settings** → **Account**, depending on your KnowBe4 layout).
      </Step>

      <Step title="Open the API section">
        Select **API**. Confirm your subscription tier exposes API access; if the section is missing, contact KnowBe4 support or upgrade per your contract.
      </Step>

      <Step title="Create a new API token">
        Select **Create New API Token** (or equivalent). Enter a name such as **Iru Compliance** so auditors can map the credential to this integration.
      </Step>

      <Step title="Choose Read Only and expiration">
        Set access to **Read Only** (or the least-privilege read mode KnowBe4 offers for this integration). Set an **expiration**; KnowBe4 requires one for many token types.
      </Step>

      <Step title="Create and copy the token">
        Select **Create**, then **copy** the token value once. KnowBe4 shows it only at creation.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**KnowBe4**](#knowbe4) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on KnowBe4">
        Find **KnowBe4** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Paste the API token">
        Paste the **raw token** - the wizard formats **`Bearer`** for you.
      </Step>

      <Step title="Finish the connection">
        Click **Submit API Key**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **KnowBe4** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Token expired - rotate before deadline.
  </Accordion>

  <Accordion title="No API UI">
    Confirm **Platinum/Diamond** subscription.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>