Proofpoint’s ZenGuide (formerly Proofpoint Security Awareness Training) enables security teams to automate personalized learning paths based on an individual’s unique risk profile, behaviors and role. It uses people-risk insights across the Proofpoint ecosystem to deliver relevant interventions to reduce risky behaviors. More information can be found at the Proofpoint website.

Integration Method: API

Tables: Training Inventory (99405002)

This integration supports the following events.

This integration supports the following versions.

Prerequisites

• The User should have Administrator privileges to the Proofpoint ZenGuide platform for creating API tokens.

• The User should have access to the DataBee console.

Configuration Overview

1. Generate an API token on the ZenGuide console with the required scopes.

2. Choose the environment-region.

3. Add the Proofpoint Zenguide data feed integration in the DataBee console with the required API token.

   DataBee Parameter	ZenGuide Parameter
   Token	Token

ZenGuide Configuration

Create API Token

1. Login to your ZenGuide platform console with an account that has admin privileges.
   

   Note:

   Please ensure that ZenGuide setup is available and note down your hostname with domain. For example, if your Zenguide platform console URL is https://<hostname.domain>-securityeducation.com then <hostname.domain> will be your URL.

   
   

2. In the left side bar, Navigate to Company Settings.
    

3. Navigate to API Tokens > Create Token.
    

4. In Create Token prompt, confirm the following, and click on Create.

   1. Name: enter the Token name.

   2. Permissions: select the reporting check box.

   3. Expiration: can be “Never expire” (or) any choices.

   
   
   

   

   Note:

   If Expiration is other than “Never expire”, Please ensure to re-generate the token once expired and update existing Proofpoint Zenguide data feed with updated token in DataBee console.

5. Copy the token created by clicking Copy to Clipboard. Once copied, hit OK.

   

   Note:

   Copy and save this token as we won’t be able to retrieve it later.

6. Verify the Token created is visible on the console.
    

Choose Environment-region

Please refer environment-region options mentioned on the official webpage and choose accordingly.

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    

2. Search for the Proofpoint and choose Proofpoint Zenguide as shown below.
    

3. Click on the API Ingest option for collection method.

    

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • Authorization Method: Bearer Token

   • API Base URL: make sure to replace <environment-region>, with actual value. This is the base URL that DataBee will interact with.

   • Token: paste the Token generated earlier in the ZenGuide console.

   • Event types: preselected for all the event types that integration pulls. 

     

6. Click Submit.

Troubleshooting Tips

• Ensure the Token is pasted correctly. Since you cannot view the Token after the 1^st time, re-create the Token, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

• Ensure the <environment-region> is entered correctly.