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.