Ktor Client 中的 Digest 身份验证
必需依赖项:io.ktor:ktor-client-auth
代码示例: client-auth-digest
在 Digest 身份验证方案中,在通过网络发送用户名和密码之前,会先对其应用哈希函数。
在服务器端,Ktor 提供了 Authentication 插件来处理 Digest 身份验证。
添加依赖项
要启用身份验证,请在构建脚本中包含 ktor-client-auth 构件:
要了解更多关于 Ktor 客户端所需构件的信息,请参阅添加客户端依赖项了解如何向现有项目添加客户端依赖项。。
Digest 身份验证流程
Digest 身份验证流程如下:
客户端向服务器应用程序中的特定资源发送不带
Authorization标头的请求。服务器向客户端返回
401(Unauthorized) 响应状态,并使用WWW-Authenticate响应标头提供相关信息,指示该路由使用 Digest 身份验证方案进行保护。典型的WWW-Authenticate标头如下所示:WWW-Authenticate: Digest realm="Access to the '/' path", nonce="e4549c0548886bc2", algorithm="MD5"通常,客户端会显示一个供用户输入凭据的登录对话框。随后,客户端会发送带有以下
Authorization标头的请求:Authorization: Digest username="jetbrains", realm="Access to the '/' path", nonce="e4549c0548886bc2", uri="/", algorithm=MD5, response="6299988bb4f05c0d8ad44295873858cf"response值的生成方式如下:a.
HA1 = MD5(username:realm:password)b.
HA2 = MD5(method:digestURI)c.
response = MD5(HA1:nonce:HA2)服务器验证客户端发送的凭据,并返回请求的内容。
配置 Digest 身份验证
若要使用 Digest 方案在 Authorization 标头中发送用户凭据,需要按如下方式配置 digest 身份验证提供程序:
- 在
install块内调用 digest 函数。 - 使用 DigestAuthCredentials 提供所需的凭据,并将该对象传递给 credentials 函数。
- (可选)使用
realm属性配置 realm。
kotlin
val client = HttpClient(CIO) {
install(Auth) {
digest {
credentials {
DigestAuthCredentials(username = "jetbrains", password = "foobar")
}
realm = "Access to the '/' path"
}
}
}您可以在此处找到完整示例:client-auth-digest。
