MFAudit
Automated RACF security auditing — from raw RACF exports to audit-ready reports in a single command.
MFAudit reads standard z/OS security exports — IRRDBU00 unloads and SETROPTS REXX exports — and evaluates them against CIS Benchmark, STIG, and custom RACF security controls.
The result:
- styled PDF reports;
- CSV exports;
- JSON exports;
- deterministic PASS / FAIL / REVIEW verdicts;
- optional anonymized output for external sharing.
Full documentation → mfaudit.readthedocs.io
What you get
| 46+ CIS controls | Password policy, class activation, STARTED tasks, USS, Db2, CICS |
| Custom controls | Write organization-specific RACF checks in YAML |
| PDF reports | Human-readable audit reports with findings and summaries |
| CSV exports | Spreadsheet, SIEM, and dashboard integration |
| JSON exports | Splunk, Elastic, APIs, and automation workflows |
| Anonymized reports | Replace RACF identifiers with stable pseudonymous labels |
Quick start
# 1 Install MFAudit
pip install mfaudit
# 2 Run the audit (bundled CIS controls used by default)
mfaudit \
--irrdbu00 /path/to/IRRDBU00 \
--setropts /path/to/SETROPTS
# 3 Open the report
open report.pdf # macOS
xdg-open report.pdf # Linux
start report.pdf # Windows
Default behavior:
--format CSV,PDF
Controls requiring unavailable data sources are automatically marked as SKIP.
Output formats
Default outputs
mfaudit
Generated files:
report.pdf
controls_results.csv
JSON output
mfaudit --format JSON
Generated file:
controls_results.json
Multiple output formats
mfaudit --format CSV,JSON,PDF
Generated files:
report.pdf
controls_results.csv
controls_results.json
Supported values:
| Format | Output |
|---|---|
PDF |
report.pdf |
CSV |
controls_results.csv |
JSON |
controls_results.json |
Repository layout
controls.yaml CIS Benchmark controls
example_controls.yaml Example custom controls
mfaudit/ Python package and CLI
templates/ Bundled report templates
docs/ MkDocs / ReadTheDocs documentation
Writing your own controls
Controls are YAML-based.
Each control explicitly defines:
- the required data source;
- the mfpandas DataFrame;
- the logic engine;
- the assertion logic;
- remediation guidance.
Example:
controls:
- control_id: CUSTOM-NO-DUAL-PRIVS
title: "No active user may hold both SPECIAL and OPERATIONS"
severity: high
custom:
benchmark: "Internal policy"
category: "Privileged access"
data_sources_needed:
- irrdbu00
implementation:
engine: python
dataset: irrdbu00.users
select_columns:
- USBD_NAME
- USBD_SPECIAL
- USBD_OPER
logic: |
hits = df[
(df['USBD_SPECIAL'] == 'YES') &
(df['USBD_OPER'] == 'YES') &
(df['USBD_REVOKE'] != 'YES')
]
status = 'FAIL' if not hits.empty else 'PASS'
detail = f"{len(hits)} user(s) hold both SPECIAL and OPERATIONS"
findings = hits.to_dict('records')
remediation: >
ALTUSER <userid> NOSPECIAL
or
ALTUSER <userid> NOOPER
Available engines
| Engine | Use case |
|---|---|
pandas_query |
Simple DataFrame filtering and assertions |
python |
Multi-DataFrame logic, branching, advanced analysis |
See:
for the complete schema and engine reference.
Data sources
| Source | mfpandas class | Collection method |
|---|---|---|
--setropts |
SETROPTS |
IRRXUTIL/REXX export (KEY:VALUE) |
--irrdbu00 |
IRRDBU00 |
IRRDBU00 RACF unload |
--dcollect |
DCOLLECT |
IDCAMS DCOLLECT output (optional) |
See:
for detailed collection instructions.
Templates
Bundled templates:
| Template | Style |
|---|---|
default |
Light corporate report |
terminal |
Green phosphor 3270-style terminal theme |
Example:
mfaudit --template terminal
List available templates:
mfaudit --list-templates
Anonymized reporting
Generate reports safe for external sharing:
mfaudit --format CSV,JSON,PDF \
--anonymize
Example anonymized identifiers:
USR-0001
GRP-0042
PRF-0017
Mappings remain stable during a single execution run so findings remain readable and correlatable.
Requirements
- Python 3.9 or later
pip install mfaudit- Optional:
pip install "mfaudit[pdf-xhtml]"
WeasyPrint is the preferred PDF renderer.
If unavailable, MFAudit automatically falls back to xhtml2pdf when installed.
CSV and JSON output remain available even if PDF rendering fails.
Use cases
- RACF security assessments
- CIS Benchmark validation
- STIG evidence generation
- Internal audit preparation
- Mainframe compliance automation
- Continuous RACF posture monitoring
- Security baseline verification
- SIEM evidence export
- Splunk/Elastic integrations
Disclaimer
All findings must be reviewed and validated by qualified RACF security personnel before remediation.
REVIEW status findings require human assessment and cannot be automatically classified as compliant or non-compliant.
Metadata
Release files for mfaudit 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mfaudit-0.1.3.tar.gz | 47.1 kB | Without provenance | Details for mfaudit-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mfaudit-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for mfaudit-0.1.3-py3-none-any.whl |
Total release size: 95.2 kB
Release files / mfaudit-0.1.3.tar.gz
| Download URL | mfaudit-0.1.3.tar.gz |
|---|---|
| Size | 47.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
de5cfc29bca0457d5a690c3979f35db01570544352d1be75fcdc9e70383752f9
|
|
BLAKE2b-256 checksum How to use checksums |
f654c0e8ee022d0800e6fb7d23e5f791201697fabdfe99f53a6bd10e3f3f004d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / mfaudit-0.1.3-py3-none-any.whl
| Download URL | mfaudit-0.1.3-py3-none-any.whl |
|---|---|
| Size | 48.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
05a772cbc882a1fad239c50b4708ef38763e767e2bcb131355b4f130eb423f3f
|
|
BLAKE2b-256 checksum How to use checksums |
2a7aead047e7cebdef75b26223f0f29fc6b4481ad3e3fdc1158634eb3290624f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for mfaudit 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.