KnowBe4 PhishER
Introduction
This guide tells you how to authenticate the KnowBe4 PhishER connector in Swimlane using HTTP Bearer Token authentication.
You will generate a PhishER API token, collect the required connection details, and configure the connector in Swimlane.
Prerequisites
KnowBe4 Access Requirements
You must have permissions to:
- Access the KnowBe4 PhishER platform
- Generate or manage API tokens
- Access PhishER settings and integrations
- Use the PhishER GraphQL API
Required Credentials
During setup, you will collect:
- Product API Token
- Host URL
Host URL
Environment | Host URL |
|---|---|
KnowBe4 PhishER |
KnowBe4 PhishER Setup
Take the following steps to generate an API Token:
- Log in to the KnowBe4 PhishER portal.
- Navigate to Settings.
- Open the API or Integrations section.
- Locate the API Tokens area.
- Click Generate API Token or Create Token.
- Enter a descriptive name for the token.
- Assign the required permissions for API access.
- Click Create.
- Copy and securely save the generated API token.
The generated value will be used as the Product API Token in Swimlane.
Connector configuration in Swimlane
- Log in to Turbine.
- From the left-hand navigation pane, click ORCHESTRATION and click Assets.
- Asset homepage opens.
- Click the plus icon to open the Configure your Connector Asset window.
- Select KnowBe4 PhishER from the Asset type list.
- Fill in the Asset Settings and Asset Input as shown:
Field | Description | Required/Optional |
|---|---|---|
url | KnowBe4 PhishER API URL | Required |
token | Product API Token generated from KnowBe4 PhishER | Required |
verify_ssl | Enable/Disable SSL Verification | Optional |
http_proxy | Optional proxy configuration | Optional |
Fields with * marks are required.
- Click Create.
Troubleshooting
Authentication Failed
Ensure:
- The API token is copied correctly
- The token has not expired or been revoked
- The correct KnowBe4 PhishER URL is being used
Permission Errors
Ensure the API token has sufficient permissions to:
- Retrieve messages
- Update messages
- Add comments and tags
- Download EML files
Result
You have successfully authenticated the KnowBe4 PhishER Connector in Swimlane.
Sources
- KnowBe4 PhishER API Documentation: https://developer.knowbe4.com/phisher/docs/phisher-api-overviewο»Ώ
- KnowBe4 PhishER Product Documentation: https://support.knowbe4.com/hc/en-us/categories/360003111873-PhishERο»Ώ