
CVE-2026-111943 연구를 위한 소형 EC 개인 키용 OpenSSL s_server 테스트 도구입니다.
Alpine Linux와 OpenSSL s_server로 구동되는 경량의 자동화된 컨테이너 기반 테스트 도구로, 작은 정수를 타원 곡선 개인 키로 사용하여 테스트하기 위한 것입니다.
두 계층의 타원 곡선(EC) 인증서 체인(CA + 서버)을 생성하고, 사용자 지정 SAN 확장(IP 및 도메인 이름)으로 서버 인증서에 서명하며, 실행된 모든 OpenSSL 명령을 캡처하여 출력하고, -WWW 또는 -www 모드로 실행되는 동안 인증서와 키가 어떻게 생성되었는지 설명하는 실시간 HTML 보고서를 제공합니다.
fullchain.pem로 묶습니다.CHAIN_MODE=c1), 또는 사용 가능한 모든 경로의 조합(CHAIN_MODE=all)을 제공합니다.s 바이트 입력: EC 개인 키 스칼라 $s$를 16진수 문자열(예: 0xdeadbeef1337 또는 deadbeef...) 또는 작은 정수(예: 42)로 직접 받아들이며, 정확한 16진수 스칼라를 생성된 EC 개인 키에 포함시켜 openssl ec -text이 priv: 아래에 정확한 바이트를 표시하도록 합니다.S_BYTES, SERVER_S_BYTES, CA_S_BYTES.CA_CURVE, SERVER_CURVE, 또는 대체 CURVE (예: prime256v1, secp384r1, secp521r1).CA_SUBJECT 및 SERVER_SUBJECT.DOMAINS 및 IPS (쉼표 또는 공백으로 구분).WWW_MODE (WWW, www, HTTP).PORT (기본값 4433).fullchain.pem, tls.crt)과 개인 키가 /certs에 마운트되었는지 자동으로 감지하여, 해당 항목을 대신 제공합니다.openssl x509 -text -noout 및 openssl ec -text -noout)와 함께 실행된 모든 명령을 출력합니다. -WWW 모드에서 https://<host>:<port>/index.html을 방문하면 원클릭 PEM 파일 다운로드와 함께 이 전체 보고서가 렌더링됩니다.chart/)와 ArgoCD Application(argocd/).s 바이트(16진수)로 실행docker run -p 4433:4433 \
-e S_BYTES="0xdeadbeef1337" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
openssl ec -in server.key.pem -text -noout을 실행하면 개인 키 스칼라가 표시됩니다:
priv:
00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:
00:00:00:00:00:00:00:00:00:00:00:de:ad:be:ef:
13:37
s로 실행docker run -p 4433:4433 \
-e S_BYTES="42" \
-e DOMAINS="localhost,test.internal" \
-e IPS="127.0.0.1,192.168.1.100" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
docker run -p 4433:4433 \
-e SERVER_S_BYTES="0xdeadbeef" \
-e CA_S_BYTES="0x1337c0de" \
-e CA_CURVE="prime256v1" \
-e SERVER_CURVE="prime256v1" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
미리 생성된 인증서(예: Let's Encrypt 또는 Vault 인증서)가 있는 경우:
docker run -p 4433:4433 \
-v /path/to/my/certs:/certs:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
fullchain.pem(또는 tls.crt)와 privkey.pem(또는 tls.key / server.key)가 /certs에 존재하면, 컨테이너는 새로운 인증서를 생성하지 않고 이를 직접 검사하여 제공합니다.
키 $a$(서버, 스칼라 $s$)와 $b$(CA, 스칼라 $s+1$ 또는 CA_S_BYTES)가 결정적이기 때문에, 중간 키 $b$는 외부 루트 CA($c_1, c_2, \dots$)에 의해 미리 서명될 수 있거나, 시작 시 자동으로 서명되도록 루트를 마운트할 수 있습니다.
교차 서명된 체인 PEM을 /certs/chains/에 배치하십시오:
/certs/chains/c1.pem ($c_1$에 의해 서명된 $b$를 포함하며, 선택적으로 $c_1$ 포함)/certs/chains/c2.pem ($c_2$에 의해 서명된 $b$를 포함하며, 선택적으로 $c_2$ 포함)# Serve specific cross-signed path (a -> b_c1 -> c1)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="c1" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
# Serve all paths concatenated in fullchain.pem (a -> b_c1 + b_c2)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="all" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
볼륨 마운트 없이 CI/CD 또는 경량 실행을 위해:
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CHAIN_MODE="all" \
-e EXTRA_CHAIN_PEM="$(cat extra_chain.pem)" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
외부 루트 CA 인증서와 개인 키를 /certs/roots/에 마운트합니다:
/certs/roots/c1.crt 및 /certs/roots/c1.key부팅 시 컨테이너는 루트 $c_1$에 의해 서명된 키 $b$에 대한 중간 인증서를 자동으로 생성하고, 이를 CHAIN_MODE="c1" 또는 CHAIN_MODE="all"에서 사용할 수 있게 합니다.
-WWW 모드에서 HTML 보고서를 가져옵니다:
# Insecure (skip CA verification)
curl -k https://localhost:4433/index.html
# Download the generated CA certificate
curl -k -O https://localhost:4433/ca.crt.pem
# Secure request using the downloaded CA
curl --cacert ca.crt.pem https://localhost:4433/index.html
s_client터미널에서 인증서 체인에 연결하고 검사합니다:
openssl s_client -connect localhost:4433 -showcerts
| 변수 | 기본값 | 설명 |
|---|---|---|
S_BYTES / SERVER_S_BYTES | 차트 내 0x01 | 서버 EC 개인 키에 대한 정확한 정수(예: 1, 42) 또는 16진수 스칼라(0xdeadbeef...). |
CA_S_BYTES | 파생됨 ($s+1$) | CA EC 개인 키에 대한 정확한 정수 또는 16진수 스칼라. |
ROOTS / CHAINS | c1,c2 (차트 내) | 루트 CA / 체인 이름의 쉼표로 구분된 목록. 2~10개의 인그레스와 동반 포트를 자동으로 파생합니다(단일 체인은 all을 생략). |
ROOT_S_BYTES | 0x10,0x20 (차트 내) | 루트 CA에 대한 쉼표로 구분된 정확한 스칼라. |
CHAIN_MODE | default | 기본 체인 조립 모드: default ($a \rightarrow b$), <name>, 또는 all. |
CHAINS_DIR | /certs/chains | 사전 서명된 중간 또는 교차 체인 PEM 파일이 포함된 디렉터리. |
ROOTS_DIR | /certs/roots | 자동 중간 서명을 위한 루트 CA .crt 및 .key 쌍이 포함된 디렉터리. |
EXTRA_CHAIN_PEM | 비어 있음 | 중간 체인 조립에 포함할 원시 PEM 인증서 문자열. |
CHAIN_FILE | 비어 있음 | 포함할 특정 중간 체인 PEM 파일의 경로. |
WWW_MODE | WWW | openssl s_server에 대한 모드(WWW는 파일 제공, www은 내장 상태 페이지 제공, HTTP은 헤더 포함). |
PORT | 4433 | s_server가 수신 대기하는 TCP 포트. |
CA_CURVE | prime256v1 | CA 키에 대한 타원 곡선. |
SERVER_CURVE | prime256v1 | 서버 키에 대한 타원 곡선. |
CURVE | prime256v1 | CA와 서버 모두에 대해 개별적으로 설정되지 않은 경우 사용되는 대체 곡선. |
CA_SUBJECT | /CN=Test OpenSSL CA/O=Test Lab/C=CA | CA에 대한 X.509 주체. |
SERVER_SUBJECT | /CN=localhost/O=Test Lab/C=CA | 서버 인증서에 대한 X.509 주체. |
DOMAINS | tiny-key-s-server.jskw.dev,localhost | 쉼표 또는 공백으로 구분된 DNS SAN 목록. |
IPS | 127.0.0.1 | 쉼표 또는 공백으로 구분된 IP SAN 목록. |
CA_DAYS | 3650 | CA 인증서의 유효 기간(일 단위). |
SERVER_DAYS | 365 | 서버 인증서의 유효 기간(일 단위). |
CERTS_DIR | /certs | 마운트된 인증서와 키를 확인하는 디렉터리. |
EXTRA_S_SERVER_ARGS | 비어 있음 | openssl s_server에 직접 전달되는 추가 CLI 플래그. |
모든 테스트는 호스트 시스템을 수정하지 않고 임시 Docker 컨테이너 내에서 깔끔하게 실행되도록 설계되었습니다:
tests/test_scalar_s_bytes.sh: 스칼라 생성을 테스트하고 openssl ec -text이 정확한 사용자 16진수를 표시하는지 검증합니다.tests/test_chain_generation.sh: CA 생성, 서버 CSR 서명, SAN 주입 및 openssl verify을 테스트합니다.tests/test_s_server_behavior.sh: curl을 사용하여 -WWW 및 -www 응답 의미론을 테스트합니다.tests/test_volume_override.sh: 기존 인증서가 포함된 외부 볼륨 마운트를 테스트합니다.tests/test_full_docker_app.sh: 빌드된 이미지의 전체 엔드투엔드 통합 테스트입니다.tests/test_cross_signed_chains.sh: 중간 교차 서명($a \rightarrow b \rightarrow c_1 / c_2$) 및 다중 신뢰 앵커 클라이언트 검증을 테스트합니다.tests/test_chain_modes.sh: 런타임 CHAIN_MODE 경로 해석(default, 명명된 경로 c1, 및 all)을 테스트합니다.tests/test_multi_port_server.sh: 동적 다중 루트 파생(ROOTS=c1,c2), 동반 s_server 리스너, 그리고 단일 대 다중 체인 포트 할당을 테스트합니다.tests/run_all_tests.sh: 모든 테스트 스크립트를 조정합니다.