Rocky Linux 10 강좌 / HTTPS 인증서 발급·자동 갱신·만료 점검

Rocky Linux 10에서 HTTPS를 운영하려면 인증서 발급뿐 아니라 웹 서버 적용, 자동 갱신 실행, 실제 제공 인증서와 만료 감시까지 확인해야 합니다. 이 강좌는 별도 시험 인증기관에서 실제 ACME 발급·갱신을 재현하고, 공개 서비스에 적용할 때 필요한 DNS·포트·신뢰 조건을 구분합니다.

공개 인증서와 로컬 시험 인증서의 차이

HTTPS는 TLS(전송 계층 보안)로 HTTP 통신을 보호합니다. 인증기관(CA)은 사이트 이름과 공개키의 연결을 인증서에 서명하며, 클라이언트는 이름·유효기간·발급 체인을 검증합니다. ACME(자동 인증서 관리 환경)는 도메인 제어권 확인과 발급·갱신을 자동화하는 프로토콜이고, Certbot은 이를 수행하는 클라이언트입니다.

Let’s Encrypt의 공식 인증 방식 설명에 따르면 공개 HTTP-01 검증은 80번 포트로 인증 파일을 요청합니다. 도메인에서 사용 중인 A·AAAA 레코드, 외부 방화벽과 포트 전달, 실제 웹 서버 경로가 모두 맞아야 합니다. 자신의 hosts 파일만 바꾸거나 Certbot의 대기 포트를 다른 번호로 바꾸어도 공개 인증기관의 접속 조건이 바뀌지는 않습니다. DNS-01은 DNS TXT 레코드로 검증하며 자동 갱신에는 해당 DNS 제공자의 자동화 방식이 필요합니다.

환경 검증 범위와 신뢰
이번 Pebble 실습 VM 안에서 시험 이름과 HTTP-01을 실제 검증합니다. 사설 시험 CA이며 브라우저의 일반 신뢰 대상이 아닙니다.
Let’s Encrypt staging 공개 DNS와 접속 조건으로 시험 발급합니다. 시험 인증서는 일반 신뢰 인증서가 아닙니다.
운영 인증기관 실제 공개 도메인과 정책을 충족해 발급받습니다. 클라이언트 신뢰·이름·체인과 외부 접근을 별도로 확인합니다.

Let’s Encrypt staging 안내는 운영 발급 전에 시험할 것을 권장하며, 개발용 로컬 ACME 서버로 Pebble을 소개합니다. 이번 실습은 공개 도메인을 사용한 staging·운영 발급까지 검증한 결과가 아닙니다.

도구와 로컬 ACME 시험 기관 준비

별도 Rocky Linux 10 가상 머신에서 진행하세요. 확인 환경은 Rocky Linux 10.2, Python 3.12.15, Certbot 5.10.0, Pebble 2.10.3, Nginx 1.26.3, OpenSSL 3.5.8, SELinux Enforcing입니다. 아래 Pebble 배포 파일은 x86_64용입니다. 다른 CPU 구조에서는 해당 공식 배포와 체크섬을 선택해야 합니다. 기존 사이트·인증서·같은 이름의 실습 파일이 있는 서버에서는 그대로 실행하지 마세요.

이 환경의 EPEL Certbot 패키지는 일부 의존성이 Rocky 10.2 저장소와 맞지 않아 설치되지 않았습니다. 시스템 패키지를 강제로 교체하지 않고 전용 Python 가상환경에 Certbot을 설치했습니다. Certbot 설치 문서에서 pip 방식은 가상환경을 사용하는 제한적 지원 방식임을 확인할 수 있습니다. 운영에서는 설치 방법과 업데이트 책임을 함께 정하고 서로 다른 Certbot 설치를 혼용하지 않습니다.

sudo dnf install python3 tar openssl nginx policycoreutils-python-utils
sudo ss -lntp
sudo bash <<'ROOT'
set -euo pipefail
test ! -e /root/lf-course26
test ! -e /usr/local/bin/lf-course26-pebble
install -d -m 0700 /root/lf-course26
cp -a /etc/hosts /root/lf-course26/hosts.before
cp -a /etc/nginx /root/lf-course26/nginx.before
python3 -m venv /root/lf-course26/venv
/root/lf-course26/venv/bin/python -m pip install 'certbot==5.10.0'
cd /root/lf-course26
curl -fL -o pebble.tar.gz https://github.com/letsencrypt/pebble/releases/download/v2.10.3/pebble-linux-amd64.tar.gz
printf '7e33cf3e426b67e9e647c44e8cc91683caa8ab331f7a99e5e27fcee291c4c7e2  pebble.tar.gz\n' | sha256sum -c -
tar -xzf pebble.tar.gz --strip-components=3
install -m 0755 pebble /usr/local/bin/lf-course26-pebble
restorecon /usr/local/bin/lf-course26-pebble
openssl req -x509 -newkey rsa:2048 -noenc -keyout api.key -out api.pem -days 2 -subj /CN=localhost -addext 'subjectAltName=DNS:localhost,IP:127.0.0.1'
chmod 0600 api.key
printf '\n127.0.0.1 course26.test # lf-course26\n' >> /etc/hosts
ROOT

실행 전에 14000·15000·5002·18426번이 사용되지 않는지, course26.test가 기존 hosts 항목에 없는지 확인합니다. 위 sudo bash 안은 관리자 권한으로 실행되며, 오류가 나면 이후 명령을 중단합니다. 배포 압축 파일의 SHA-256 기대값은 해당 공식 릴리스의 배포 정보와 대조한 값입니다. 해시가 다르면 실행하지 마세요.

다음 내용을 sudoedit /root/lf-course26/pebble.json으로 저장합니다. API 접속용 인증서 api.pem과 이후 사이트에 발급되는 인증서는 서로 다릅니다. 두 API는 루프백 주소에서만 수신하고 시스템 전체 CA 저장소는 변경하지 않습니다.

{
  "pebble": {
    "listenAddress": "127.0.0.1:14000",
    "managementListenAddress": "127.0.0.1:15000",
    "certificate": "/root/lf-course26/api.pem",
    "privateKey": "/root/lf-course26/api.key",
    "httpPort": 5002,
    "tlsPort": 5001,
    "keyAlgorithm": "ecdsa",
    "profiles": {
      "default": {
        "description": "Local course26 test",
        "validityPeriod": 7776000
      }
    }
  }
}
sudo systemd-run --unit=lf-course26-pebble --property=WorkingDirectory=/root/lf-course26 --setenv=PEBBLE_VA_NOSLEEP=1 --setenv=PEBBLE_AUTHZREUSE=0 /usr/local/bin/lf-course26-pebble -config /root/lf-course26/pebble.json
sudo curl --retry 3 --retry-connrefused --cacert /root/lf-course26/api.pem -fsS https://localhost:14000/dir
sudo curl --cacert /root/lf-course26/api.pem -fsS https://localhost:15000/roots/0 -o /root/lf-course26/issuer-root.pem

첫 조회는 ACME 경로가 담긴 JSON을 반환하고, 두 번째는 시험 발급 체인의 루트 인증서를 저장합니다. PEBBLE_VA_NOSLEEP=1은 인위적인 대기만 없애고, PEBBLE_AUTHZREUSE=0은 이전 인증 결과의 재사용을 없애 반복 검증을 관찰하기 위한 설정입니다. 검증을 항상 성공 처리하는 모드는 사용하지 않습니다. Pebble의 인증기관 상태는 실행 중 메모리에 보관되므로 재시작 후 이전 루트·계정·발급 상태가 그대로 이어진다고 가정하지 않습니다. 재시작했다면 새 시험 환경의 발급과 신뢰 관계를 다시 확인합니다. 세부 설정은 Pebble 2.10.3 공식 README를 참고하세요.

systemd에서 실행할 바이너리를 /root에 둔 첫 시도는 실행 단계의 권한 거부로 실패했습니다. 표준 실행 경로인 /usr/local/bin에 배치하고 문맥을 복원한 뒤 정상 실행되었습니다. 203/EXEC가 나오면 journalctl -u lf-course26-pebble과 파일 경로·권한·SELinux 문맥을 확인하고, 보안 기능을 끄는 방식으로 해결하지 않습니다.

HTTP-01 검증으로 시험 인증서 발급

sudo env REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem /root/lf-course26/venv/bin/certbot certonly --standalone --http-01-address 127.0.0.1 --http-01-port 5002 --preferred-challenges http --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --register-unsafely-without-email --agree-tos --non-interactive -d course26.test
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial -dates -issuer -ext subjectAltName
sudo journalctl -u lf-course26-pebble -n 25 --no-pager

이 명령은 로컬 시험 서버에만 계정을 만들고, 임시 standalone 서버가 5002번에서 인증 파일을 제공합니다. 이메일을 생략하는 옵션도 이번 사설 시험에 한정합니다. REQUESTS_CA_BUNDLE은 해당 실행의 API TLS 신뢰에만 사용합니다. TLS 검증을 생략하는 옵션은 필요하지 않습니다.

실제 로그에는 http://course26.test:5002/.well-known/acme-challenge/...로 세 차례 확인한 기록과 인증 완료가 남았고 인증서가 발급되었습니다. 이 5002번은 Pebble에 설정한 시험 포트입니다. 공개 HTTP-01에 같은 방법으로 임의 포트를 지정할 수 있다는 뜻은 아닙니다.

cert.pem은 사이트 인증서, chain.pem은 중간 인증서, fullchain.pem은 사이트 인증서와 중간 체인, privkey.pem은 비밀키입니다. live의 파일은 버전별 archive 파일을 가리키는 심볼릭 링크입니다. 비밀키·계정 키는 웹 문서 경로나 공개 백업에 넣지 않습니다. 이번 설정은 시험 유효기간을 90일로 정했지만 운영 인증서의 유효기간을 일률적으로 가정하지 말고 실제 notAfter를 확인하세요.

Nginx 적용과 이름·체인 검증

시험 사이트는 127.0.0.1:18426에서만 제공합니다. Certbot 보관 경로를 그대로 공개하지 않고 Nginx가 읽을 전용 TLS 경로로 인증서를 배포합니다. 새 경로와 포트가 기존 설정에 사용되지 않는지 먼저 확인하세요.

sudo install -d -m 0700 /etc/pki/tls/lf-course26
sudo install -m 0644 /root/lf-course26/config/live/course26/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
sudo install -m 0600 /root/lf-course26/config/live/course26/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
sudo restorecon -Rv /etc/pki/tls/lf-course26
sudo semanage port -a -t http_port_t -p tcp 18426

sudoedit /etc/nginx/conf.d/lf-course26.conf로 다음 전체 server 구역을 저장합니다. 기본 80번 사이트 설정은 유지합니다.

server {
    listen 127.0.0.1:18426 ssl;
    server_name course26.test;
    ssl_certificate /etc/pki/tls/lf-course26/fullchain.pem;
    ssl_certificate_key /etc/pki/tls/lf-course26/privkey.pem;
    location / {
        default_type text/plain;
        return 200 "LF26 HTTPS works\n";
    }
}
sudo nginx -t && sudo systemctl start nginx
sudo curl --cacert /root/lf-course26/issuer-root.pem --resolve course26.test:18426:127.0.0.1 -sS -w 'HTTP %{http_code}\n' https://course26.test:18426/

Nginx가 이미 실행 중이라면 위 start 대신 sudo systemctl reload nginx로 새 설정을 적용합니다. 이 실습은 중지 상태에서 start한 경우를 확인했습니다. LF26 HTTPS works와 200이 예상 결과입니다. --resolve는 이 요청의 접속 주소만 지정하면서 URL 이름과 TLS의 SNI(서버 이름 표시)를 유지합니다. --cacert는 이번 시험 CA만 지정하며 일반 브라우저의 신뢰 설정을 바꾸지 않습니다.

실제 비교에서 시험 루트를 지정하지 않은 curl은 발급 체인을 신뢰하지 못해 종료 코드 60으로 실패했습니다. 시험 루트를 지정해도 URL 이름을 wrong26.test로 바꾸면 인증서 이름 불일치로 같은 종료 코드 60이었습니다. 종료 코드만으로 원인을 구분하지 말고 오류 문장을 함께 확인하세요. 암호화 연결 성공과 올바른 상대 인증은 함께 검사해야 합니다.

실제 갱신과 배포 훅 검증

Certbot이 새 인증서 파일을 저장해도 별도 경로에 복사한 Nginx 인증서는 자동으로 바뀌지 않습니다. 갱신 성공 뒤 실행하는 deploy hook에서 복사·문맥 복원·설정 검사·reload를 처리합니다. 다음 내용을 sudoedit /usr/local/sbin/lf-course26-deploy로 저장합니다. 이 훅은 이번 시험 이름과 보관 경로에 한정되어 있습니다.

#!/bin/bash
set -euo pipefail
test "${RENEWED_LINEAGE:-}" = /root/lf-course26/config/live/course26
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -checkend 0
openssl verify -CAfile /root/lf-course26/issuer-root.pem -untrusted "$RENEWED_LINEAGE/chain.pem" -verify_hostname course26.test "$RENEWED_LINEAGE/cert.pem"
install -d -m 0700 /root/lf-course26/deploy-backup
cp -a /etc/pki/tls/lf-course26/fullchain.pem /etc/pki/tls/lf-course26/privkey.pem /root/lf-course26/deploy-backup/
install -m 0644 "$RENEWED_LINEAGE/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$RENEWED_LINEAGE/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
restorecon -R /etc/pki/tls/lf-course26
if ! nginx -t || ! systemctl reload nginx; then
    install -m 0644 /root/lf-course26/deploy-backup/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
    install -m 0600 /root/lf-course26/deploy-backup/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
    nginx -t && systemctl reload nginx
    exit 1
fi
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -serial >> /root/lf-course26/deploy-serials.log

적용 전에 체인·이름·유효기간을 확인하고 기존 배포 파일을 보호된 위치에 보관합니다. 설정 검사 또는 reload가 실패하면 이전 배포 파일을 되돌리고 오류로 종료합니다. 복원까지 실패하면 서비스 로그와 실제 응답을 확인해야 하며, 자동 복구 성공으로 간주하지 않습니다. 이번에는 정상 인증서를 배포한 경로를 실행 검증했으며 이 실패 복구 분기까지 고의로 재현하지는 않았습니다.

다음 내용을 sudoedit /usr/local/sbin/lf-course26-renew로 저장합니다. 가상환경의 Python으로 Certbot 콘솔 스크립트를 실행합니다.

#!/bin/bash
set -euo pipefail
export REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem
exec /root/lf-course26/venv/bin/python /root/lf-course26/venv/bin/certbot renew --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --non-interactive --no-random-sleep-on-renew --deploy-hook /usr/local/sbin/lf-course26-deploy "$@"
sudo chmod 0750 /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo restorecon /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo /usr/local/sbin/lf-course26-renew --force-renewal
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial
sudo openssl s_client -connect 127.0.0.1:18426 -servername course26.test -verify_hostname course26.test -CAfile /root/lf-course26/issuer-root.pem -verify_return_error </dev/null | openssl x509 -noout -serial

--force-renewal은 이번 로컬 시험에서 갱신을 관찰하기 위한 옵션입니다. 운영 타이머에 강제 갱신을 넣지 않습니다. 최초 일련번호는 4DFCA979CEB14834, 실제 갱신 뒤 저장·제공 번호는 4E9CBB509103CA00였습니다. reload 명령 직후 첫 연결에서 이전 인증서가 잠시 관찰되어 다시 연결한 뒤 저장 번호와 제공 번호의 일치를 확인했습니다. 명령의 종료만 보고 서비스 적용까지 완료됐다고 판단하지 마세요.

sudo bash <<'ROOT'
set -euo pipefail
sha256sum /root/lf-course26/config/live/course26/cert.pem > /root/lf-course26/dryrun-before.sha256
/usr/local/sbin/lf-course26-renew --dry-run --run-deploy-hooks
sha256sum -c /root/lf-course26/dryrun-before.sha256
ROOT

실제 모의 갱신은 HTTP-01과 훅을 성공적으로 실행했고 현재 인증서 해시는 그대로였습니다. --run-deploy-hooks를 지정한 dry-run의 훅은 임시 시험 인증서가 아니라 현재 활성 인증서를 사용합니다. 동작과 옵션은 Certbot 사용자 안내에서도 확인할 수 있습니다. dry-run 성공은 현재 파일이 새 인증서로 교체됐다는 뜻이 아닙니다.

타이머 실행과 만료 감시를 따로 확인

sudoedit /etc/systemd/system/lf-course26-renew.service에 다음 서비스를 저장합니다.

[Unit]
Description=Local course26 certificate renewal test
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-course26-renew

sudoedit /etc/systemd/system/lf-course26-renew.timer에는 다음 타이머를 저장합니다. OnActiveSec=3s는 실습에서 즉시 예약 실행을 관찰하기 위한 줄입니다. 실제 운영 주기에는 이 시험용 줄을 제외하고 서비스의 부하와 관리 정책에 맞는 실행 시간·분산 지연을 정합니다.

[Unit]
Description=Local course26 renewal timer test
[Timer]
OnActiveSec=3s
OnCalendar=*-*-* 03,15:00:00
Persistent=true
Unit=lf-course26-renew.service
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl start lf-course26-renew.timer
systemctl list-timers lf-course26-renew.timer --no-pager
systemctl show lf-course26-renew.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-course26-renew.service -n 25 --no-pager

3초 뒤 실제 자동 호출이 발생했고 최종 상태는 Result=success, ExecMainStatus=0, ActiveState=inactive였습니다. 로그는 아직 갱신 시점이 아니어서 재발급과 훅을 건너뛰었다고 명시했습니다. 따라서 “타이머가 실행됐다”, “갱신을 시도했다”, “새 인증서를 발급·배포했다”는 서로 다른 확인 항목입니다. oneshot 서비스가 정상 종료한 뒤 inactive인 것은 정상입니다. start는 이번 부팅의 실행이며 재부팅 자동 실행에는 enable 설정이 별도로 필요합니다.

sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -enddate
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 604800
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 8640000

이 시험 인증서는 7일 안에 만료되지 않아 604800초 검사에서 종료 코드 0, 100일 안에는 만료되어 8640000초 검사에서 1이었습니다. 후자가 “이미 만료됨”을 뜻하는 것은 아닙니다. -checkend는 지정한 초 이내의 만료를 검사합니다. OpenSSL x509 문서에서 옵션의 의미를 확인하세요. 운영 감시는 로컬 파일뿐 아니라 외부에서 실제 제공되는 인증서도 확인하고, 실패 시 관리자가 알 수 있는 알림 경로까지 시험해야 합니다.

공개 서비스에 적용할 때 바꿀 조건

실제 도메인에서는 사설 시험 CA·hosts 항목·5002번 검증 포트·루프백 API를 사용하지 않습니다. 공개 DNS와 외부 80번 연결을 먼저 확인하고, 기존 웹 서버를 유지하려면 webroot 방식으로 인증 파일을 제공할 수 있습니다. 별도 운영용 Certbot 경로와 설정 디렉터리를 준비해 시험 계정·시험 인증서를 운영 인증서와 섞지 마세요.

  1. 보유 도메인의 A·AAAA가 실제 서버를 가리키고 외부에서 접속 가능한지 확인합니다. 사용하지 않는 IPv6 레코드도 잘못된 서버를 가리키지 않는지 봅니다.
  2. Nginx에서 /.well-known/acme-challenge/의 시험 파일이 올바른 문서 경로로 제공되는지 외부에서 확인합니다. 숨김 경로 차단·인증 요구·잘못된 리디렉션이 검증을 방해할 수 있습니다.
  3. 운영용 Certbot에서 certonly --webroot -w 실제문서경로 -d 보유도메인 --dry-run으로 공개 staging 검증을 먼저 합니다. 연락 가능한 이메일과 약관 동의도 실제 계정에 맞게 입력합니다.
  4. 시험 성공 뒤 운영 발급을 수행하고 전체 체인과 비밀키 경로를 Nginx에 적용합니다. 운영 갱신 훅은 실제 경로·이름·신뢰 체인에 맞게 작성해야 하며 이 강좌의 사설 CA 훅을 그대로 재사용하지 않습니다.
  5. 외부 443번 응답, 이름·체인·만료, 갱신 dry-run과 배포 훅, 타이머의 다음 실행·최근 결과를 확인합니다. 공개 CA가 요구하는 발급·갱신 정책과 제한도 함께 따릅니다.

이 절은 공개 서비스의 전환 조건입니다. 이번 로컬 검증으로 실제 보유 도메인의 DNS·인터넷 방화벽·공개 인증기관 발급까지 확인했다고 간주할 수는 없습니다.

시험 환경 중지와 기존 설정 복원

시험을 마치면 먼저 타이머와 Pebble을 중지합니다. 자신이 만든 Nginx 파일을 백업 위치로 옮기고 검사 후 reload하면 기존 기본 사이트만 남습니다.

sudo systemctl stop lf-course26-renew.timer lf-course26-renew.service lf-course26-pebble.service
sudo mv /etc/nginx/conf.d/lf-course26.conf /root/lf-course26/lf-course26.conf.saved
sudo nginx -t && sudo systemctl reload nginx
sudo semanage port -d -p tcp 18426
sudo rm -- /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer
sudo systemctl daemon-reload

hosts에서는 이번에 추가한 정확한 한 줄만 제거합니다. 다른 편집이 없다면 보호해 둔 원본과 비교해 복원할 수 있습니다. 사용하지 않는 시험 실행 파일·전용 배포 인증서·타이머 상태 파일도 소유 범위를 확인한 뒤 제거하고, 다른 사이트가 쓰는 파일이나 규칙은 유지하세요. 비밀키와 계정 정보를 보관할 경우에는 원래처럼 root 전용 권한으로 보호합니다.

실제 정리 후 Nginx·방화벽 설정, hosts, SELinux 로컬 정책은 실습 전과 같았고, 기존 기본 사이트 본문도 같았습니다. SSH와 firewalld는 활성 상태, SELinux는 Enforcing을 유지했습니다. 시험 API·HTTPS 리스너와 예약 작업을 제거했으며 전용 기록 폴더만 권한 0700으로 보관했습니다.