Proofpoint integration setup

This document outlines the requirements and setup for the Proofpoint integration.

This integration supports multiple instances

Check out the instructions to set up multiple instances here.

Set up steps in Proofpoint

ProofPoint API tokens can only be generated by users assigned to a role with both Integrations and Security Events permissions.

1. Log in to your Proofpoint portal.

2. Navigate to Account Management > Integrations > Security Integrations > Proofpoint API.

3. Generate an API Password.

4. Copy the password and store it somewhere secure. You'll need this information for further set up steps in Rewst.

Set up steps in Rewst

1. Navigate to Configuration > Integrations in the left side menu of your Rewst platform.

2. Search for Proofpoint in the integrations page.

3. Click on the integration tile to launch the configuration setup page.

4. Enter the following information into the relevant fields under Parameters:

   1. Domain: Your primary domain in ProofPoint

   2. Username: ProofPoint API Username - this must be a channel admin user in ProofPoint

   3. Proofpoint API Password: The generated API password

   4. Tenant Hostname: the regional tenant hostname

5. Click Save.

Rewst will do a quick validation of your input.

Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.

Actions and endpoints

Proofpoint's own API documentation can be found here.

Category	Action	Description
Authentication	Get MFA Settings	Gets the MFA settings for your organization.
Authentication	Update MFA Settings	Updates the MFA settings for your organization
Authentication	Get Login Settings	Gets the login settings for your organization.
Authentication	Update Login Settings	Updates the login settings for your organization
Authentication	List Identity Providers	Lists the identity providers
Authentication	Create Identity Provider	Creates an identity provider
Authentication	Get Identity Provider	Gets an identity provider
Authentication	Update Identity Provider	Updates an identity provider
Authentication	Delete Identity Provider	Deletes an identity provider
Authentication	Get Service Credentials	Gets the TAP SIEM service credentials
Authentication	Create Service Credential	Creates a TAP SIEM service credential
Authentication	Delete Service Credential	Deletes a TAP SIEM service credential
Billing	Get Organization Billing Data	Gets the billing data for an organization.
Billing	Get Billing Data	Gets the billing data for an organization's sub-organizations.
Dkim	List DKIM Signings	Lists all DKIM keypairs for a domain
Dkim	Create DKIM Keypair	Creates a DKIM keypair for a domain
Dkim	Delete All DKIM Keypairs	Deletes all DKIM keypairs for a domain
Dkim	Get DKIM Signing	Get DKIM Signing for a domain
Dkim	Delete DKIM Keypair	Deletes a DKIM keypair for a domain
Dkim	Verify DKIM Key Pair	Description coming soon...
Domain Verification	Get Domain Verification Code	Gets the verification code for a domain
Domain Verification	Verify Domain	Verifies a domain using a verification code
Domains	Get Domain	Gets a domain
Domains	List Domains	Lists all domains in an organization
Domains	Create Domain	Creates a domain in an organization
Domains	Update Domain	Updates a domain in an organization
Domains	Delete Domain	Deletes a domain from an organization
Email Tagging	Get Email Tagging Settings	Gets the email tagging settings for your organization.
Email Tagging	Update Email Tagging Settings	Updates the email tagging settings for your organization
Email Tagging	Update Email Tagging Setting	Updates a single email tagging setting for your organization
Endpoints	Get Domain Endpoints	Gets the endpoints for a domain
Features	List Organization Features	Lists all features in an organization
Features	Update Organization's Features	Updates the features for an organization
Generic Request	ProofPoint API Request	Generic action for making authenticated requests against the ProofPoint API
Licensing	Get Licensing Data	Gets the licensing data for your organization
Licensing	Update Organization Licensing	Updates the licensing data for your organization
Orgs	Get Organization	Gets an organization by domain
Orgs	Delete Organization	Deletes an organization by domain
Orgs	Update Organization	Updates an organization by domain
Orgs	List Organizations	Lists all sub-organizations for a given domain
Orgs	Create Organization	Creates an organization by domain
Package	Update Organization Package	Updates an organization package by domain
Products	List Organization Products	Lists the products for your organization
Products	Create Purchase	Creates a purchase for your organization
Products	Get Product	Gets a product for your organization by label
Products	Delete Product Subscription	Deletes a product subscription for your organization
Products	Update Product	Updates a product for your organization
Sender Lists	Get Sender Lists	Description coming soon...
Sender Lists	Create Sender List	Description coming soon...
Sender Lists	Delete Sender Lists	Description coming soon...
Sender Lists	Update Sender Lists	Updates sender lists for your organization
Sender Lists	Get User Sender Lists	Gets the sender lists for a user
Sender Lists	Create User Sender List	Creates a new sender list for a user
Sender Lists	Delete User Sender List	Deletes a sender list for a user
Sender Lists	Update User Sender List	Updates sender lists for a user
Sender Lists	List Group Sender Lists	Lists the sender lists for a group
Sender Lists	Create Group Sender List	Creates a new sender list for a group
Sender Lists	Delete Group Sender List	Deletes a sender list for a group
Sender Lists	Update Group Sender Lists	Updates sender lists for a group
Settings	Get Azure AD Organization Settings	Gets the Azure AD settings for your organization.
Settings	Update Azure AD Organization Settings	Updates the Azure AD settings for your organization
Settings	Delete Azure AD Organization Settings	Deletes the Azure AD settings for your organization
Stats	Get Partner Statistics	Returns Partner Statistics for the lasts 1, 7, 30, or 90 days (Times in UTC)
Stats	Get Partner Organization Statistics	This endpoint returns stats for an Organization & its children
Token	Create ODIN Access Token	Creates an ODIN access token for a given domain
Users	Get User	Gets a user from your organization
Users	Update User	Updates a user from your organization
Users	Delete User	Deletes a user from your organization
Users	List Organization Users	Lists all users in your organization
Users	Create User	Creates a user in your organization