Перейти к основному содержимому

Аутентификация и OAuth 2.0

Редакция: OpenIDE Pro.

Basic и Bearer​

GET("$host/api/orders") { basicAuth("user", "pass") }
GET("$host/api/orders") { bearerAuth(myToken) }

OAuth 2.0: authorization code​

Объявление OAuth размещается на верхнем уровне скрипта:

val clientId: String by env
val clientSecret: String by env

val auth by oauth(
authorizeEndpoint = "$authHost/oauth/authorize",
clientId = clientId,
clientSecret = clientSecret,
scope = "openid profile",
tokenEndpoint = "$authHost/oauth/token",
redirectUri = "http://localhost:8080/callback"
)

GET("$host/api/protected") {
bearerAuth(auth.accessToken)
}

При первом запуске Connekt открывает браузер для входа и сам поднимает локальный сервер для обратного вызова. Объект auth даёт accessToken и refreshToken, полученный токен переиспользуется следующими запросами.

Keycloak​

Для Keycloak есть сокращённая форма без указания отдельных эндпоинтов:

val auth by oauth(
KeycloakOAuthParameters(
serverBaseUrl = keycloakHost,
realm = "my-realm",
protocol = "openid-connect",
clientId = "my-client",
clientSecret = "secret",
scope = "openid",
callbackPort = 8080,
callbackPath = "/callback"
)
)

Тем же способом работают Google и другие провайдеры OAuth 2.0 — им указываются собственные адреса авторизации и получения токена.

Общая настройка авторизации для нескольких скриптов​

Объявление OAuth выносится в отдельный скрипт и подключается импортом:

// auth_setup.connekt.kts
val host: String by env
val clientId: String by env
val clientSecret: String by env

val auth by oauth(
authorizeEndpoint = "$host/oauth/authorize",
clientId = clientId,
clientSecret = clientSecret,
scope = "openid",
tokenEndpoint = "$host/oauth/token",
redirectUri = "http://localhost:8080/callback"
)
// api_tests.connekt.kts
@file:Import("auth_setup.connekt.kts")

GET("$host/api/protected") {
bearerAuth(auth.accessToken)
} then {
assert(code == 200)
}