Ktor Client 中的基本身份验证
必需的依赖项:io.ktor:ktor-client-auth
代码示例: client-auth-basic
基本身份验证方案可用于用户登录。在该方案中,用户凭据以经过 Base64 编码的用户名/密码对形式进行传输。
在服务器端,Ktor 提供了 Authentication 插件来处理基本身份验证。
添加依赖项
要启用身份验证,请在构建脚本中包含 ktor-client-auth 构件:
implementation(ktorLibs.client.auth)implementation ktorLibs.client.auth<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-client-auth-jvm</artifactId>
<version>${ktor_version}</version>
</dependency>基本身份验证流程
基本身份验证流程如下:
客户端在不带
Authorization标头的情况下向服务器应用程序中的受保护资源发出请求。服务器以
401 Unauthorized响应状态进行响应,并使用WWW-Authenticate响应标头指示需要 Basic 身份验证。典型的WWW-Authenticate标头如下所示:WWW-Authenticate: Basic realm="Access to the '/' path", charset="UTF-8"Ktor 客户端允许您通过使用
sendWithoutRequest()函数抢先发送凭据,而无需等待WWW-Authenticate标头。客户端通常会提示用户输入凭据。随后,它会发起附带
Authorization标头的请求,其中包含经过 Base64 编码的用户名和密码对,例如:Authorization: Basic amV0YnJhaW5zOmZvb2Jhcg服务器验证客户端发送的凭据并返回所请求的内容。
配置基本身份验证
要使用 Basic 方案在 Authorization 标头中发送用户凭据,您需要配置 basic 身份验证提供程序:
在
install(Auth)代码块中调用basic函数。使用
BasicAuthCredentials提供所需凭据,并将此对象传递给credentials函数。使用
realm属性配置 realm。kotlinval client = HttpClient(CIO) { install(Auth) { basic { credentials { BasicAuthCredentials(username = "jetbrains", password = "foobar") } realm = "Access to the '/' path" } } }(可选)使用
sendWithoutRequest函数启用抢先式身份验证,该函数会检查请求参数并决定是否将凭据附加到初始请求中。kotlininstall(Auth) { basic { // ... sendWithoutRequest { request -> request.url.host == "0.0.0.0" } } }(可选)禁用凭据缓存。默认情况下,
credentials {}提供程序返回的凭据会被缓存,以便在各请求之间重用。您可以通过cacheTokens选项禁用缓存:kotlinbasic { cacheTokens = false // 针对每次请求重新加载凭据 // ... }当凭据可能在客户端会话期间发生变化或必须反映最新的存储状态时,禁用缓存非常有用。
有关以编程方式清除已缓存凭据的详细信息,请参阅常规的令牌缓存与缓存控制部分。
有关 Ktor Client 中基本身份验证的完整示例,请参阅 client-auth-basic。
