Proofpoint People
SkillSecurityProofpoint 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Proofpoint People skill
What this skill tells your AI
The instructions your AI receives, as published by wyre-ai/msp-claude-plugins in msp-claude-plugins/email-security/proofpoint/skills/people/SKILL.md and read by ahel’s review.
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, andproofpoint-threat-intelfor the campaigns named intopCampaigns.
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_vapreturns; there is no second tool for it, and nodepartmentfilter 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_vapwithwindow=30andsize=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_clickerswithwindow=90andsize=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_riskwith 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_vapwith a largesizeto get the ranked attack-index list — there is nodepartmentfilter - 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_riskwith 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
- Proofpoint TAP - Threat events and click tracking
- Proofpoint Threat Intelligence - Campaigns targeting your users
- Proofpoint URL Defense - URL rewriting protects clickers
- Proofpoint API Patterns - Authentication and rate limits
Signals
- GitHub stars
- 45
- Forks
- 24
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
proofpoint-people- Source
- github.com/wyre-ai/msp-claude-plugins