kairo-rest/kairo.rest.auth

Package-level declarations

Types

abstract class AuthConfig

Configures authentication for all REST endpoints in the Server.

class AuthReceiver<E : RestEndpoint<*, *>>

Provides the authentication context within an auth block. Use public for unauthenticated endpoints or verify for JWT-protected endpoints.

VerifierConfig

data class VerifierConfig(val jwkUrl: String, val issuer: String, val audience: String? = null, val claims: Map<String, String> = emptyMap(), val leeway: Duration)

Configuration for JWT verification using RSA256 with a JWKS endpoint.

Properties

authConfig

var Application.authConfig: AuthConfig?

koin

var Application.koin: Koin

Functions

public

fun AuthReceiver<*>.public()

Marks the endpoint as publicly accessible, skipping authentication.

verify

fun AuthReceiver<*>.verify(config: VerifierConfig): JWTPrincipal

Verifies the JWT from the request. Throws NoJwt if no token is present, ExpiredJwt if expired, or JwtVerificationFailed for other verification failures.