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.
- Quickstart: ingest your first signal
Generate an API key, send a signal to the ingest endpoint, read the response, and make a playbook act on it.
- Environment Setup
Set up a development environment against the hosted API: the SDK, a sandbox key, a verified ingest call, and the errors you will meet first.
- DPoP shadow telemetry
What the DPoP shadow log records, how to read adoption, and what enforcement looks like today.
- Configure an SSF and CAEP receiver stream
Configure a receiver stream, promote it so inbound Security Event Tokens are accepted, and confirm a delivery landed.
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.
- Integrations: SSO, SCIM, Event Hooks and webhooks
How identity and security tools connect: SCIM 2.0 provisioning, Okta Event Hooks, signal ingest, outbound webhooks, and where SSO lives.
- Okta SCIM Provisioning
Set up SCIM 2.0 and Okta Event Hooks: connection settings, attributes, group-to-role push, the provisioning log, and the account rule it depends on.
- Webhook Configuration
Inbound and outbound webhooks: HMAC-SHA-256 signature checks, the four-attempt retry model, post-quantum proof headers, payloads and the delivery log.
- Okta Identity Security Posture Management (ISPM)
Console-only posture scanning for an Okta org: 25 weighted checks in nine categories, run from the dashboard Posture tab and scored 0-100.
- Microsoft Entra ID Identity Security Posture Management (ISPM)
Console-only posture scanning for a Microsoft Entra ID tenant: 25 weighted Graph checks in ten categories, run from the Posture tab and scored 0-100.
- Google Workspace Identity Security Posture Management (ISPM)
Console-only posture scanning for a Google Workspace domain: 25 weighted Admin SDK checks in nine categories, run from the Posture tab, scored 0-100.
- AWS IAM Identity Center Identity Security Posture Management (ISPM)
Console-only posture scanning for AWS IAM Identity Center: 25 weighted permission-set and Identity Store checks, run from the Posture tab, scored 0-100.
- PingOne (Ping Identity) Identity Security Posture Management (ISPM)
Console-only posture scanning for a PingOne environment: 25 weighted Management API checks in nine categories, run from the Posture tab, scored 0-100.
- CyberArk Identity Security Posture Management (ISPM)
Posture scanning for a CyberArk Identity tenant: 25 weighted checks in six categories, run from the dashboard Posture tab and scored 0 to 100.
- OneLogin Identity Security Posture Management (ISPM)
Console-only posture scanning for a OneLogin account: 25 weighted Admin API checks in eight categories, run from the dashboard Posture tab and scored 0-100.
- ISPM Cross-Provider Comparison
The eight PasskeyBridge posture modules side by side: credentials, check counts, categories, scoring, and the gaps in each provider's coverage.
- SSE/CAEP: Shared Signals & Continuous Access Evaluation
PasskeyBridge as a Shared Signals transmitter and receiver: stream setup, verifying a receiver stream, the SET contract, subject hashing, CAEP mapping.
- Connect PasskeyBridge to Claude
Add the read-only PasskeyBridge MCP connector to Claude, approve it with an administrator passkey, what each tool returns, and how to revoke it.
- Self-Serve SAML SSO Setup
Register a SAML provider, prove a domain by DNS TXT record or emailed token, and turn on federation from the dashboard, with the state of sign-in today.
- SAML SSO Domain Verification Reference
Self-serve SAML reference: the three tables, two verification methods, what the audit trail records, the public lookup contract and enforced properties.
- CAEP Outbound Transmitter (RFC 8935 Push Delivery)
How Security Event Tokens are signed and pushed to receivers: the queue, ES256 and ES384 per-tenant keys, the post-quantum proof, retries and dead letters.
Observability
Metrics, alerting, and audit logging.
- Observability: metrics, alerting and the audit log
Tenant metrics and anomaly detection, threshold alert rules dispatched to Slack, PagerDuty, OpsGenie or a webhook, the audit log, and the webhook delivery log.
- CISO compliance report
One request that aggregates audit, data-subject, incident, credential, vault, binding, proof and entropy counts for a period, with explicit truncation flags.
- Alert thresholds and cooldowns
Threshold alert rules for shield-alerting: the five metrics, rule fields and validation, the five-minute sweep, cooldowns, history and acknowledgement.
- Alert channels: Slack, PagerDuty, OpsGenie and webhooks
The four alert channel types, what each receives, how dispatch failures are reported, testing a channel, and composing escalation from several rules.
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.