Ktor Client의 다이제스트 인증
필수 의존성: io.ktor:ktor-client-auth
코드 예제: client-auth-digest
다이제스트 인증(Digest authentication) 스키마에서는 사용자 이름과 비밀번호를 네트워크를 통해 전송하기 전에 해시 함수를 적용합니다.
서버 측에서 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응답 헤더를 사용합니다. 일반적인WWW-Authenticate헤더는 다음과 같습니다:WWW-Authenticate: Digest realm="Access to the '/' path", nonce="e4549c0548886bc2", algorithm="MD5"일반적으로 클라이언트는 사용자가 자격 증명(credentials)을 입력할 수 있는 로그인 대화 상자를 표시합니다. 그런 다음 클라이언트는 다음과 같은
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 스키마를 사용하여 Authorization 헤더에 사용자 자격 증명을 보내려면 다음과 같이 digest 인증 제공자(provider)를 구성해야 합니다:
install블록 내부에서 digest 함수를 호출합니다.- DigestAuthCredentials를 사용하여 필요한 자격 증명을 제공하고, 이 객체를 credentials 함수에 전달합니다.
- 선택적으로
realm프로퍼티를 사용하여 렐름(realm)을 구성합니다.
val client = HttpClient(CIO) {
install(Auth) {
digest {
credentials {
DigestAuthCredentials(username = "jetbrains", password = "foobar")
}
realm = "Access to the '/' path"
}
}
}전체 예제는 여기에서 확인할 수 있습니다: client-auth-digest.
