Skip to main content

Professional security analysis tool for Python REST APIs with advanced features

Project description

ApiPosture Pro

Professional security extension for Python API security scanning

Extends the open-source ApiPosture CLI with advanced security rules, secrets detection, diff mode, historical tracking, and risk scoring.

🔒 100% Local Analysis - Your code never leaves your machine. All scanning is performed locally on your computer or CI/CD runner.

Features

Free Rules (AP001-AP008)

Included automatically — public endpoint detection, missing auth, authorization conflicts, sensitive route keywords, and more.

Pro Rules

ID Name Severity
AP009 Broken Authentication Critical
AP010 Injection Vulnerabilities High
AP011 Broken Access Control Critical
AP012 Security Misconfiguration High
AP013 Vulnerable Components High
AP014 Hardcoded Secrets (15+ patterns) Critical
AP015 API Key Exposure High
AP016 Insecure Dependencies High

Additional Pro Features

  • Risk Scoring — 0–100 scale (severity 50%, exposure 30%, surface area 20%)
  • Diff Mode — compare baseline vs current scan
  • History Tracking — SQLite-backed scan history with trends

Installation

# Install Pro CLI (includes all free and Pro rules)
pip install apiposture-pro

# Activate your license
apiposture-pro activate XXXX-XXXX-XXXX-XXXX

# Verify activation
apiposture-pro status

CI/CD: set license via environment variable

export APIPOSTURE_LICENSE_KEY=<your-jwt-token>

Usage

Scan

# Basic scan
apiposture-pro scan /path/to/your/api

# JSON output
apiposture-pro scan /path/to/your/api --output json --file report.json

# Save to history
apiposture-pro scan /path/to/your/api --with-history

# Disable risk score
apiposture-pro scan /path/to/your/api --no-risk-score

Diff Mode

apiposture-pro scan /path/to/api -f baseline.json
# ... make changes ...
apiposture-pro scan /path/to/api -f current.json
apiposture-pro diff baseline.json current.json

History

apiposture-pro history list
apiposture-pro history trend -p /path/to/api
apiposture-pro history show <scan-id>
apiposture-pro history cleanup --days 90

License

apiposture-pro status
apiposture-pro deactivate

Enterprise

Enterprise features require an Enterprise license (APIPOSTURE_LICENSE_KEY or apiposture-pro activate).

Compliance Reports

Generate SOC 2 / ISO 27001 compliance reports mapped to your scan findings:

# Generate PDF + HTML report
apiposture-pro compliance report . --framework soc2 --output both

# Specific framework, operator attribution
apiposture-pro compliance report . --framework iso27001 --output pdf --operator "Acme Corp"

# All frameworks
apiposture-pro compliance report . --framework all --output both

Compliance Score in Scan Output

# Show compliance score alongside risk score
apiposture-pro scan . --comp-framework soc2
apiposture-pro scan . --comp-framework iso27001

Starter Kits

Emit a pre-configured policy file, sample report, and GitHub Actions workflows:

apiposture-pro compliance starter-kit soc2 ./compliance/
apiposture-pro compliance starter-kit iso27001 ./compliance/

Generates: .apiposture-policy.json, sample-report.html, github-actions/apiposture-pr-gate.yml, github-actions/apiposture-weekly-report.yml, README.md.

Policy Enforcement

Place .apiposture-policy.json in your project root (generated by starter-kit or written manually). The scanner reads it automatically and exits with code 1 on violations:

{
  "zero_tolerance": ["AP014", "AP009"],
  "warn": ["AP010", "AP011"]
}

Operator Attribution

apiposture-pro scan . --operator "Security Team"

The operator name is embedded in findings output and scan records.

Audit Trail Export

Export a tamper-evident audit trail from scan history:

# JSON export (stdout)
apiposture-pro history export --format json

# JSON to file
apiposture-pro history export --format json --output-file audit.json

# PDF export
apiposture-pro history export --format pdf --output-file audit-export.pdf

# Specific scan record
apiposture-pro history export --scan-id 42 --format pdf --output-file audit-42.pdf

Integrity Verification

# Verify latest scan record integrity
apiposture-pro verify

# Verify specific scan
apiposture-pro verify --scan-id 42

CI/CD Integration

GitHub Actions

name: Security Scan
on: [push, pull_request]
jobs:
  security:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - run: pip install apiposture-pro
      - run: apiposture-pro scan . --output json --file results.json
        env:
          APIPOSTURE_LICENSE_KEY: ${{ secrets.APIPOSTURE_LICENSE_KEY }}
      - uses: actions/upload-artifact@v4
        with:
          name: security-scan-results
          path: results.json

GitLab CI

security_scan:
  image: python:3.12
  script:
    - pip install apiposture-pro
    - apiposture-pro scan . --output json --file results.json
  variables:
    APIPOSTURE_LICENSE_KEY: $APIPOSTURE_LICENSE_KEY
  artifacts:
    paths:
      - results.json

Azure DevOps

steps:
  - task: UsePythonVersion@0
    inputs:
      versionSpec: '3.12'
  - script: pip install apiposture-pro
  - script: apiposture-pro scan . --output json --file $(Build.ArtifactStagingDirectory)/results.json
    env:
      APIPOSTURE_LICENSE_KEY: $(ApiPostureLicenseKey)

Supported Frameworks

  • FastAPI 0.100+
  • Flask 2.3+
  • Django REST Framework 3.14+

Privacy

All analysis is performed 100% locally. No code, findings, or project data is uploaded to external servers. Only the license key is sent to api.apiposture.com during activation/validation. SQLite history is stored at ~/.apiposture/history.db.

License Tiers

Feature Pro Enterprise
Free rules (AP001-AP008)
OWASP rules (AP009-AP013)
Secrets detection (AP014-AP015)
Dependency scanning (AP016)
Diff mode
Historical tracking
Risk scoring
Compliance reports (SOC 2 / ISO 27001)
Compliance score + trend
Starter kits
Policy enforcement
Audit trail export
Operator attribution
Integrity verification

Links

Changelog

1.1.0

  • Enterprise tier: compliance reports (SOC 2 / ISO 27001), compliance score, starter kits, policy enforcement, audit trail export, operator attribution, integrity verification

1.0.0 (2026-02-09)

  • Initial release: OWASP rules (AP009-AP013), secrets detection (AP014-AP015), dependency scanning (AP016), diff mode, history tracking, risk scoring

Copyright © 2026 ApiPosture. All rights reserved. | License Terms

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apiposture_pro-1.0.22.tar.gz (163.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apiposture_pro-1.0.22-py3-none-any.whl (98.4 kB view details)

Uploaded Python 3

File details

Details for the file apiposture_pro-1.0.22.tar.gz.

File metadata

  • Download URL: apiposture_pro-1.0.22.tar.gz
  • Upload date:
  • Size: 163.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for apiposture_pro-1.0.22.tar.gz
Algorithm Hash digest
SHA256 bdd82c0401337114340bf1847fff59b195e9e9d24d15e0aad0151992192393d2
MD5 f90bdcbf9dd596cfe00043f3f39df29b
BLAKE2b-256 c765d24e548000bfed138b9b458c468fe3411a3fdfe3da100222c115cc2de421

See more details on using hashes here.

Provenance

The following attestation bundles were made for apiposture_pro-1.0.22.tar.gz:

Publisher: publish.yml on ApiPosture/ApiPosturePro.Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apiposture_pro-1.0.22-py3-none-any.whl.

File metadata

File hashes

Hashes for apiposture_pro-1.0.22-py3-none-any.whl
Algorithm Hash digest
SHA256 1062d52d47395710ba5bc37c123fdf35edcaef1b7c403378e568af9c7a1390eb
MD5 8c5b6758b989b3149f941b83509f7de1
BLAKE2b-256 53fc2805c43978f454b73847992e510f93dfebce94f2c37b6dcae7c0a8048270

See more details on using hashes here.

Provenance

The following attestation bundles were made for apiposture_pro-1.0.22-py3-none-any.whl:

Publisher: publish.yml on ApiPosture/ApiPosturePro.Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page