android/dev.kindling.android.http/KAuthProvider

KAuthProvider

Defines how authentication headers are injected into every outgoing request.

Pass an instance via KHttpConfig.authProvider. When null, no auth header is added automatically (useful for cookie-based auth or public APIs).

Built-in providers:

Bearer — Authorization: Bearer <token>
Jwt — alias of Bearer, explicit for readability
Basic — Authorization: Basic <base64(user:pass)>
ApiKey — custom header or Authorization: ApiKey <key>
Custom — full control via a lambda

Usage:

// Bearer / JWT
KHttpConfig(
    baseUrl      = "https://api.example.com/",
    authProvider = KAuthProvider.Bearer { tokenStore.getToken() },
)

// API key in custom header
KHttpConfig(
    baseUrl      = "https://api.example.com/",
    authProvider = KAuthProvider.ApiKey(header = "X-Api-Key") { "my-secret-key" },
)

// Custom
KHttpConfig(
    baseUrl      = "https://api.example.com/",
    authProvider = KAuthProvider.Custom { request ->
        request.header("X-Tenant-Id", "acme")
        request.header("X-Signature", computeSignature())
    },
)