Connect Qevlar to Proofpoint Targeted Attack Protection (TAP) to investigate email threats using TAP verdicts, forensics, and threat intelligence. This page lists the credentials Qevlar requires and how to create them.
Overview
Qevlar authenticates to Proofpoint TAP with service credentials (a Service Principal and Secret) sent as HTTP Basic authentication — no user sign-in per request. The connector is read-only.
| API | Purpose | Auth |
|---|---|---|
| Proofpoint TAP API (v2) | Read SIEM events, forensics, and threat summaries | HTTP Basic (service principal) |
The API base is https://tap-api-v2.proofpoint.com/v2/.
Connection details
Enter these values when configuring the connector in Qevlar:
| Field | Where to find it | Required |
|---|---|---|
| Service Principal | TAP dashboard → Settings → Connected Applications | Yes |
| Secret | Shown once when the service credentials are created | Yes |
Required permissions
Create service credentials in the TAP dashboard. The resulting Service Principal grants access to the TAP threat APIs (SIEM events, forensics, and threat/campaign summaries). There are no granular scopes to configure, and no write access is involved.
Setup
- Open Connected Applications. In the Proofpoint TAP dashboard, go to Settings → Connected Applications.
- Create service credentials. Generate a new Service Principal and Secret.
- Record the credentials. Copy the Service Principal and Secret — the secret is shown only once.
- Configure the connector. In Qevlar, add the Proofpoint TAP connector and enter the connection details above.
Verify the connection
After saving, Qevlar runs a health check that reads recent SIEM events. If it fails, check, in order:
- The Service Principal and Secret are correct and the secret has not been regenerated.
- The service credentials are active in the TAP dashboard.
API reference
| Operation | HTTP | Endpoint |
|---|---|---|
| Read SIEM events (health check) | GET | tap-api-v2.proofpoint.com/v2/siem/all |
| Read forensics | GET | tap-api-v2.proofpoint.com/v2/forensics |
| Read threat summary | GET | tap-api-v2.proofpoint.com/v2/threat/summary/{threatId} |
Authentication: HTTP Basic with the Service Principal as username and the Secret as password.