# testssl.sh로 내 서버의 TLS 설정 점검하기: 약한 서버와 고친 서버를 같은 기준으로 비교

> 일부러 약하게 만든 nginx와 고친 nginx를 컨테이너로 띄워 testssl.sh로 점검합니다. 프로토콜, 인증서, 취약점, 보안 헤더를 읽고, JSON 결과를 심각도로 집계해 CI 기준(종료 코드)까지 만들어 실행으로 확인합니다.

- 주소: https://copyandrun.com/blog/testssl-local-tls-check/
- 분야: DevSecOps
- 발행일: 2026-10-30
- 태그: testssl.sh, TLS, HTTPS, 인증서, nginx

HTTPS를 켰다고 해서 안전한 설정이라는 뜻은 아닙니다. 낡은 TLS 1.0이 아직 열려 있을 수도 있고, 인증서의 키가 너무 짧거나 서명이 SHA1일 수도 있습니다. testssl.sh는 서버에 접속해 이런 것들을 한꺼번에 확인해 주는 오픈소스 점검 도구입니다. 이 글에서는 일부러 약하게 만든 서버와 고친 서버를 내 컴퓨터의 컨테이너로 띄우고 같은 명령으로 점검해, 결과를 읽는 법과 CI에서 통과와 실패를 가르는 기준까지 실행해서 기록합니다. 점검 대상은 내가 띄운 컨테이너뿐이며, 남의 서버를 점검하는 일은 하지 않습니다. 이 점이 가장 중요합니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11, Git Bash에서 실행) |
| testssl.sh | 3.2.4 (`drwetter/testssl.sh` 이미지, 내장 OpenSSL 1.0.2-bad) |
| 서버 | `nginx:alpine`(nginx 1.31.8) 컨테이너 둘 |
| 교차 확인 | `alpine/openssl` 이미지의 `openssl s_client` |
| 파이썬 | 3.12 (JSON 집계용) |

모든 컨테이너는 전용 네트워크(`osk-tls`)에 두고 `bad.lab`, `good.lab`이라는 이름으로만 부릅니다. 바깥에는 포트를 열지 않았습니다.

## 1. 약한 서버와 고친 서버

두 서버의 차이는 인증서와 nginx 설정 몇 줄입니다.

| 항목 | 약한 서버(`bad.lab`) | 고친 서버(`good.lab`) |
|---|---|---|
| 인증서 키 | RSA 1024비트 | ECDSA P-256 |
| 서명 | SHA1 | SHA256 |
| SAN(대체 이름) | 없음(CN만) | `good.lab` |
| 유효 기간 | 30일 | 90일 |
| 프로토콜 | TLS 1.0, 1.1, 1.2 | TLS 1.2, 1.3 |
| 암호 목록 | `ALL:@SECLEVEL=0`(낡은 것까지 허용) | ECDHE와 GCM, ChaCha20만 |
| HSTS 헤더 | 없음 | `max-age=31536000` |

약한 서버의 핵심 설정은 이 두 줄입니다.

```nginx
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ALL:@SECLEVEL=0;
```

고친 서버는 이렇게 줄이고 헤더를 더합니다.

```nginx
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
add_header Strict-Transport-Security "max-age=31536000" always;
```

인증서는 `openssl req -x509`로 둘 다 자체 서명으로 만들었습니다. 파일 전체는 아래 "전체 코드"의 `nginx_bad.conf`, `nginx_good.conf`, `testssl_demo.sh`에 있습니다.

## 2. 다른 도구로 먼저 확인하기

<!-- files: testssl_demo.sh -->

점검 도구의 결과를 믿기 전에, 서버가 정말 그렇게 동작하는지 다른 도구로 한 번 봅니다. `openssl s_client`로 프로토콜을 하나씩 지정해 접속해 보았습니다.

| 서버 | TLS 1.0 | TLS 1.1 | TLS 1.2 | TLS 1.3 |
|---|---|---|---|---|
| 약한 서버 | 접속됨 | 접속됨 | 접속됨 | 거절 |
| 고친 서버 | 거절 | 거절 | 접속됨 | 접속됨(`TLS_AES_256_GCM_SHA384`) |

읽을 때 주의할 점이 한 가지 있습니다. TLS 1.1로 접속했을 때 `New, TLSv1.0`이라는 줄이 나왔는데, 이것은 암호 규격 표시이고 실제 프로토콜은 아래 `Protocol : TLSv1.1`줄에서 읽습니다. 약한 서버가 TLS 1.0과 1.1을 받아 주고 1.3은 받지 않는다는 것이 이 표로 확인되었습니다.

## 3. testssl.sh로 점검하기

<!-- files: testssl_demo.sh -->

이제 testssl.sh입니다. 프로토콜(`-p`)과 서버 인증서(`-S`)만 먼저 봅니다.

```bash
docker run --rm --network osk-tls drwetter/testssl.sh --color 0 --quiet --warnings off -p -S bad.lab:443
```

`--color 0`은 색 코드를 끄고, `--quiet`은 안내 배너를 줄이고, `--warnings off`는 확인 질문을 건너뜁니다. 약한 서버의 결과 중 중요한 줄만 추리면 이렇습니다.

```text
 TLS 1      offered (deprecated)
 TLS 1.1    offered (deprecated)
 TLS 1.2    offered (OK)
 TLS 1.3    not offered and downgraded to a weaker protocol
 Signature Algorithm          SHA1 with RSA -- besides: users will receive a strong browser WARNING
 Server key size              RSA 1024 bits (exponent is 65537)
 subjectAltName (SAN)         missing (NOT ok) -- Browsers are complaining
 Trust (hostname)             via CN only -- Browsers are complaining (same w/o SNI)
 Chain of trust               NOT ok (self signed)
 Certificate Validity (UTC)   expires < 30 days (29) (2026-10-29 16:50 --> 2026-11-28 16:50)
```

![testssl.sh로 약한 서버를 점검한 결과에서 TLS 1.0과 1.1이 offered (deprecated)로, 서명이 SHA1, 키가 RSA 1024비트, SAN이 없음, 자체 서명, 유효 기간 30일 미만으로 표시되는 것을 확인합니다.](https://copyandrun.com/img/testssl-local-tls-check/01-testssl-나쁜-서버.png)

고친 서버에서는 TLS 1과 1.1이 `not offered`, TLS 1.3이 `offered (OK): final`로 나오고, 서명은 `ECDSA with SHA256`, 키는 `EC 256 bits (curve P-256)`, SAN은 `good.lab`으로 나왔습니다. 약한 서버의 프로토콜 줄은 2번의 `openssl` 결과와 같습니다. 두 도구의 결과가 일치하므로 점검 결과를 믿고 읽을 수 있습니다.

## 4. 전체 검사: 취약점과 헤더까지

<!-- files: testssl_demo.sh -->

`-U`는 알려진 TLS 취약점을, `-h`는 HTTP 보안 헤더를 확인합니다. 같은 명령에 `--jsonfile`을 더하면 결과를 파일로 저장합니다.

```bash
docker run --rm --network osk-tls -v "$PWD/out:/data" drwetter/testssl.sh \
  --color 0 --quiet --warnings off -p -S -U -h --jsonfile /data/bad.json bad.lab:443
```

검사에는 약한 서버 43초, 고친 서버 29초가 걸렸습니다(처음 한 번은 35초와 23초였으므로 몇십 초 단위로 달라집니다). 취약점 항목에서 두 서버의 차이는 이랬습니다.

| 항목 | 약한 서버 | 고친 서버 |
|---|---|---|
| Heartbleed, CCS, ROBOT, POODLE, FREAK, LOGJAM, RC4 | 모두 `not vulnerable (OK)` | 모두 `not vulnerable (OK)` |
| BEAST | `VULNERABLE -- but also supports higher protocols TLSv1.1 TLSv1.2 (likely mitigated)` | `not vulnerable (OK), no SSL3 or TLS1` |
| LUCKY13 | `potentially VULNERABLE, uses obsolete cipher block chaining ciphers` | `not vulnerable (OK)` |
| TLS_FALLBACK_SCSV | `Downgrade attack prevention supported (OK)` | `No fallback possible (OK), no protocol below TLS 1.2 offered` |
| Strict Transport Security | `not offered` | `365 days=31536000 s, just this domain` |

눈여겨볼 점은 약한 서버에서도 Heartbleed 같은 유명한 취약점이 `OK`로 나왔다는 것입니다. 이 서버는 최신 nginx이므로 코드의 결함은 없고, 문제는 설정(낡은 프로토콜과 암호)에 있습니다. 점검 결과의 `OK`가 많다고 해서 안전한 서버인 것은 아니며, 설정의 문제는 `LOW`부터 `HIGH`까지의 줄에서 읽어야 합니다. BEAST는 낡은 TLS 1.0에서만 의미가 있고, 서버가 더 높은 프로토콜도 받으므로 "아마 완화됨"이라고 점검 도구가 스스로 덧붙입니다. 이런 문구를 지나치지 않고 읽는 것이 중요합니다.

## 5. JSON을 심각도로 집계하기

사람이 읽는 화면과 달리 CI는 숫자가 필요합니다. 저장한 JSON은 항목마다 `id`, `severity`(OK, INFO, LOW, MEDIUM, HIGH, CRITICAL, WARN), `finding`을 가집니다. 이를 세는 짧은 스크립트(`testssl_summary.py`)로 두 서버를 비교했습니다.

```text
[bad.json]  CRITICAL=1  HIGH=5  MEDIUM=4  LOW=6  INFO=43  OK=23
   CRITICAL cert_chain_of_trust        failed (self signed).
   HIGH     cert_subjectAltName        No SAN, browsers are complaining
   HIGH     cert_trust                 via CN only (same w/o SNI)
   HIGH     cert_expirationStatus      expires < 30 days (29)
   HIGH     cert_notAfter              2026-11-28 16:48
   HIGH     cert_revocation            Neither CRL nor OCSP URI provided
   MEDIUM   cert_signatureAlgorithm    SHA1 with RSA
   MEDIUM   cert_keySize               RSA 1024 bits (exponent is 65537)
   ...
[good.json] CRITICAL=1  HIGH=1  MEDIUM=0  LOW=1  INFO=47  OK=33
   CRITICAL cert_chain_of_trust        failed (self signed).
   HIGH     cert_revocation            Neither CRL nor OCSP URI provided
   LOW      DNS_CAArecord              --
```

약한 서버는 CRITICAL 1, HIGH 5, MEDIUM 4, LOW 6건이고, 고친 서버는 CRITICAL 1, HIGH 1, LOW 1건입니다. 고친 서버에 남은 세 건은 인증서를 공인 기관에서 받지 않아서 생기는 것들입니다. 자체 서명이라 신뢰 사슬이 없고(`cert_chain_of_trust`), 철회 정보(CRL, OCSP)가 없으며(`cert_revocation`), DNS의 CAA 기록이 없습니다(`DNS_CAArecord`). 실습 환경에서는 피할 수 없는 지적이며, 공인 인증서를 쓰는 실제 서버에서는 나오지 않거나 따로 판단합니다.

## 6. CI 기준 만들기: 예외를 두고 종료 코드로 가르기

집계 스크립트에 `--fail-on HIGH`(HIGH 이상이 남으면 실패)와 `--ignore`(예외 항목)를 두었습니다. 기준을 그대로 적용하면 고친 서버도 실패합니다.

```text
RESULT: FAIL (fail-on HIGH)
exit code = 1
```

자체 서명 인증서에서만 나오는 세 항목(`cert_chain_of_trust`, `cert_revocation`, `DNS_CAArecord`)을 예외로 두고 다시 적용하면 결과가 갈립니다.

| 서버 | 남는 HIGH 이상 | 결과 | 종료 코드 |
|---|---|---|---|
| 약한 서버 | HIGH 4건(SAN 없음, CN만으로 신뢰, 만료 30일 미만, 만료일) | FAIL | 1 |
| 고친 서버 | 없음 | PASS | 0 |

![testssl_demo.sh 실행 결과에서 openssl 프로토콜 교차 확인, testssl 프로토콜 비교, 심각도 집계, 예외를 둔 뒤 약한 서버는 FAIL(종료 코드 1), 고친 서버는 PASS(종료 코드 0)로 나뉘는 것을 확인합니다.](https://copyandrun.com/img/testssl-local-tls-check/02-testssl_demo-실행.png)

이 기준은 예외 목록에 이유를 남기면서 줄여 가는 것이 좋습니다. 예외 항목의 id가 아니라 서버를 통째로 건너뛰면 점검의 의미가 없어집니다. 만료일이 가까운 인증서가 HIGH로 잡히는 것도 쓸모가 있습니다. 갱신을 잊은 인증서를 서비스가 멈추기 전에 CI가 알려 줍니다.

## 7. 실제 서버를 점검할 때

이 글의 명령은 모두 내가 띄운 컨테이너를 대상으로 했습니다. 실제 서비스에 적용할 때는 다음을 지킵니다.

- 내가 소유하거나 점검을 허락받은 서버에만 실행합니다. 허락 없이 외부 서버를 점검하지 않습니다.
- 점검은 수십 초 동안 접속을 많이 일으키므로 운영 서버는 사용량이 적은 시간에 점검합니다.
- 방화벽 뒤의 서버는 이 글처럼 같은 네트워크에 도구 컨테이너를 두고 점검합니다. 다른 방법은 이 글에서 시험하지 않았습니다.

점검이 끝난 뒤에는 시험용 컨테이너, 볼륨, 네트워크를 지웠습니다(`docker ps -a`로 `osk-tls` 항목이 0개임을 확인했습니다).

## 전체 코드

아래 파일들을 같은 폴더에 두고 `bash testssl_demo.sh`를 실행하면 이 글의 모든 출력을 다시 볼 수 있습니다. 이 PC에서 약 3분이 걸렸습니다. 스크립트가 컨테이너, 볼륨, 네트워크를 만들고 끝에 모두 지웁니다.

`nginx_bad.conf`

```nginx
# nginx_bad.conf
server {
    listen 443 ssl;
    server_name lab.local;
    ssl_certificate     /certs/bad.crt;
    ssl_certificate_key /certs/bad.key;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ALL:@SECLEVEL=0;
    ssl_prefer_server_ciphers on;
    location / { return 200 "bad\n"; }
}
```

`nginx_good.conf`

```nginx
# nginx_good.conf
server {
    listen 443 ssl;
    server_name lab.local;
    ssl_certificate     /certs/good.crt;
    ssl_certificate_key /certs/good.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    add_header Strict-Transport-Security "max-age=31536000" always;
    add_header X-Content-Type-Options "nosniff" always;
    location / { return 200 "good\n"; }
}
```

`testssl_summary.py`

```python
# testssl_summary.py
"""testssl.sh 의 JSON 결과를 읽어 심각도별 개수를 세고, 기준 이상의 지적이 있으면 종료 코드 1을 돌려준다.
사용: python testssl_summary.py bad.json good.json [--fail-on HIGH] [--ignore id1,id2] [--show LOW]
"""
import argparse
import json
import os
import sys
from collections import Counter

ORDER = ["OK", "INFO", "LOW", "MEDIUM", "HIGH", "CRITICAL"]  # 오른쪽일수록 심각

ap = argparse.ArgumentParser()
ap.add_argument("files", nargs="+")
ap.add_argument("--fail-on", default="HIGH", help="이 등급 이상이 남아 있으면 실패(기본 HIGH)")
ap.add_argument("--ignore", default="", help="쉼표로 구분한 항목 id. 예외로 두고 세지 않는다")
ap.add_argument("--show", default="LOW", help="이 등급 이상의 지적을 줄마다 보여 준다")
a = ap.parse_args()

ignore = {x for x in a.ignore.split(",") if x}
fail_at, show_at = ORDER.index(a.fail_on), ORDER.index(a.show)
failed = False

for path in a.files:
    items = json.load(open(path, encoding="utf-8"))
    kept = [x for x in items if x["id"] not in ignore and x["severity"] in ORDER]
    cnt = Counter(x["severity"] for x in kept)
    name = os.path.basename(path)
    line = "  ".join(f"{s}={cnt.get(s, 0)}" for s in reversed(ORDER))
    print(f"[{name}] {line}   (ignored ids: {len(ignore)})")
    for x in sorted(kept, key=lambda x: -ORDER.index(x["severity"])):
        if ORDER.index(x["severity"]) >= show_at:
            print(f"   {x['severity']:8} {x['id']:26} {x['finding'][:60]}")
    if any(ORDER.index(x["severity"]) >= fail_at for x in kept):
        failed = True

print("RESULT:", "FAIL" if failed else "PASS", f"(fail-on {a.fail_on})")
sys.exit(1 if failed else 0)
```

`testssl_demo.sh`

```bash
# testssl_demo.sh
#!/usr/bin/env bash
# testssl.sh 로 TLS 설정을 점검한다. 일부러 약하게 만든 nginx(bad)와 고친 nginx(good)를 같은 도구로 비교한다.
# 준비: Docker, 같은 폴더에 nginx_bad.conf, nginx_good.conf, testssl_summary.py. 내 컴퓨터의 컨테이너만 검사한다.
# 실행(Git Bash): bash testssl_demo.sh   (약 3분)
export MSYS_NO_PATHCONV=1
HERE="$(pwd)"
NET=osk-tls
TS="docker run --rm --network $NET drwetter/testssl.sh --color 0 --quiet --warnings off"

cleanup() {
  docker rm -f osk-tls-bad osk-tls-good >/dev/null 2>&1
  docker volume rm osk-tls-certs >/dev/null 2>&1
  docker network rm $NET >/dev/null 2>&1
}
cleanup
docker network create $NET >/dev/null
docker volume create osk-tls-certs >/dev/null

echo "## 1. 인증서 두 장 만들기(나쁜 것: RSA 1024 + SHA1 + SAN 없음 / 좋은 것: ECDSA P-256 + SHA256 + SAN)"
docker run --rm --entrypoint sh -v osk-tls-certs:/certs alpine/openssl -c '
openssl req -x509 -newkey rsa:1024 -sha1 -nodes -days 30 -subj "/CN=bad.lab" \
  -keyout /certs/bad.key -out /certs/bad.crt 2>/dev/null
openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -sha256 -nodes -days 90 \
  -subj "/CN=good.lab" -addext "subjectAltName=DNS:good.lab" \
  -keyout /certs/good.key -out /certs/good.crt 2>/dev/null
chmod 644 /certs/*'
for n in bad good; do
  docker run -d --name osk-tls-$n --network $NET --network-alias $n.lab \
    -v osk-tls-certs:/certs:ro -v "$HERE/nginx_$n.conf:/etc/nginx/conf.d/default.conf:ro" nginx:alpine >/dev/null
done
sleep 3

echo "## 2. 다른 도구(openssl s_client)로 먼저 확인: 어떤 프로토콜이 열려 있나"
for h in bad good; do
  for p in tls1 tls1_1 tls1_2 tls1_3; do
    r=$(docker run --rm --network $NET --entrypoint sh alpine/openssl -c \
      "echo | openssl s_client -connect $h.lab:443 -$p -cipher 'ALL:@SECLEVEL=0' 2>&1 | grep -E 'Protocol  *:|Cipher is' | head -2 | tr -s ' ' | tr '\n' ' '")
    printf '  %-5s %-7s %s\n' "$h" "$p" "$r"
  done
done

echo "## 3. testssl.sh 프로토콜 검사(-p)"
for n in bad good; do
  echo "  [$n]"
  $TS -p $n.lab:443 2>&1 | grep -E '^ (SSLv|TLS 1)' | sed 's/^/  /'
done

echo "## 4. 전체 검사(-p -S -U -h)를 JSON 으로 저장"
mkdir -p out
for n in bad good; do
  SECONDS=0
  docker run --rm --network $NET -v "$HERE/out:/data" drwetter/testssl.sh     --color 0 --quiet --warnings off -p -S -U -h --jsonfile /data/$n.json $n.lab:443 >/dev/null 2>&1
  echo "  $n: ${SECONDS}s"
done

echo "## 5. 심각도별 개수와 LOW 이상 지적"
python testssl_summary.py out/bad.json out/good.json --fail-on HIGH
echo "exit code = $?"

echo "## 6. 실습용 자체 서명 인증서에서 나오는 세 항목만 예외로 두고 기준(HIGH) 적용"
IGN=cert_chain_of_trust,cert_revocation,DNS_CAArecord
for n in bad good; do
  python testssl_summary.py out/$n.json --fail-on HIGH --ignore $IGN --show HIGH | tail -n +1
  echo "  -> $n exit code = ${PIPESTATUS[0]}"
done

echo "## 7. 정리"
cleanup
rm -rf out
docker ps -a --format '{{.Names}}' | grep -c osk-tls
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| `alpine/openssl`에서 `Invalid command 'sh'`가 나옵니다 | 이 이미지는 실행 명령이 `openssl`로 고정되어 있습니다. `--entrypoint sh`를 붙입니다 |
| nginx가 시작하자마자 종료됩니다 | 인증서 파일을 못 찾는 경우입니다. `docker logs`의 `cannot load certificate`를 보고 마운트 경로를 확인합니다 |
| Git Bash에서 `-v` 경로가 이상합니다 | `export MSYS_NO_PATHCONV=1`을 하고, 경로는 현재 폴더 기준(`$PWD`)으로 줍니다 |
| `Trust (hostname)`이 `does not match`로 나옵니다 | 인증서의 이름과 접속 이름이 다릅니다. 처음에 인증서 이름을 `lab.local`로, 접속 이름을 `bad.lab`으로 달리 만들어 이 경고가 나왔고, 이름을 맞춰 다시 만들었습니다 |
| 컨테이너의 시계가 내 PC와 하루 다르게 보입니다 | 컨테이너는 UTC를 씁니다. 결과의 날짜는 UTC 기준이며 이 글의 만료일도 같습니다 |
| 약한 서버의 `TLS 1.3`이 `downgraded`로 나옵니다 | 서버가 TLS 1.3을 받지 않아서 낮은 프로토콜로 내려갔다는 뜻입니다. 오류가 아니라 서버의 설정 결과입니다 |

## 확인 범위

- **해 본 것:** 2026-10-30, Windows 11 · Docker 29.5.3 · testssl.sh 3.2.4 · nginx 1.31.8에서 약한 서버와 고친 서버를 띄워 `openssl s_client` 교차 확인, testssl.sh의 프로토콜·인증서·취약점·헤더 점검, JSON 저장과 심각도 집계, 예외를 둔 기준의 종료 코드(약한 서버 1, 고친 서버 0)를 실행했습니다. 끝난 뒤 컨테이너, 볼륨, 네트워크를 지웠습니다.
- **해 보지 않은 것:** 공인 인증서(Let's Encrypt 등)가 붙은 서버, 암호 목록 전체(`-e`)와 암호의 우선순위 점검, 클라이언트 시뮬레이션(`-c`), 메일 서버(STARTTLS)와 다른 포트, 운영 중인 외부 서버, Linux와 macOS 직접 설치판, 결과를 HTML이나 CSV로 내보내는 옵션.
- **읽을 때 주의:** 점검 도구의 등급(LOW, MEDIUM, HIGH)은 도구의 판단이며 서비스의 실제 위험과 같지 않을 수 있습니다. 취약점 이름은 이 버전(3.2.4)의 출력이며 버전에 따라 달라집니다. 두 서버의 인증서는 모두 자체 서명이므로, 신뢰 사슬과 철회 정보 항목은 실제 서버의 상태를 말해 주지 않습니다. 실습에서 만든 약한 설정은 시험용이며 실제 서버에 쓰지 않습니다.
