Integrating with KnowBe4 PhishER

Overview

You can use HTTP Ingest to integrate Blumira with KnowBe4 PhishER and bypass the need for an on-premises Ubuntu sensor or traditional API-polling Cloud Connector. This method uses Blumira’s Cloud Ingest API, which provides a unique HTTPS endpoint where your organization can transfer structured logs.

Most Blumira editions have no limit to the number of HTTP integrations you can add. However, the following restrictions apply:

• Detect Lite, Respond Core, and SIEM Core editions have a limit of one ingestion source
• M365 Edition accounts do not include access to any HTTP logging

Before you begin

Before configuring any log source for outbound HTTP log streaming, you must generate your unique ingestion credentials by doing the following:

1. In the Blumira app, navigate to Ingestion > HTTP Ingestion.
2. Click Add Ingestion Instance.
3. In the window that appears, do the following:
   1. In Vendor, select the vendor you would like to integrate with.
   2. (Optional) In Ingestion Instance Name, edit the pre-populated name.
   3. (Optional) In Description, type a description that provides context for this instance being created.
   4. Click Save.
4. In the Credentials window, do at least one of the following:
   • Copy and save each credential to use later when configuring your vendor integration.

   • Keep the Credentials window open to copy and paste the values directly from Blumira into the vendor's site in a different browser tab. 

     Important: You must copy the token before you close the window. You will not be able to see the token again after you close the Credentials window.

Configuring KnowBe4 PhishER

To integrate with KnowBe4 PhishER and start receiving logs, do the following:

1. In PhishER, navigate to Settings > Integrations > Webhook.
2. Click New Webhook.
   
3. Under Name, type a name to identify your webhook by.
4. In the URL box, paste the URL value you copied from the Credentials for KnowBe4 PhishER window in Blumira.
5. In the Authorization dropdown, select Bearer Token.
6. In the Token box, paste the Token value you copied from the Credentials for KnowBe4 PhishER window in Blumira.
7. Under Available Data, select the check boxes next to each data type you want to transfer.
   
8. Click Create.

For information about managing this HTTP integration and its tokens, see Using Blumira HTTP Ingestion.