ktor-server-auth/io.ktor.server.auth/AuthenticationConfig

AuthenticationConfig

class AuthenticationConfig(providers: Map<String?, AuthenticationProvider> = emptyMap())

A configuration for the Authentication plugin.

Constructors

constructor(providers: Map<String?, AuthenticationProvider> = emptyMap())

Functions

basic

fun AuthenticationConfig.basic(name: String? = null, configure: BasicAuthenticationProvider.Config.() -> Unit)

Installs the basic Authentication provider. You can use basic authentication for logging in users and protecting specific routes. To learn how to configure it, see Basic authentication.

bearer

fun AuthenticationConfig.bearer(name: String? = null, configure: BearerAuthenticationProvider.Config.() -> Unit)

Installs the Bearer Authentication provider. Bearer auth requires the developer to provide a custom 'authenticate' function to authorize the token, and return the associated principal.

form

fun AuthenticationConfig.form(name: String? = null, configure: FormAuthenticationProvider.Config.() -> Unit)

Installs the form-based Authentication provider. Form-based authentication uses a web form to collect credential information and authenticate a user. To learn how to configure it, see Form-based authentication.

oauth

fun AuthenticationConfig.oauth(name: String? = null, configure: OAuthAuthenticationProvider.Config.() -> Unit)

Installs the OAuth Authentication provider. OAuth can be used to authorize users of your application by using external providers, such as Google, Facebook, Twitter, and so on. To learn how to configure it, see OAuth.

provider

fun provider(name: String? = null, configure: DynamicProviderConfig.() -> Unit)

Registers a provider with the specified name and allows you to configure it.

fun register(provider: AuthenticationProvider)

Registers the specified provider.

session

inline fun <T : Any> AuthenticationConfig.session(name: String? = null)

inline fun <T : Any> AuthenticationConfig.session(name: String? = null, noinline configure: SessionAuthenticationProvider.Config<T>.() -> Unit)

fun <T : Any> AuthenticationConfig.session(name: String? = null, kClass: KClass<T>)

fun <T : Any> AuthenticationConfig.session(name: String?, kClass: KClass<T>, configure: SessionAuthenticationProvider.Config<T>.() -> Unit)

Installs the session Authentication provider. This provider provides the ability to authenticate a user that already has an associated session.