Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

Server Plugin

Ktor 서버의 SSL 및 인증서

필수 의존성: io.ktor:ktor-network-tls-certificates

코드 예시: ssl-engine-main, ssl-embedded-server

대부분의 경우, Ktor 서비스는 Nginx 또는 Apache와 같은 리버스 프록시 뒤에 배치됩니다. 이는 리버스 프록시 서버가 SSL을 포함한 보안 문제를 처리한다는 것을 의미합니다.

필요한 경우, 인증서 경로를 제공하여 Ktor가 SSL을 직접 제공하도록 구성할 수 있습니다. Ktor는 인증서를 위한 저장소 시설로 Java KeyStore (JKS)를 사용합니다. keytool을 사용하여 KeyStore에 저장된 인증서를 변환하고 관리할 수 있습니다. 이는 인증 기관에서 발급한 PEM 인증서를 Ktor에서 지원하는 JKS 형식으로 변환해야 할 때 유용할 수 있습니다.

Ktor로 https:// 및 wss:// 요청을 처리하기 위한 무료 인증서를 얻으려면 _Let's Encrypt_를 사용할 수 있습니다.

자체 서명 인증서 생성 ​

코드로 인증서 생성 ​

Ktor는 테스트 목적으로 자체 서명 인증서를 생성할 수 있는 기능을 제공하며, 이는 buildKeyStore 함수를 호출하여 KeyStore 인스턴스를 반환합니다. 이 함수를 사용하려면 빌드 스크립트에 ktor-network-tls-certificates 아티팩트를 추가해야 합니다.

Kotlin
Groovy
XML

아래 코드 스니펫은 인증서를 생성하고 키스토어 파일에 저장하는 방법을 보여줍니다.

kotlin
private fun ApplicationEngine.Configuration.envConfig() {

    val keyStoreFile = File("build/keystore.jks")
    val keyStore = buildKeyStore {
        certificate("sampleAlias") {
            password = "foobar"
            domains = listOf("127.0.0.1", "0.0.0.0", "localhost")
        }
    }
    keyStore.saveToFile(keyStoreFile, "123456")
}

Ktor는 시작할 때 인증서를 필요로 하므로, 서버를 시작하기 전에 인증서를 생성해야 합니다. 전체 예시는 여기에서 찾을 수 있습니다: ssl-embedded-server.

keytool을 사용하여 인증서 생성 ​

keytool을 사용하여 자체 서명 인증서를 생성할 수 있습니다.

Bash
keytool -keystore keystore.jks -alias sampleAlias -genkeypair -keyalg RSA -keysize 4096 -validity 3 -dname 'CN=localhost, OU=ktor, O=ktor, L=Unspecified, ST=Unspecified, C=US'

이 명령을 실행하면 keytool은 키스토어 비밀번호를 지정하도록 제안한 다음 JKS 파일을 생성합니다.

PEM 인증서를 JKS로 변환 ​

인증 기관이 PEM 형식으로 인증서를 발급하는 경우, Ktor에서 SSL을 구성하기 전에 JKS 형식으로 변환해야 합니다. 이를 위해 openssl 및 keytool 유틸리티를 사용할 수 있습니다. 예를 들어, key.pem 파일에 개인 키가 있고 cert.pem에 공개 인증서가 있다면, 변환 과정은 다음과 같습니다.

  1. openssl을 사용하여 PEM을 PKCS12 형식으로 변환하려면 다음 명령을 사용합니다.

    Bash
    openssl pkcs12 -export -in cert.pem -inkey key.pem -out keystore.p12 -name "sampleAlias"

    key.pem에 대한 암호와 keystore.p12에 대한 새 비밀번호를 입력하라는 메시지가 표시됩니다.

  2. keytool을 사용하여 PKCS12를 JKS 형식으로 변환합니다.

    Bash
    keytool -importkeystore -srckeystore keystore.p12 -srcstoretype pkcs12 -destkeystore keystore.jks

    keystore.p12 파일에 대한 비밀번호와 keystore.jks에 대한 새 비밀번호를 입력하라는 메시지가 표시됩니다. keystore.jks가 생성됩니다.

Ktor에서 SSL 구성 ​

Ktor에서 SSL 설정을 지정하는 방법은 Ktor 서버를 구성하는 방법에 따라 달라집니다: 구성 파일을 사용하거나 embeddedServer 함수를 사용하여 코드에서 구성하는 방식입니다.

구성 파일 ​

서버가 application.conf 또는 application.yaml 구성 파일에 구성된 경우, 다음 속성을 사용하여 SSL을 활성화할 수 있습니다.

  1. ktor.deployment.sslPort 속성을 사용하여 SSL 포트를 지정합니다.

    shell
    ktor {
    deployment {
        sslPort = 8443
    }
}
    yaml
    ktor:
    deployment:
        sslPort: 8443

  2. 별도의 security 그룹에 키스토어 설정을 제공합니다.

    shell
    ktor {
    security {
        ssl {
            keyStore = keystore.jks
            keyAlias = sampleAlias
            keyStorePassword = foobar
            privateKeyPassword = foobar
        }
    }
}
    yaml
    ktor:
    security:
        ssl:
            keyStore: keystore.jks
            keyAlias: sampleAlias
            keyStorePassword: foobar
            privateKeyPassword: foobar

전체 예시는 ssl-engine-main을 참조하십시오.

embeddedServer ​

embeddedServer 함수를 사용하여 서버를 실행하는 경우, ApplicationEngine.Configuration에서 사용자 지정 환경을 구성하고 sslConnector를 사용하여 SSL 설정을 제공해야 합니다.

kotlin
import io.ktor.network.tls.certificates.*
import io.ktor.server.application.*
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.response.*
import io.ktor.server.routing.*
import org.slf4j.*
import java.io.*
import java.security.KeyStore

fun main() {
    embeddedServer(Netty, applicationEnvironment { log = LoggerFactory.getLogger("ktor.application") }, {
        envConfig()
    }, module = Application::module).start(wait = true)
}

private fun ApplicationEngine.Configuration.envConfig() {

    val keyStoreFile = File("build/keystore.jks")
    val keyStore = buildKeyStore {
        certificate("sampleAlias") {
            password = "foobar"
            domains = listOf("127.0.0.1", "0.0.0.0", "localhost")
        }
    }
    keyStore.saveToFile(keyStoreFile, "123456")

    connector {
        port = 8080
    }
    sslConnector(
        keyStore = keyStore,
        keyAlias = "sampleAlias",
        keyStorePassword = { "123456".toCharArray() },
        privateKeyPassword = { "foobar".toCharArray() }) {
        port = 8443
        keyStorePath = keyStoreFile
    }
}

전체 예시는 ssl-embedded-server를 참조하십시오.

Copyright © 2025 Open AIDoc.