audit-labs/audit-tools

A collection of scripts, queries, and other goodies you can use in an audit.

clone: git clone https://gitbay.org/audit-labs/audit-tools.git

ac4dcf4f6d9c4cb8dc1276731a272b3a5efeb3c4

verified · cmc

author: Christian Cleberg <hello@cleberg.net> · 2026-02-22T05:56:11Z

update README
 README.md  | 89 --------------------------------------------------------------
 README.org | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 89 deletions(-)

diff --git a/README.md b/README.md
deleted file mode 100644
index 3a01f20..0000000
--- a/README.md
+++ /dev/null
@@ -1,89 +0,0 @@
-# Audit Tools
-
-**Audit Tools** is a collection of open-source Python scripts and related resources intended to support auditors, risk professionals, and data analysts in automating common audit procedures and analyses.
-
-This repository includes practical examples that can be used as-is or adapted to specific audit environments.
-
-## Contents
-
-The repository includes scripts and templates related to:
-
-- Pseudo-random sampling
-- General IT controls (GITC) extraction and analysis
-- Project management tracking and visualization
-- Cloud platform analysis (planned)
-- Prompt engineering and AI audit guidance (planned)
-
-These tools are intended to be straightforward and applicable across a range of audit contexts.
-
-## Getting Started
-
-**Clone the Repository**
-
-```bash
-git clone https://github.com/audit-labs/audit-tools
-cd audit-tools
-```
-
-**Install Dependencies**
-
-Required for running the Python scripts:
-
-```bash
-pip install -r requirements.txt
-
-# or, if you prefer `uv`:
-uv run file.py
-```
-
-**Run a Sample Script**
-
-For example, to run the Linux OS report tool:
-
-```bash
-./os/linux/report/linux.sh
-```
-
-Output will be shown in the terminal or saved to a file, depending on the script.
-
-## Resources
-
-If you're new to scripting or audit analytics, you may find the following helpful:
-
-- [Python for Auditors](https://realpython.com)
-- [Audit Analytics 101](https://audit-analytics.com)
-- [Getting Started with Pandas](https://pandas.pydata.org/docs/getting_started/)
-
-See the `notebooks/` directory for additional walkthroughs and examples.
-
-## Contributing
-
-Contributions are welcome. You can contribute by:
-
-- Adding new audit-related scripts
-- Suggesting improvements or feature ideas
-- Enhancing documentation or tutorials
-- Testing the tools on additional datasets and reporting any issues
-
-To contribute:
-
-1. Fork the repository
-2. Create a new branch:
-
-   ```bash
-   git checkout -b my-feature
-   ```
-
-3. Commit your changes:
-
-   ```bash
-   git commit -m 'Added new audit test'
-   ```
-
-4. Push your branch:
-
-   ```bash
-   git push origin my-feature
-   ```
-
-5. Open a pull request
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..f89693f
--- /dev/null
+++ b/README.org
@@ -0,0 +1,84 @@
+* Audit Tools
+
+*Audit Tools* is a collection of open-source Python scripts and related resources
+intended to support auditors, risk professionals, and data analysts in
+automating common audit procedures and analyses.
+
+This repository includes practical examples that can be used as-is or adapted to
+specific audit environments.
+
+** Contents
+
+| Directory            | Description                                                                  |
+|----------------------+------------------------------------------------------------------------------|
+| =applications/aws/=    | AWS IAM users, password policy, and S3 bucket analysis                       |
+| =applications/github/= | GitHub admin enumeration, audit log, branch protections, and commit analysis |
+| =applications/gitlab/= | GitLab user provisioning, branch protections, approvals, pipelines, and more |
+| =databases/mongo/=     | MongoDB admin enumeration                                                    |
+| =databases/mysql/=     | MySQL admin and password queries                                             |
+| =databases/oracle/=    | Oracle admin queries                                                         |
+| =databases/postgres/=  | PostgreSQL admin and password queries                                        |
+| =databases/sql/=       | Generic SQL admin queries and password analysis                              |
+| =os/linux/=            | Linux OS reporting, password file analysis, and SSH root login checks        |
+| =project_management/=  | Audit project tracking dashboards (Alteryx, Dash, Power BI)                  |
+| =sampling/=            | Random and stratified sampling tools                                         |
+
+** Getting Started
+
+*Clone the Repository*
+
+#+begin_src bash
+git clone https://github.com/audit-lab/audit-toolss
+cd audit-tools
+#+end_src
+
+#+RESULTS:
+
+*Install Dependencies*
+
+#+begin_src bash
+pip install -r requirements.txt
+#+end_src
+
+*Run a Script*
+
+For example, to run the Linux OS report tool:
+
+#+begin_src bash
+./os/linux/report/linux.sh
+#+end_src
+
+Or to run a Python script:
+
+#+begin_src bash
+python sampling/sample.py
+#+end_src
+
+Output will be shown in the terminal or saved to a file, depending on the
+script.
+
+** Contributing
+
+Contributions are welcome. You can contribute by:
+
+- Adding new audit-related scripts
+- Suggesting improvements or feature ideas
+- Enhancing documentation
+- Testing the tools on additional datasets and reporting any issues
+
+To contribute:
+
+1. Fork the repository
+2. Create a new branch:
+   #+begin_src bash
+   git checkout -b my-feature
+   #+end_src
+3. Commit your changes:
+   #+begin_src bash
+   git commit -m 'Added new audit test'
+   #+end_src
+4. Push your branch:
+   #+begin_src bash
+   git push origin my-feature
+   #+end_src
+5. Open a pull request