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.20.tar.gz (100.6 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.20-py3-none-any.whl (98.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for apiposture_pro-1.0.20.tar.gz
Algorithm Hash digest
SHA256 af94bfdd04a8c45546c63d276fc5cf1e006b8ad3f1f9424502a4553f2b54a45d
MD5 17ed9032125f7a087d90819fd1d23950
BLAKE2b-256 4634aa0a2103358bd211ef2b466ba87b5aca5fd546ac8a54ed703d7c6a720ae8

See more details on using hashes here.

Provenance

The following attestation bundles were made for apiposture_pro-1.0.20.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.20-py3-none-any.whl.

File metadata

File hashes

Hashes for apiposture_pro-1.0.20-py3-none-any.whl
Algorithm Hash digest
SHA256 31d5e37aed9eeec1721b057a7bac8fc8bee348ad66fb875be7e00665ac14af68
MD5 4438c66e12709492e8f8b32c94c8ba0d
BLAKE2b-256 7f5a7bfa5f1004b2b0f428b12eb443777a134bba41595e11169dad687d78b402

See more details on using hashes here.

Provenance

The following attestation bundles were made for apiposture_pro-1.0.20-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