Samna

Appearance

Samna Auth Service ​

Centralized authentication hub providing OAuth2 login, JWT token issuance, and session management for the entire Samna ecosystem.

Overview ​

Samna Auth handles user login through OAuth providers (Google, Microsoft, GitHub), issues JWT tokens, and exposes a JWKS endpoint that all other services use to validate tokens locally. It manages users, organizations, locations, and claims-based access control through a web interface and REST API.

Data Flow ​

mermaid
flowchart LR
    U[User] -->|OAuth Login| A[Auth Service]
    A -->|JWT Token| U
    A -->|JWKS| B[Bookable Server]
    A -->|JWKS| S[Sync Service]
    A -->|JWKS| D[Device Manager]

Service Dependencies ​

  • Bookable Service (S3): Validates user tokens via JWKS for booking operations
  • Sync Service (S4): Validates user tokens via JWKS for sync operations
  • Device Manager (S9): Validates user tokens via JWKS for device management