pacu - The AWS exploitation framework, designed for testi

项目说明

Quick reference

Where to get help:

the Rhino Security Labs Discord, or Stack O

Where to file issues:

Maintained by:

Rhino Security Labs

What is Pacu?

Pacu is an open-源码 AWS exploitation 框架, designed for offensi testing against cloud en. Created and maintained by Rhino Security Labs, Pacu allows penetration testers to exploit configuration flaws within an AWS account, using modules to easily expand its functionality. Current modules enable a range of attacks, including user pri escalation, backdooring of IAM users, attacking Lambda functions, and much more.

Installation

Pacu is a fairly lightweight program, as it requires only Python3.7+ and pip3 to install a handful of Python libraries.

Quick Installation

Install with Pipx

This is the preferred method when using Kali Linux as pip is no longer installed by default. This will install Pacu with the latest updates which may not be included in the official release.

For a more detailed and user-friendly set of user instructions, please check out the Wiki's installation guide.

How to use Pacu's Docker image

![Try in PWD]()

Option 1: Run with default entrypoint which directly runs Pacu

Option 2: Run without default entrypoint

Option 3: Run with AWS config and credentials

> Warning: Running this command will mount your local AWS configuration files into the Docker container when it is launched. This means that any user with access to the container will ha to your host computer's AWS credentials.

Getting Started

The first time Pacu is launched, you will be prompted to start and name a new session. This session will be used to store AWS key pairs, as well as any data obtained from running modules. You can have any number of different sessions in Pacu, each with their own sets of AWS keys and data, and resume a session at any time (though a restart is currently required to switch between sessions).

Modules require an AWS key, which grants you minimal access to an AWS en and is comprised of an access key ID and a secret access key. To set your session's keys, use the set_keys command, and then follow the prompts to supply a key alias (nickname for reference), an AWS access key ID, an AWS secret access key, and an AWS session token (if you are using one).

If you are e, help will bring up a list of a commands.

Basic Commands in Pacu

* list will list the a modules for the regions that were set in the current session.
* help module_name will return the applicable help information for the specified module.
* run module_name will run the specified module with its default parameters.
* run module_name --regions eu-west-1,us-west-1 will run the specified module against the eu-west-1 and us-west-1 regions (for modules that support the --regions argument)

Running Pacu From the CLI

* pacu --help will display the help menu
* pacu --session <session name> sets the session to use for commands that require one
* pacu --list-modules will list all modules a (does not require session)
* pacu --pacu-help will list the pacu help window (does not require session)
* pacu --module-name <module name> the name of a module to perform an action on, you can execute or get information on the module
* pacu --exec execute the module provided in --module-name
* pacu --module-info get information on the module provided in --module-name
* pacu --data <service name || all> query the local SQLAlchemy 数据库 to retrie information
* pacu --module-args="<arg1> <value> <arg2> <value>" supply optional module arguments to the module being executed
* pacu --set-regions <region1 region2 || all> set the regions to use in the session, separate regions by a space or enter all for all regions
* pacu --whoami get information about the current user

Pacu's Modular Power

Pacu uses a range of plug-in modules to assist an attacker in enumeration, pri escalation, data exfiltration, service exploitation, and log manipulation within AWS en. Contributions or ideas for new modules are welcome.

To keep pace with ongoing AWS product de, we' Pacu from the ground up with extensibility in mind. A common syntax and data structure keep modules easy to build and expand on - no need to specify AWS regions or make redundant permission checks between modules. A local SQLite 数据库 is used to manage and manipulate retrieved data, minimizing API calls (and associated logs). Reporting and attack auditing is also built into the 框架; Pacu assists the documentation process through command logging and exporting, helping build a timeline for the testing process.

Community

We're always happy to get bug reports in the Pacu 框架 itself, as well as testing and feedback on different modules, and generally, critical feedback to help refine the 框架. Any support for Pacu through use, testing, impro, or just by spreading the word, would be very much appreciated.

If you're interested in contributing directly to the Pacu 框架 itself, please read our contribution guidelines for 代码 con and git-flow notes.

De Pacu Modules

If you're interested in writing your own modules for Pacu, check out our Module De wiki page. As you develop new capabilities please reach out to us -- we'd love to add your new modules into the core collection that comes with Pacu.

Pacu Framework De Goals

* Impro formatting
* 数据库 forward-migrations and tracking
* "Attack Playbooks" to allow for easier use of complex module execution chains
* Colored console output
* Module Dry-Run functionality
* Allow use of standalone config files
* Plugin architecture impro

Notes

* Pacu is officially supported in OSX and Linux.
* Pacu is Open-源码 Software and is distributed with a BSD-3-Clause License.

Submitting Requests / Bug Reports

Report in Pacu directly to us : .

Pacu creates error logs within each session's folder, as well as a global error log for out-of-session errors which is created in the main directory. If you can, please include these logs with your bug reports, as it will dramatically simplify the debugging process.

If you have a feature request, an idea, or a bug to report, please submit them here.

- Please include a description sufficient to reproduce the bug you found, including tracebacks and reproduction steps, and check for other reports of your bug before filing a new bug report. Don't submit duplicates.

Wiki

For walkthroughs and full documentation, please visit the Pacu wiki.

Contact Us

* We'd love to hear from you, whatever the reason. Reach out on the Rhino Security Labs Discord.

Disclaimers, and the AWS Acceptable Use Policy

* To the best of our knowledge Pacu's capabilities are compliant with the AWS Acceptable Use Policy, but as a flexible and modular 工具, we cannot guarantee this will be true in every situation. It is entirely your responsibility to ensure that how you use Pacu is compliant with the AWS Acceptable Use Policy.
* Depending on what AWS services you use and what your planned testing entails, you may need to review AWS Customer Support Policy for Penetration Testing before actually running Pacu against your infrastructure.
* As with any penetration testing 工具, it is your responsibility to get proper authorization before using Pacu outside of your en.
* Pacu is software that comes with absolutely no warranties whatsoever. By using Pacu, you take full responsibility for any and all outcomes that result.

项目信息

开发语言：Python

Star 数：5344

技术要点

该项目属于黑客技术方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕The AWS exploitation 框架, designed for testing the security of Amazon Web Services en.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。