pmapper

Identify IAM privilege escalation paths to administrative access in AWS accounts.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/aurainfosec/cloud-review-automation-poc --skill pmapper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pmapper
Source: https://github.com/aurainfosec/cloud-review-automation-poc/tree/main/skills/pmapper
Command: npx skills add https://github.com/aurainfosec/cloud-review-automation-poc --skill pmapper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PMapper eliminates guesswork in IAM privilege escalation investigations by deterministically mapping who can reach administrative access within an AWS account.

Core Features & Use Cases

  • Builds an IAM principal relationship graph to model assume/escalate pathways as a directed graph.
  • Produces deterministic, evidence-backed escalation findings (including escalation-only results via skipping already-admin principals).
  • Supports targeted questions like who can assume a role, who can perform an action (with optional resource constraints), and who can reach a specific principal.

Use Case: Determine "who can reach admin" after identifying a potentially risky role or permission set, then use PMapper output as confirmed evidence for the escalation chain.

Quick Start

Ask your AI assistant to run a priv-esc query like "who can reach admin in this AWS account and provide the deterministic escalation evidence."

Frequently Asked Questions about pmapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find IAM privilege escalation paths in an AWS account?▼

To find IAM privilege escalation paths, you need to build a Principal Mapper graph modeling assume and escalate pathways, then run deterministic analysis queries to identify who can reach administrative access.

What is the best way to check who can assume a specific IAM role in AWS?▼

The best way to check who can assume a specific IAM role is to run a targeted graph query on a built IAM principal relationship graph, which evaluates role assumption reachability and outputs deterministic JSON evidence.

Can I identify which AWS principals can perform an action through lateral movement analysis?▼

Yes, you can identify which AWS principals can perform an action by running targeted graph queries on a PMapper IAM graph, allowing you to trace lateral movement and apply optional resource constraints to the analysis.

Does this approach detect PassRole and Lambda code injection abuse scenarios?▼

Yes, this approach detects PassRole and Lambda code injection abuse scenarios by mapping IAM principal relationships as a directed graph to identify privilege escalation pathways and administrative access reachability.

How do I get escalation evidence without including principals that are already admins?▼

To get escalation evidence without including existing admins, run the analysis while skipping already-admin principals, which produces deterministic results showing only the strict privilege escalation paths.

What do I need to run a Principal Mapper analysis for AWS security policy validation?▼

You need to build or reuse a PMapper IAM graph representing your AWS account's principal relationships to run deterministic analysis or targeted graph queries for security policy validation.