KnowBe4 - Partner connection

The KnowBe4 connection represents and contains all the information needed to connect
the KnowBe4 account to the Boomi Enterprise Platform. If a user has multiple KnowBe4
accounts, use a separate connection for each and configure the credentials accordingly.
The user can pair a single connection with different KnowBe4 operations to perform
unique actions against a KnowBe4 account.

Authentication setup

Obtaining KnowBe4 API credentials

1. Log in to the KnowBe4 Dashboard.
2. Navigate the to Product API.
3. Enable KSAT Graph API Access.
4. Generate and save the access token securely.

note

Keep the API credentials confidential and store them in a secure location.

Connection tab

The KnowBe4 connection has the following fields that are required for configuration:

URL / Region

The KnowBe4 region where the account is hosted. Select from the dropdown list:

• United States (US)
• European Union (EU)
• Canada (CA)
• United Kingdom (UK)
• Germany (DE)

The region determines which API endpoint the connector uses to communicate with
KnowBe4.

Authentication type

The connector uses API Token authentication to connect to KnowBe4.

API key / API token

This is a mandatory field. Enter the KnowBe4 API Token (access token) that was generated
from the KnowBe4 Dashboard. This token authenticates the connection to the KnowBe4
API.

note

This field cannot be blank.

Test connection

The Test Connection ensures that the specified settings are correct, valid, and accessible.
If the test connection is successful, then the connection can be saved. Otherwise, review
and correct any incorrect settings and test again.

To test the connection:

1. Enter the Region and API Token.
2. Click Test Connection.
3. If successful, a confirmation message is displayed.
4. Click Save and Close to save the connection.

Best practices

• Security: Store API credentials securely and never hardcode them in process
  definitions
• Testing: Always test the connection before deploying to production
• Multiple Accounts: Create separate connections for different KnowBe4 accounts
  or regions
• Region Selection: Ensure to select the correct region matching the KnowBe4
  account
• Regular Validation: Test connections regularly to ensure API access remains valid
• Token Management: Keep track of token expiration and rotate API tokens
  periodically for enhanced security

Troubleshooting connection issues

Common connection issues and solutions

Connection Test Fails:

• Verify the API token is correct and has not expired.
• Check that KSAT Graph API Access is enabled in KnowBe4.
• Ensure the correct region is selected.
• Verify network connectivity between Boomi and KnowBe4 APIs.
• Confirm API credentials are valid and not expired.

Authentication Errors:

• Regenerate the API token in KnowBe4 dashboard.
• Update the connection with the new API token.
• Ensure the token has appropriate permissions.
• Test the connection again.

Network Connectivity Issues:

• Verify connectivity between Boomi and KnowBe4 APIs.
• Check firewall rules and network access.
• Confirm the correct regional endpoint is being used.
• Test connectivity to the specific regional API endpoint.

Regional endpoints

The connector supports the following regional endpoints:

Region	Endpoint
United States (US)	api.knowbe4.com
European Union (EU)	api-eu.knowbe4.com
Canada (CA)	api-ca.knowbe4.com
United Kingdom (UK)	api-uk.knowbe4.com
Germany (DE)	api-de.knowbe4.com

The connector automatically uses the correct endpoint based on the region selected.