Аутентификация и 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)
}