Skip to main content

Module federation_entity

Module federation_entity 

Source
Expand description

OpenID Federation 1.0 entity configuration endpoint.

Publishes GET /.well-known/openid-federation — a signed JWT (entity-statement+jwt) that makes this hyprstream node discoverable in OpenID Federation-aware networks.

This is a purely additive step: existing trusted_issuers-based federation continues to work unchanged. The entity configuration is a prerequisite for future trust-chain resolution (Step 13, deferred).

§Entity configuration JWT

  • Header: {"alg":"EdDSA","typ":"entity-statement+jwt"}
  • iss / sub: the node’s issuer URL (self-issued — both equal)
  • iat / exp: now / now + 24h
  • jwks: the node’s Ed25519 verifying key as OKP JWK
  • metadata.oauth_authorization_server: RFC 8414 AS metadata fields
  • authority_hints: Trust Anchor URLs from config (empty if none configured)

Functions§

build_entity_configuration
Build and sign an OpenID Federation 1.0 entity configuration JWT.
build_entity_configuration_jwt
Build the signed OpenID Federation 1.0 entity-configuration JWT for this AS, suitable for serving at /.well-known/openid-federation OR publishing to DiscoveryService.
build_entity_configuration_with_keys
Build and sign an entity configuration JWT with an explicit set of JWKS keys.
entity_configuration
GET /.well-known/openid-federation — OpenID Federation 1.0 entity configuration
publish_entity_statement_to_discovery
Phase 0.5 Stage D — publish this AS’s signed entity statement to the federation directory (DiscoveryService).