Documentation

Build with PasskeyBridge.

Explore guides, API references, and architectural documentation for the Identity Threat Response platform. 16 patents pending.

All guides

77 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

    Three-pillar interaction model, request lifecycle data flow, shared module architecture, latency budget breakdown, cascade revocation mechanics, and multi-tenant isolation guarantees.

  • 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

Get up and running in under five minutes.

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, inbound and outbound signature policy, and how rotation actually works.

  • Scopes & Permissions

    The fourteen mintable API key scopes, what each function actually checks, the admin super-scope, and the separate scope systems used by agent delegates and A2A negotiations.

Identity Signals

Carrier signal ingestion and threat detection.

  • Identity Signals

    Signal types, the ingest request end to end, hard and soft classification, and what PasskeyBridge stores and sends on.

  • 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 queries Vonage and Twilio for carrier state, 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.

  • CASCADE Signal Classification

    The deterministic hard and soft classifier, and the four-subsystem revocation the shield-cascade endpoint runs.

  • 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 for PasskeyBridge accounts: nine actions on one console-only edge function, a fixed relying party, five-minute single-use challenges, and the hosted relying party for your own domain.

  • Passkey UX Patterns

    The passkey surfaces PasskeyBridge ships today, the exact strings they show, the error names they map, and which patterns are recommendations for your own application 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 identity delegates for AI agents: how to create, verify and revoke one, how behavioral trust scoring narrows its scopes, and which auth lane each endpoint answers on.

  • A2A Trust Negotiation

    The agent-to-agent handshake as implemented: seven actions on one endpoint, the five attestation checks, the combined trust coefficient formula, transaction limit tiers, cache renewal and hard-signal invalidation.

  • Agent monitoring and guardrails

    How PasskeyBridge scores agent delegate behavior: the seven signals it detects, when evaluation actually runs, how scopes narrow and restore, what activity recording stores, and what the Agents tab shows.

Security & Cryptography

PQC, BLAST tunnels, entropy, and key management.

  • Security & Cryptography

    The cryptographic architecture in production: hybrid ECDSA and ML-DSA signatures, BLAST session tunnels, the quantum-seeded DRBG, per-tenant keys and rotation, encryption at rest, and what is still roadmap.

  • BLAST Protocol—Biometric-Linked Asymmetric Session Tunnels

    The BLAST tunnel protocol in detail: X25519 ECDH key agreement, HKDF-SHA-256 session key derivation, AES-256-GCM tunnel encryption, stateless session persistence, and lifecycle management.

  • Purpose-Bound PII Vault

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

  • Zero-PII Compliance Guide

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

  • DSAR Workflows—Access & Erasure

    Data Subject Access Request workflows for GDPR Art. 15 (Right to Access) and Art. 17 (Right to Erasure). Covers the export pipeline, cryptographic shredding implementation, request lifecycle tracking, and the dashboard UI.

  • PII Vault Access Patterns

    Using the PII vault day to day: the decryption helpers, purpose policies in the dashboard, reading the decryption audit log, and running the console-only migration from 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

    The hybrid post-quantum architecture in practice: the two signing constructions, deterministic ML-DSA seed derivation, what the pqc_enabled toggle and the pqc_level tier each control, and the ML-DSA-87 add-on.

  • Tenant signing keys and rotation

    Per-organization ECDSA signing keys: platform-generated and BYOK provisioning through shield-admin-mutations, the curve tiers, manual rotation with a 24-hour grace window, and how to confirm one ran.

  • Bulk PII Migration—Encrypting & Shredding Legacy Columns

    Console-only tooling that encrypts legacy plaintext columns into the PII vault and, once coverage is complete, permanently nulls the plaintext originals.

  • Provenance Guard (PBPG)

    Console-only three-channel device verification: sensor fingerprint, kinematic handshake, and a quorum attestation from a second enrolled device.

  • Recursive Entropy Chaining (PBREC)

    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 (PBANCHOR)

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

  • PBPBV Design Notes

    The PBPBV design name, the parts of it that ship, and the per-tenant BYOK and cryptographic-erasure parts that were design intent only. The working reference is the PII vault guide.

  • Identity Settlement Tokens (PIST)

    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 and approval thresholds, the recorded scope list, the session state machine, and the audit evidence it produces.

  • Cross-organization threat sharing

    An opt-in shared pool of indicators on Enterprise: the four actions, the three-reporter floor, what the platform does and does not do about hashing, and the dashboard 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)

    Reference for the social recovery flow: guardian lifecycle, threshold semantics, atomic approval, and the security guarantees enforced in shield-recovery.

Integrations

SSO, SCIM, Okta, and webhook configuration.

Observability

Metrics, alerting, and audit logging.

API Reference

Complete endpoint documentation.

  • API Reference

    Every endpoint reachable at api.passkeybridge.io/v1: the auth lane it takes, its request and response shape, what it refuses, and the dashboard-only functions that are 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 reaches an invoice, and what happens while a subscription is unpaid.