Developer Section

Build Against Lighthouse.

Lighthouse answers two basic questions about every principal: who they are (Authentication) and what they may do (Authorization). Authentication checks in two ways. A discrete check (AuthN-D) looks at what the presenter holds at the moment they sign in, such as a credential, a passkey or a code. A continual check (AuthN-C) looks over time at whether the presenter still behaves like themselves. Every answer says which check gave it. Silicon agents duck-type as principals: the same two questions apply whether the caller is a person or code acting on their behalf.

Standards-Native

Built to Spec

No proprietary handshake. Every credential Lighthouse issues is a standards-track token any conformant client already understands.

OIDC Core 1.0
OpenID Connect
Authorization Code flow with ID tokens for humans and agents.
RFC 6749 · 7636
OAuth 2.0 + PKCE
Proof Key for Code Exchange is mandatory: S256 only, no plain.
RFC 8414 · 9728
AS Metadata
Discovery so any client auto-configures from the issuer alone.
RFC 8037
EdDSA JWKS
Ed25519-signed tokens; the public half published as a JWK Set.
RFC 7009 · 7662
Revoke + Introspect
A real kill-switch: revoke a token and it reads inactive at once.
RFC 7591
Dynamic Registration
Session-gated self-serve client registration with validated redirects.
Identity Claims

Key Users on Subject

Key your users on the sub claim, which is stable and unique per account. Never use email to identify a user or to grant access unless email_verified is true. Anyone can sign up with an address they do not own, and signing in never waits for verification, so an address without email_verified: true proves nothing about who holds it. Even then, a verified address proves only current control of the address, not a lasting identity: an address can later pass to a different account with a different sub. Bind durable accounts, permissions and invitations to sub, and use a verified email only for contact or a one-time check. Both claims appear in the ID token and at the userinfo endpoint when the email scope is granted, and email_verified is always a boolean.

HSM-Backed Signing

Token-signing keys live in a hardware security module and rotate by kid with no verifier-visible outage.

Client Libraries

SDKs and API Reference

TypeScript, Python, Rust, Swift, Kotlin and Go clients, generated from Lighthouse's own OpenAPI description (docs/specs/lighthouse/api-client-sdk-strategy.md) and never hand-coded against routes discovered by reading source.

TypeScript
@rainfall/lighthouse-api-ts
Typed client for every dispatch method and OpenID Connect endpoint.
Python
lighthouse-api-py
Python typed client for accessing Lighthouse capabilities.
Rust
lighthouse-api-rust
Rust typed client for accessing Lighthouse capabilities.
Swift
lighthouse-api-swift
Swift typed client for accessing Lighthouse capabilities.
Kotlin
lighthouse-api-kotlin
Kotlin typed client for accessing Lighthouse capabilities.
Go
lighthouse-api-go
Go typed client for accessing Lighthouse capabilities.
Try It

Sandbox

Coming Soon.