Skip to content

Authentication

PRX supports multiple authentication mechanisms for LLM providers, API access, and inter-node communication. The auth system handles OAuth2 flows, API key management, and provider-specific authentication.

Overview

Authentication in PRX operates at multiple levels:

LevelMechanismPurpose
Provider authOAuth2 / API keysAuthenticate with LLM providers
Gateway authBearer tokensAuthenticate API clients
Node authEd25519 pairingAuthenticate distributed nodes

Provider Authentication

Each LLM provider has its own authentication method:

  • API key -- static key passed in request headers (most providers)
  • OAuth2 -- browser-based authorization flow (Anthropic, Google, GitHub Copilot)
  • AWS IAM -- role-based authentication for Bedrock

Configuration

toml
[auth]
default_method = "api_key"

[auth.oauth2]
redirect_port = 8400
token_cache_path = "~/.local/share/openprx/tokens"

Released under the Apache-2.0 License.