Proofpoint People-Centric Security
Overview
Proofpoint People-Centric Security provides user-level threat analytics that identify which individuals in your organization are most targeted by attacks and most susceptible to clicking on threats. This data enables MSPs to implement targeted security controls, prioritize security awareness training, and apply adaptive authentication policies for the highest-risk users.
The core concept is that people - not infrastructure - are the primary target of modern email attacks. By understanding who is targeted and who clicks, you can focus security resources where they have the most impact.
Anti-triggers
- Simulated-phishing risk scores — KnowBe4 also reports a per-user
"risk score" and a click rate, but those measure tests the MSP sent
deliberately. Attack Index and VAP count real attacks. For simulation
performance use
knowbe4-users.
- Enrolling a high-risk user in awareness training — this skill
identifies who needs it; the enrollment itself is
knowbe4-training.
- The individual threat events behind a user's Attack Index — use
proofpoint-tap, and proofpoint-threat-intel for the campaigns
named in topCampaigns.
Key Concepts
Very Attacked People (VAP)
VAPs are users who receive a disproportionately high volume of sophisticated attacks. VAP status is determined by:
- Attack volume - Total number of threats targeting the user
- Attack sophistication - Complexity and novelty of attacks
- Attack diversity - Variety of threat actors and campaigns targeting the user
VAPs are typically executives, finance personnel, IT administrators, and people with external-facing email addresses.
Attack Index
The Attack Index is a composite score (0-1000+) that quantifies the severity of threats targeting a user. It factors in:
| Component |
Weight |
Description |
| Volume |
Medium |
Number of threats received |
| Sophistication |
High |
How advanced the attacks are |
| Actor reputation |
High |
Whether known threat actors are involved |
| Threat type mix |
Medium |
Diversity of attack types (phish, malware, BEC) |
Higher Attack Index = more severe threats targeting the user.
Click Susceptibility
| Metric |
Description |
Range |
clickRate |
Percentage of threats the user clicked on |
0-100% |
clickCount |
Total number of malicious clicks |
Integer |
uniqueThreatsClicked |
Distinct threats clicked |
Integer |
lastClickTime |
Most recent click on a threat |
Datetime |
User Risk Categories
| Category |
Attack Index |
Click Rate |
Action |
| Very High Risk |
> 500 |
> 10% |
Isolate browsing, MFA everywhere, priority training |
| High Risk |
200-500 |
5-10% |
Enhanced email filtering, additional MFA |
| Medium Risk |
50-200 |
2-5% |
Standard controls, regular training |
| Low Risk |
< 50 |
< 2% |
Baseline controls |
Field Reference
VAP Report Fields
| Field |
Type |
Description |
identity |
object |
User identity details |
identity.emails |
string[] |
User email addresses |
identity.name |
string |
User display name |
identity.department |
string |
User department |
identity.title |
string |
User job title |
identity.vip |
boolean |
Whether the user is flagged as VIP |
attackIndex |
int |
Composite attack severity score |
threatStatistics |
object |
Breakdown of threats by type |
threatStatistics.totalThreats |
int |
Total threats received |
threatStatistics.malwareCount |
int |
Malware threats received |
threatStatistics.phishCount |
int |
Phishing threats received |
threatStatistics.impostorCount |
int |
BEC/impostor threats received |
families |
string[] |
Threat families targeting this user |
topCampaigns |
object[] |
Most significant campaigns targeting this user |
Top Clickers Fields
| Field |
Type |
Description |
identity |
object |
User identity details |
clickStatistics |
object |
Click activity breakdown |
clickStatistics.clickCount |
int |
Total malicious clicks |
clickStatistics.permitCount |
int |
Clicks that were permitted |
clickStatistics.blockCount |
int |
Clicks that were blocked |
clickStatistics.clickRate |
float |
Click-through rate on threats |
clickStatistics.uniqueThreats |
int |
Distinct threats clicked |
clickStatistics.lastClick |
datetime |
Most recent click time |
clickStatistics.classifications |
object |
Breakdown by malware, phish |
User Risk Profile Fields
| Field |
Type |
Description |
email |
string |
User email address |
riskScore |
int |
Overall risk score (0-1000) |
attackIndex |
int |
Attack severity targeting this user |
clickRate |
float |
Historical click-through rate |
riskCategory |
string |
very_high, high, medium, low |
vulnerabilityFactors |
string[] |
Contributing risk factors |
recommendedActions |
string[] |
Suggested remediation steps |
trainingStatus |
object |
Security awareness training completion |
MCP Tools
| Tool |
Description |
Key Parameters |
proofpoint_people_get_vap |
Very Attacked People report — users ranked by attack index |
window, page, size |
proofpoint_people_get_top_clickers |
Users who clicked the most threat URLs |
window, page, size |
proofpoint_people_get_user_risk |
Risk score and attack details for one user |
email (required), window |
Three tools, all read-only. The People domain changes nothing — there
is no write tool on this server at all.
Not available through this plugin
- A separate attack-index ranking. The attack index is the ranking
proofpoint_people_get_vap returns; there is no second tool for it, and
no department filter anywhere. Departmental comparison means pulling
the VAP list and grouping it yourself against your own roster.
- Anything to do with VIP flags. No tool lists VIPs and none sets one.
VAP and VIP are different concepts and the similarity of the acronyms
is the trap: VAP is computed by Proofpoint from attack volume, VIP is an
administrator-assigned protection flag. This plugin can read the first
and cannot see or touch the second. Set VIP flags in the Proofpoint
console.
Common Workflows
Generate VAP Report
- Call
proofpoint_people_get_vap with window=30 and size=20
- Review the top 20 most attacked users
- Cross-reference with organizational role - are they executives, finance, IT?
- For each VAP, check their click rate using
proofpoint_people_get_user_risk
- Prioritize users who are both heavily targeted and have high click rates
- Recommend additional controls for the highest-risk users
Identify Training Candidates
- Call
proofpoint_people_get_top_clickers with window=90 and size=50
- Identify users with the highest click rates
- Check if they have completed recent security awareness training
- Enroll high-clickers in targeted phishing simulation campaigns
- Follow up after training to measure improvement
Executive Risk Assessment
- Bring your own list of executives — the VIP flag is not readable here,
so the roster comes from the customer's HR or directory data, not from
Proofpoint
- For each, call
proofpoint_people_get_user_risk with their email
- Assess attack index and click susceptibility
- Recommend enhanced controls: browser isolation, advanced MFA, dedicated monitoring
- Present risk summary to leadership
Department Risk Comparison
- Call
proofpoint_people_get_vap with a large size to get the ranked
attack-index list — there is no department filter
- Join the returned users against your own department roster
- Compare average attack index across departments
- Identify which departments are most targeted
- Allocate security resources proportionally
New User Baseline
- After a new user is onboarded, wait 30 days
- Call
proofpoint_people_get_user_risk with the user's email
- Establish baseline risk score and attack index
- If the user is immediately targeted (high attack index), investigate why
- Ensure appropriate training has been completed
Error Handling
Common API Errors
| Code |
Message |
Resolution |
| 400 |
Invalid window |
Use 14, 30, or 90 for the window parameter |
| 400 |
Invalid size |
Size must be between 1 and 1000 |
| 401 |
Authentication failed |
Verify service principal and secret |
| 403 |
People API not enabled |
Ensure your license includes People-Centric Security |
| 404 |
User not found |
The email address may not exist in Proofpoint |
| 429 |
Rate limit exceeded |
Implement backoff |
No VAP Data
- New organizations may not have enough data for VAP reports (requires 14+ days)
- Very small organizations may not have enough volume for meaningful rankings
- Check that email flow is routing through Proofpoint correctly
Best Practices
- Review VAP reports monthly - Attack patterns shift; update your high-risk user list regularly
- Combine attack index with click rate - A user who is heavily attacked AND clicks frequently is highest priority
- Flag executives as VIP - Ensure C-suite and board members have the VIP flag for enhanced protection
- Use department data for budgeting - Show leadership which departments need the most security investment
- Track click rates over time - Measure the effectiveness of security awareness training
- Implement adaptive controls - Apply stricter policies (browser isolation, MFA step-up) for high-risk users
- Don't blame users - Use click data to improve training, not to punish users
- Correlate with HR data - Cross-reference VAP data with job function to understand targeting patterns
- Automate VIP management - Sync VIP flags with your HR system for executives and key personnel
- Report to leadership quarterly - Present people risk metrics alongside infrastructure security metrics
Related Skills
1---2name: proofpoint-people3description: Proofpoint People-Centric Security fundamentals: Very Attacked People (VAP) reports, attack index scoring, click susceptibility, top clickers, and user risk categorization for targeting security controls and training.4---56# Proofpoint People-Centric Security78## Overview910Proofpoint People-Centric Security provides user-level threat analytics that identify which individuals in your organization are most targeted by attacks and most susceptible to clicking on threats. This data enables MSPs to implement targeted security controls, prioritize security awareness training, and apply adaptive authentication policies for the highest-risk users.1112The core concept is that people - not infrastructure - are the primary target of modern email attacks. By understanding who is targeted and who clicks, you can focus security resources where they have the most impact.1314## Anti-triggers1516- **Simulated-phishing risk scores** — KnowBe4 also reports a per-user17 "risk score" and a click rate, but those measure tests the MSP sent18 deliberately. Attack Index and VAP count real attacks. For simulation19 performance use `knowbe4-users`.20- **Enrolling a high-risk user in awareness training** — this skill21 identifies who needs it; the enrollment itself is22 `knowbe4-training`.23- **The individual threat events behind a user's Attack Index** — use24 `proofpoint-tap`, and `proofpoint-threat-intel` for the campaigns25 named in `topCampaigns`.2627## Key Concepts2829### Very Attacked People (VAP)3031VAPs are users who receive a disproportionately high volume of sophisticated attacks. VAP status is determined by:32- **Attack volume** - Total number of threats targeting the user33- **Attack sophistication** - Complexity and novelty of attacks34- **Attack diversity** - Variety of threat actors and campaigns targeting the user3536VAPs are typically executives, finance personnel, IT administrators, and people with external-facing email addresses.3738### Attack Index3940The Attack Index is a composite score (0-1000+) that quantifies the severity of threats targeting a user. It factors in:4142| Component | Weight | Description |43|-----------|--------|-------------|44| Volume | Medium | Number of threats received |45| Sophistication | High | How advanced the attacks are |46| Actor reputation | High | Whether known threat actors are involved |47| Threat type mix | Medium | Diversity of attack types (phish, malware, BEC) |4849Higher Attack Index = more severe threats targeting the user.5051### Click Susceptibility5253| Metric | Description | Range |54|--------|-------------|-------|55| `clickRate` | Percentage of threats the user clicked on | 0-100% |56| `clickCount` | Total number of malicious clicks | Integer |57| `uniqueThreatsClicked` | Distinct threats clicked | Integer |58| `lastClickTime` | Most recent click on a threat | Datetime |5960### User Risk Categories6162| Category | Attack Index | Click Rate | Action |63|----------|-------------|------------|--------|64| **Very High Risk** | > 500 | > 10% | Isolate browsing, MFA everywhere, priority training |65| **High Risk** | 200-500 | 5-10% | Enhanced email filtering, additional MFA |66| **Medium Risk** | 50-200 | 2-5% | Standard controls, regular training |67| **Low Risk** | < 50 | < 2% | Baseline controls |6869## Field Reference7071### VAP Report Fields7273| Field | Type | Description |74|-------|------|-------------|75| `identity` | object | User identity details |76| `identity.emails` | string[] | User email addresses |77| `identity.name` | string | User display name |78| `identity.department` | string | User department |79| `identity.title` | string | User job title |80| `identity.vip` | boolean | Whether the user is flagged as VIP |81| `attackIndex` | int | Composite attack severity score |82| `threatStatistics` | object | Breakdown of threats by type |83| `threatStatistics.totalThreats` | int | Total threats received |84| `threatStatistics.malwareCount` | int | Malware threats received |85| `threatStatistics.phishCount` | int | Phishing threats received |86| `threatStatistics.impostorCount` | int | BEC/impostor threats received |87| `families` | string[] | Threat families targeting this user |88| `topCampaigns` | object[] | Most significant campaigns targeting this user |8990### Top Clickers Fields9192| Field | Type | Description |93|-------|------|-------------|94| `identity` | object | User identity details |95| `clickStatistics` | object | Click activity breakdown |96| `clickStatistics.clickCount` | int | Total malicious clicks |97| `clickStatistics.permitCount` | int | Clicks that were permitted |98| `clickStatistics.blockCount` | int | Clicks that were blocked |99| `clickStatistics.clickRate` | float | Click-through rate on threats |100| `clickStatistics.uniqueThreats` | int | Distinct threats clicked |101| `clickStatistics.lastClick` | datetime | Most recent click time |102| `clickStatistics.classifications` | object | Breakdown by malware, phish |103104### User Risk Profile Fields105106| Field | Type | Description |107|-------|------|-------------|108| `email` | string | User email address |109| `riskScore` | int | Overall risk score (0-1000) |110| `attackIndex` | int | Attack severity targeting this user |111| `clickRate` | float | Historical click-through rate |112| `riskCategory` | string | `very_high`, `high`, `medium`, `low` |113| `vulnerabilityFactors` | string[] | Contributing risk factors |114| `recommendedActions` | string[] | Suggested remediation steps |115| `trainingStatus` | object | Security awareness training completion |116117## MCP Tools118119| Tool | Description | Key Parameters |120|------|-------------|----------------|121| `proofpoint_people_get_vap` | Very Attacked People report — users ranked by attack index | `window`, `page`, `size` |122| `proofpoint_people_get_top_clickers` | Users who clicked the most threat URLs | `window`, `page`, `size` |123| `proofpoint_people_get_user_risk` | Risk score and attack details for one user | `email` (required), `window` |124125Three tools, all read-only. **The People domain changes nothing** — there126is no write tool on this server at all.127128### Not available through this plugin129130- **A separate attack-index ranking.** The attack index *is* the ranking131 `proofpoint_people_get_vap` returns; there is no second tool for it, and132 no `department` filter anywhere. Departmental comparison means pulling133 the VAP list and grouping it yourself against your own roster.134- **Anything to do with VIP flags.** No tool lists VIPs and none sets one.135 **VAP and VIP are different concepts** and the similarity of the acronyms136 is the trap: VAP is computed by Proofpoint from attack volume, VIP is an137 administrator-assigned protection flag. This plugin can read the first138 and cannot see or touch the second. Set VIP flags in the Proofpoint139 console.140141## Common Workflows142143### Generate VAP Report1441451. Call `proofpoint_people_get_vap` with `window=30` and `size=20`1462. Review the top 20 most attacked users1473. Cross-reference with organizational role - are they executives, finance, IT?1484. For each VAP, check their click rate using `proofpoint_people_get_user_risk`1495. Prioritize users who are both heavily targeted and have high click rates1506. Recommend additional controls for the highest-risk users151152### Identify Training Candidates1531541. Call `proofpoint_people_get_top_clickers` with `window=90` and `size=50`1552. Identify users with the highest click rates1563. Check if they have completed recent security awareness training1574. Enroll high-clickers in targeted phishing simulation campaigns1585. Follow up after training to measure improvement159160### Executive Risk Assessment1611621. Bring your own list of executives — the VIP flag is not readable here,163 so the roster comes from the customer's HR or directory data, not from164 Proofpoint1652. For each, call `proofpoint_people_get_user_risk` with their email1663. Assess attack index and click susceptibility1674. Recommend enhanced controls: browser isolation, advanced MFA, dedicated monitoring1685. Present risk summary to leadership169170### Department Risk Comparison1711721. Call `proofpoint_people_get_vap` with a large `size` to get the ranked173 attack-index list — there is no `department` filter1742. Join the returned users against your own department roster1753. Compare average attack index across departments1764. Identify which departments are most targeted1775. Allocate security resources proportionally178179### New User Baseline1801811. After a new user is onboarded, wait 30 days1822. Call `proofpoint_people_get_user_risk` with the user's email1833. Establish baseline risk score and attack index1844. If the user is immediately targeted (high attack index), investigate why1855. Ensure appropriate training has been completed186187## Error Handling188189### Common API Errors190191| Code | Message | Resolution |192|------|---------|------------|193| 400 | Invalid window | Use 14, 30, or 90 for the window parameter |194| 400 | Invalid size | Size must be between 1 and 1000 |195| 401 | Authentication failed | Verify service principal and secret |196| 403 | People API not enabled | Ensure your license includes People-Centric Security |197| 404 | User not found | The email address may not exist in Proofpoint |198| 429 | Rate limit exceeded | Implement backoff |199200### No VAP Data201202- New organizations may not have enough data for VAP reports (requires 14+ days)203- Very small organizations may not have enough volume for meaningful rankings204- Check that email flow is routing through Proofpoint correctly205206## Best Practices2072081. **Review VAP reports monthly** - Attack patterns shift; update your high-risk user list regularly2092. **Combine attack index with click rate** - A user who is heavily attacked AND clicks frequently is highest priority2103. **Flag executives as VIP** - Ensure C-suite and board members have the VIP flag for enhanced protection2114. **Use department data for budgeting** - Show leadership which departments need the most security investment2125. **Track click rates over time** - Measure the effectiveness of security awareness training2136. **Implement adaptive controls** - Apply stricter policies (browser isolation, MFA step-up) for high-risk users2147. **Don't blame users** - Use click data to improve training, not to punish users2158. **Correlate with HR data** - Cross-reference VAP data with job function to understand targeting patterns2169. **Automate VIP management** - Sync VIP flags with your HR system for executives and key personnel21710. **Report to leadership quarterly** - Present people risk metrics alongside infrastructure security metrics218219## Related Skills220221- [Proofpoint TAP](../tap/SKILL.md) - Threat events and click tracking222- [Proofpoint Threat Intelligence](../threat-intel/SKILL.md) - Campaigns targeting your users223- [Proofpoint URL Defense](../url-defense/SKILL.md) - URL rewriting protects clickers224- [Proofpoint API Patterns](../api-patterns/SKILL.md) - Authentication and rate limits