Skip to content

Ktor Client의 다이제스트 인증 ​

필수 의존성: io.ktor:ktor-client-auth

코드 예제: client-auth-digest

다이제스트 인증(Digest authentication) 스키마에서는 사용자 이름과 비밀번호를 네트워크를 통해 전송하기 전에 해시 함수를 적용합니다.

서버 측에서 Ktor는 다이제스트 인증을 처리하기 위한 Authentication 플러그인을 제공합니다.

의존성 추가 ​

인증을 활성화하려면 빌드 스크립트에 ktor-client-auth 아티팩트를 포함합니다:

kotlin
implementation(ktorLibs.client.auth)
위의 코드 스니펫은 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.
groovy
implementation ktorLibs.client.auth
위의 코드 스니펫은 Ktor 의존성을 지정하기 위해 Ktor 버전 카탈로그를 사용합니다.
xml
<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-client-auth-jvm</artifactId>
    <version>${ktor_version}</version>
</dependency>
Ktor 클라이언트에 필요한 아티팩트에 대해 자세히 알아보려면 클라이언트 의존성 추가기존 프로젝트에 클라이언트 의존성을 추가하는 방법을 알아봅니다.를 참고하세요.

다이제스트 인증 흐름 ​

다이제스트 인증 흐름은 다음과 같습니다:

  1. 클라이언트가 서버 애플리케이션의 특정 리소스에 Authorization 헤더 없이 요청을 보냅니다.

  2. 서버는 클라이언트에 401 (Unauthorized) 응답 상태로 응답하며, 해당 경로를 보호하는 데 다이제스트 인증 스키마가 사용됨을 알리는 정보를 제공하기 위해 WWW-Authenticate 응답 헤더를 사용합니다. 일반적인 WWW-Authenticate 헤더는 다음과 같습니다:

    WWW-Authenticate: Digest
            realm="Access to the '/' path",
            nonce="e4549c0548886bc2",
            algorithm="MD5"
  3. 일반적으로 클라이언트는 사용자가 자격 증명(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)

  4. 서버는 클라이언트가 보낸 자격 증명을 검증하고 요청된 콘텐츠로 응답합니다.

다이제스트 인증 구성 ​

Digest 스키마를 사용하여 Authorization 헤더에 사용자 자격 증명을 보내려면 다음과 같이 digest 인증 제공자(provider)를 구성해야 합니다:

  1. install 블록 내부에서 digest 함수를 호출합니다.
  2. DigestAuthCredentials를 사용하여 필요한 자격 증명을 제공하고, 이 객체를 credentials 함수에 전달합니다.
  3. 선택적으로 realm 프로퍼티를 사용하여 렐름(realm)을 구성합니다.
kotlin
val client = HttpClient(CIO) {
    install(Auth) {
        digest {
            credentials {
                DigestAuthCredentials(username = "jetbrains", password = "foobar")
            }
            realm = "Access to the '/' path"
        }
    }
}

전체 예제는 여기에서 확인할 수 있습니다: client-auth-digest.