Skip to main content

Documentation

Build with PasskeyBridge.

Explore guides, API references, and architectural documentation for the Identity Threat Response platform. 20 US patent applications filed (7 non-provisional, 13 provisional).

All guides

79 guides across 12 areas, from the first signal ingest to the cryptography underneath it.

Overview

Platform fundamentals and core concepts.

  • What is PasskeyBridge?

    What the platform does, the three pillars, the public API surface, the plans, and the keyed-hash privacy model.

  • Architecture Deep Dive

    The three-pillar model, request lifecycle, shared modules, latency budget, cascade revocation, and how tenants are kept isolated from each other.

  • Multi-Tenant Data Model

    How one organization's data is separated from another's: row-level security, code-level scoping on API paths, and what is keyed per organization.

Quickstart

Send your first signal with a sandbox key.

Authentication

API keys, JWT tokens, and access control.

  • Authentication

    The two credentials that reach PasskeyBridge, how to mint and send an API key, what each scope gates, signature policy, and how rotation works.

  • Scopes & Permissions

    The fifteen mintable API key scopes, what each function checks, the admin super-scope, and the separate scopes for agent delegates and A2A.

Identity Signals

Carrier signal ingestion and threat detection.

  • Carrier providers

    Provider selection, normalized carrier signals, billing boundaries, failover settings and measured lookup health.

  • Identity Signals

    The identity signal types PasskeyBridge ingests, the ingest request end to end, hard and soft classification, and what is stored and forwarded.

  • AI Threat Intelligence Pipeline

    The Enterprise-only intelligence worker: what it analyses, the assessment it writes, the hallucination cross-check, clustering and human review.

  • Carrier Provider Setup

    How PasskeyBridge asks carrier providers about a number, whose account each lookup uses, what a lookup returns, and how the result reaches the ingest pipeline.

  • Signal Scoring & Threat Models

    How a signal is classified, what revocation follows, how agent trust scores move, and how events are clustered.

  • Revocation and scoped responses

    Scoped security responses, ordered receipts, the policy matrix, hosted-RP freezes and step-up, and legacy caller boundaries.

  • Edge-First Signal Verification

    What the Cloudflare Worker in front of api.passkeybridge.io does, which headers it forwards, and which checks run at the origin.

Playbooks

Automated threat response orchestration.

  • Playbooks

    How a playbook matches a signal, what each of the 13 action types changes, and how to build one in the dashboard.

  • Playbook Recipes

    Ready-made playbook configurations for SIM swap, takeover, credential leak and port-out, with what each action actually changes.

Passkeys

WebAuthn/FIDO2 passkey lifecycle management.

  • Passkeys (WebAuthn / FIDO2)

    Register, authenticate and manage WebAuthn passkeys: nine actions on one console-only function, a fixed relying party and single-use challenges.

  • Passkey UX Patterns

    The passkey surfaces PasskeyBridge ships, the strings they show, the errors they map, and which patterns are advice rather than shipped behavior.

Verifiable Credentials

W3C VC issuance, verification, and revocation.

  • Verifiable Credentials

    Issue, verify, present, and revoke W3C Verifiable Credentials using PasskeyBridge's self-hosted VC engine with hybrid post-quantum signatures.

  • OID4VCI Credential Issuance

    OpenID for Verifiable Credential Issuance (OID4VCI) Pre-Authorized Code flow—credential offers, token exchange, format negotiation, and wallet integration.

  • Presentation Exchange (OpenID4VP)

    Request, present, and verify credentials using OpenID for Verifiable Presentations and Presentation Exchange 2.0.

  • StatusList2021 & Revocation

    Revoke, suspend, and reinstate credentials using W3C StatusList2021 bitstrings.

  • Deterministic Cross-Reference Binding

    Binding SIM signal hashes, VC subject hashes, and passkey credential IDs into a single auditable trust chain.

  • VC Wallet SDK Quickstart

    Install @passkeybridge/vc-wallet-sdk, issue your first JWT-VC, verify a presentation, and check revocation status from any fetch-capable runtime.

  • eIDAS 2.0 & EUDI Wallet Binding

    How PasskeyBridge binds carrier-attestation signals to Verifiable Credential subjects for EUDI Wallet interoperability under eIDAS 2.0, without storing PII.

Agentic Delegation

AI agent identity delegation and trust scoring.

  • Agent identity delegation

    Scoped, time-bound delegates for AI agents: create, verify and revoke one, how trust scoring narrows its scopes, and each endpoint's auth lane.

  • A2A Trust Negotiation

    The agent-to-agent handshake: eight actions, five attestation checks, the trust coefficient, transaction limit tiers, signed step proofs and cache rules.

  • Agent monitoring and guardrails

    How agent delegate behavior is scored: the seven signals, when evaluation runs, how scopes narrow and restore, what is recorded, and the Agents tab.

Security & Cryptography

PQC, BLAST tunnels, entropy, and key management.

  • Security & Cryptography

    Production cryptography: hybrid ECDSA and ML-DSA signatures, BLAST tunnels, the quantum-seeded DRBG, per-tenant keys, rotation and encryption at rest.

  • BLAST Protocol—Biometric-Linked Asymmetric Session Tunnels

    The BLAST tunnel protocol: X25519 key agreement, optional hybrid ML-KEM-768, HKDF-SHA-256 key derivation, AES-256-GCM encryption and session lifecycle.

  • Purpose-Bound PII Vault

    The shared PII vault: AES-256-GCM at rest, just-in-time decryption for a declared purpose, the decryption audit log, and the console-only migration tool.

  • Zero-PII Compliance Guide

    How the zero-PII data model maps to GDPR, CCPA and CPRA, SEC Regulation S-ID and SOC 2 readiness evidence, with the mechanism behind each row.

  • DSAR Workflows—Access & Erasure

    GDPR Art. 15 access and Art. 17 erasure requests: the export pipeline, the tombstoning erasure path, request tracking, and the dashboard UI.

  • PII Vault Access Patterns

    Using the PII vault: decryption helpers, purpose policies in the dashboard, the decryption audit log, and the console-only migration in Settings.

  • Clock sync over HTTPS

    The unauthenticated shield-ntp endpoint: server time, client drift measurement, the two tolerance modes and where each one is actually enforced.

  • Post-Quantum Cryptography Migration Guide

    Hybrid post-quantum signing in practice: the two constructions, ML-DSA seed derivation, what pqc_enabled and pqc_level control, and the ML-DSA-87 add-on.

  • Tenant signing keys and rotation

    Per-organization ECDSA signing keys: platform-generated and BYOK provisioning, curve tiers, manual rotation with a 24-hour grace window, and checks.

  • Account-name backfill and legacy PII coverage

    Manual account-name preservation and cleanup: service authorization, exact-count preview, conflict checks, encrypted membership labels and legacy coverage.

  • Provenance Guard

    How Provenance Guard checks that a request comes from enrolled hardware: a sensor fingerprint, a kinematic handshake and a second device's quorum attestation.

  • Recursive Entropy Chaining

    A design for identity continuity across hardware replacement. One minimal action ships: pg_succession records an unsigned succession token.

  • Shadow Identity Proxy

    Ephemeral legacy-format identifiers issued from a keyed-hashed subject, resolvable over TLS or through a BLAST tunnel, and frozen by a hard signal.

  • Cached Trust Proofs

    Store a short-lived, encrypted proof of a completed verification and check it again later, including from a terminal that cannot reach the identity provider.

  • Topological Virtual Authenticator

    Patent application for a browser-resident virtual authenticator. No part of it is implemented; this page says what runs instead.

  • Purpose-bound PII vault design notes

    The design name, the parts that ship, and the per-tenant BYOK and cryptographic-erasure parts that were design intent only. See the PII vault guide.

  • Identity Settlement Tokens

    A patent application with no implementation. What the page describes is not built; the nearest shipped capability is spatial binding, documented here.

  • DPoP: Demonstrating Proof of Possession (RFC 9449)

    Bind OAuth access tokens to client-held asymmetric key pairs to prevent token theft, replay, and AiTM session hijacking.

  • Supply Chain Provenance (SLSA/Sigstore)

    SLSA scoring of in-toto build statements, Sigstore bundle fields recorded as submitted, and CycloneDX SBOM ingestion, on the Enterprise plan.

  • Client-Side SDK Integrity Attestation

    Six client-side checks the SDK runs on itself, scored server-side and stored per session for the SDK integrity tab.

  • Breakglass emergency access

    Multi-party approved emergency access on Enterprise: severities, approval thresholds, the recorded scope list, the session states and the audit trail.

  • Cross-organization threat sharing

    An opt-in indicator pool on Enterprise: the five actions, the three-reporter floor, how every indicator is keyed before it is stored, and the tab.

  • Insider Threat Behavioral Analytics

    27-category anomaly detection engine covering human admin behavior and autonomous agent/A2A threats.

  • Identity Recovery (M-of-N Guardian Flow)

    Guardian approval, recovery states, the owner safety delay and veto, registering a replacement dashboard passkey, and legacy behavior and rollout boundaries.

Integrations

SSO, SCIM, Okta, and webhook configuration.

Observability

Metrics, alerting, and audit logging.

API Reference

Complete endpoint documentation.

  • API Reference

    Every endpoint at api.passkeybridge.io/v1: its auth lane, request and response shape, what it refuses, and the dashboard-only functions not routed there.

  • Error Codes & Troubleshooting

    The HTTP statuses, x-pb-reason headers and structured codes PasskeyBridge returns, what each one means, and how to trace a failed request.

  • Replay Protection and Rate Limiting

    Nonce consumption on agent-to-agent handshakes, the clock tolerances each endpoint applies, and how a replay refusal differs from a rate-limit refusal.

  • Rate Limits & Quotas Reference

    The four ceilings that can refuse a request, the plan and quota numbers behind them, the three 429 shapes, and how to tell them apart.

  • Billing, Plans & Usage Reporting

    Plans, prices and included volume, how Stripe events drive entitlement, how Enterprise overage is invoiced, and what happens while a plan is unpaid.