Skip to main content

AttackMap ATProto Analyzer

attackmap-analyzer-atproto is a thin protocol-aware overlay analyzer for AttackMap.

It is designed to enrich Node/TypeScript service scans (such as node-service) with AT Protocol-specific exposure signals:

  • protocol namespaces: com.atproto.*, app.bsky.*, chat.bsky.*, tools.ozone.*, plus any third-party authority declared by the repo's own lexicon ids (e.g. sh.tangled.*)
  • lexicon-inferred XRPC endpoint surface. Only defs.main of type query (→ GET), procedure (→ POST) or subscription (→ WS) is an endpoint; record, object and defs-only lexicons are not.
  • XRPC handler registrations (server.method(nsid, …), generated server.<nsid>({ auth, handler })) with their per-endpoint auth:
    • a configured auth: verifier is an atproto_auth:route_verifier:<nsid> AuthHint
    • a handler with no verifier, or an optional one (*Optional*, nullCreds), is marked atproto_route_auth:anonymous:<nsid> (a ProtocolHint, so core never counts it as an auth control). Core's Route model has no auth field yet.
  • protocol auth/signing/identity hints (did:plc / PLC directory, @atproto/crypto and signing/verification APIs; not the bare words "sign", "verify" or "plc")
  • process.env.* secret references (not arbitrary quoted constants)
  • event stream/subscription exposure hints
  • service notes that complement service-level analyzers

This module is heuristic and intentionally lightweight.

detect() fires on a lexicons/ directory, an @atproto/* (or @did-plc/*) dependency in any package.json, a lexicon document under a lexicons/ path, a quoted NSID under a known authority, or an /xrpc/<nsid> URL in JS/TS source. Lockfiles (package-lock.json, npm-shrinkwrap.json) and AttackMap's own report files are never read. Other JSON files are only read to recognize lexicon documents.

Install

uv tool install attackmap --with attackmap-analyzer-atproto \
  --index mlaify=https://pkg.mlaify.io/pypi/simple/ --index-strategy first-index
# or from source:
pip install git+https://github.com/mlaify/attackmap-analyzer-atproto.git

Usage

attackmap analyze /path/to/repo --module node-service --module atproto

Metadata

Release files for attackmap-analyzer-atproto 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for attackmap-analyzer-atproto 0.2.0
File Size Uploaded Provenance Actions
attackmap_analyzer_atproto-0.2.0.tar.gz 19.4 kB With provenance Details for attackmap_analyzer_atproto-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for attackmap-analyzer-atproto 0.2.0
File Interpreter ABI Platform Actions
attackmap_analyzer_atproto-0.2.0-py3-none-any.whl Python 3 none any Details for attackmap_analyzer_atproto-0.2.0-py3-none-any.whl

Total release size: 32.1 kB

Release files / attackmap_analyzer_atproto-0.2.0.tar.gz

Download URL attackmap_analyzer_atproto-0.2.0.tar.gz
Size 19.4 kB
Tags Source
SHA-256 checksum
How to use checksums
555a5f5ff0dfb3fcc2a0f29677120b9da1be7c90b996a9eb0173decfbf2d80f4
BLAKE2b-256 checksum
How to use checksums
8aa3d95ec124e46db0baf1e1bffda7629100f1a7d3f898ea9b6a0cad2deaaa18
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / attackmap_analyzer_atproto-0.2.0-py3-none-any.whl

Download URL attackmap_analyzer_atproto-0.2.0-py3-none-any.whl
Size 12.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12a1ef95a06b720af69b60ea63a7efef7c831f42d2abd10d4e00eb1f5698359d
BLAKE2b-256 checksum
How to use checksums
171ed4addb937e48d6a35baf70107f6f08ee54115c3944172c4225ea7e4e93f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for attackmap-analyzer-atproto 0.2.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for attackmap_analyzer_atproto-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page