HSTS
필수 의존성: io.ktor:ktor-server-hsts
코드 예제: ssl-engine-main-hsts
네이티브 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✅
HSTS 플러그인은 RFC 6797에 따라 요청에 필요한 HTTP Strict Transport Security 헤더를 추가합니다. 브라우저가 HSTS 정책 헤더를 수신하면, 지정된 기간 동안 더 이상 안전하지 않은 연결로 해당 서버에 연결을 시도하지 않습니다.
안전하지 않은 HTTP 연결에서는 HSTS 정책 헤더가 무시됩니다. HSTS가 적용되려면 보안 연결을 통해 제공되어야 합니다.
의존성 추가
HSTS을(를) 사용하려면 빌드 스크립트에 ktor-server-hsts 아티팩트를 추가합니다.
implementation(ktorLibs.server.hsts)implementation ktorLibs.server.hsts<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-hsts-jvm</artifactId>
<version>${ktor_version}</version>
</dependency>HSTS 설치
애플리케이션에 HSTS 플러그인을 설치하려면, 지정된 모듈모듈을 사용하면 라우트를 그룹화하여 애플리케이션의 구조를 설계할 수 있습니다.의 install 함수에 전달합니다. 다음 예제는 HSTS을 설치하는 방법을 보여줍니다.
embeddedServer()함수 호출 내부에서 설치.Application클래스에 명시적으로 정의된module()확장 함수 내부에서 설치.
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.plugins.hsts.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(HSTS)
// ...
}.start(wait = true)
}import io.ktor.server.application.*
import io.ktor.server.plugins.hsts.*
// ...
fun Application.module() {
install(HSTS)
// ...
}HSTS 플러그인은 특정 라우트에 설치할 수도 있습니다. 애플리케이션의 리소스별로 서로 다른 HSTS 설정이 필요한 경우에 유용합니다.
HSTS 구성
HSTS은 HSTSConfig를 통해 설정을 제공합니다. 아래 예제는 클라이언트가 알려진 HSTS 호스트 목록에 해당 호스트를 유지해야 하는 기간을 maxAgeInSeconds 프로퍼티로 지정하는 방법을 보여줍니다.
install(HSTS) {
maxAgeInSeconds = 10
}withHost를 사용하여 호스트별로 서로 다른 HSTS 설정을 지정할 수도 있습니다.
install(HSTS) {
maxAgeInSeconds = 10
withHost("sample-host") {
maxAgeInSeconds = 60
includeSubDomains = false
}
}전체 예제는 ssl-engine-main-hsts에서 확인할 수 있습니다.
