Debian 13 강좌 / Certbot·HTTPS 인증서 발급 조건과 갱신·배포 확인
Debian 13에서 HTTPS를 운영하려면 인증서 발급뿐 아니라 이름·신뢰 체인·만료와 웹 서버가 실제 제공하는 인증서까지 확인해야 합니다. 공개 도메인과 외부 검증 경로가 준비되면 Certbot으로 발급·갱신을 구성하고, 조건이 없는 실습 VM에서는 로컬 테스트 CA로 같은 점검 흐름을 배울 수 있습니다. 이 강좌의 실행 검증은 후자의 방식이며 공개 인증서 발급 성공과 혼동하지 않도록 구분합니다.
공개 인증서와 로컬 테스트 인증서의 차이
HTTPS는 TLS(Transport Layer Security)로 HTTP 통신을 보호하는 방식입니다. 인증서에는 서버 공개 키와 사용할 이름 등의 정보가 들어가고, 인증 기관인 CA(Certificate Authority)가 서명합니다. 클라이언트는 신뢰하는 CA로 이어지는지, 접속 이름이 인증서에 맞는지, 유효기간 안인지 확인합니다.
ACME(Automatic Certificate Management Environment)는 도메인 등의 제어 권한을 검증하고 인증서 발급·갱신을 자동화하는 프로토콜입니다. Certbot은 이를 사용하는 클라이언트입니다. 로컬에서 만든 CA는 인터넷 브라우저가 기본 신뢰하지 않으므로 공용 사이트 인증서의 대용품이 아닙니다.
| 경로 | 필요 조건 | 이 강좌의 검증 범위 |
|---|---|---|
| 공개 Certbot 발급 | 제어 가능한 실제 도메인, 검증 방식에 맞는 DNS·외부 접근 | 공식 문서와 설치된 옵션을 확인한 조건부 운영 절차입니다. 실제 발급은 수행하지 않았습니다. |
| 로컬 테스트 CA | sudo 가능한 별도 Debian VM, Nginx·OpenSSL·curl | 신뢰·이름 검증, HTTPS 응답, 인증서 재발급과 reload를 직접 확인했습니다. |
Let’s Encrypt의 검증 방식 안내에서 HTTP-01은 외부에서 도메인의 80번 포트로 토큰에 접근해야 합니다. VM의 8443만 열거나 hosts 파일을 바꿔서는 이 조건이 충족되지 않습니다. DNS-01은 공개 DNS TXT 레코드 제어가 필요하며 자동 갱신에는 적절한 DNS 플러그인과 제한된 API 권한을 검토합니다.
패키지와 실제 갱신 타이머 확인
실습은 앞 강좌의 Nginx가 정상 실행되는 VM을 사용하며 8443 포트와 아래 전용 경로가 비어 있어야 합니다. 기존 공개 사이트가 있는 서버에서는 설정과 인증서·키를 안전하게 백업하고 변경 범위를 정한 뒤 진행합니다.
sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager
검증 VM은 OpenSSL 3.5.7, Certbot 4.0.0, Nginx 1.26.3을 사용했습니다. Debian 패키지의 certbot.timer는 하루 두 기준 시각에 무작위 지연을 더하고 Persistent=true로 설정되어 있었습니다. certbot.service는 renew를 실행하는 oneshot이었습니다. 설치 방식이 다르면 타이머 이름과 일정도 다를 수 있으므로 실제 설정을 확인합니다.
타이머 active는 예약이 활성화됐다는 뜻입니다. 인증서가 존재하거나 갱신·배포가 성공했다는 뜻은 아닙니다. 이 VM의 certbot certificates 결과는 No certificates found였으며, 뒤의 로컬 OpenSSL 인증서는 Certbot 관리 대상으로 자동 등록되지 않습니다.
도메인 없이 로컬 CA와 HTTPS 사이트 만들기
다음 전체 블록은 새 실습 경로가 없을 때만 실행합니다. CA 키와 서버 키는 root 전용 경로에 두고, 클라이언트가 읽을 공개 CA 인증서만 별도 public 경로에 둡니다. 시스템이나 브라우저의 신뢰 저장소에는 추가하지 않습니다. 키는 암호 없이 생성하지만 700 디렉터리와 600 파일로 제한하며, 이 방식은 짧은 로컬 실습을 위한 것입니다.
관리자 권한은 sudo bash로 명시하고, 내부 명령은 한 번의 root 셸에서 실행합니다. CA는 3일, 첫 서버 인증서는 1일 유효하도록 만들며 SAN(Subject Alternative Name)에 lab26.test를 넣습니다. 이 이름은 로컬 테스트용으로만 사용합니다.
sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
listen 127.0.0.1:8443 ssl;
server_name lab26.test;
ssl_certificate /etc/nginx/lf-tls26/server.crt;
ssl_certificate_key /etc/nginx/lf-tls26/server.key;
default_type text/plain;
return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT
생성 파일 중 ca.key와 server.key는 비밀 키이고 ca.crt·server.crt는 공개 인증서입니다. CN만 적었다고 이름 검증이 충분하다고 생각하지 말고 SAN을 확인합니다. 서버 인증서의 확장에는 CA가 아님과 서버 인증 용도를 명시했습니다. 구성과 개인 키 접근 조건은 Nginx HTTPS 설정 문서에서도 설명합니다.
설정 검사와 reload가 끝난 뒤 Debian VM의 일반 사용자로 요청합니다. reload 직후 연결이 안 되면 잠시 뒤 다시 실행하고 ss와 서비스 로그를 확인합니다. --resolve는 DNS를 변경하지 않고 이 요청에만 이름과 주소를 연결하며, --cacert는 이 요청에서만 테스트 CA를 신뢰하게 합니다.
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
예상 응답은 TLS LAB 26입니다. 이 성공은 loopback·지정 CA·지정 이름의 조건에서 검증한 결과이며 공용 DNS나 일반 브라우저 신뢰를 확인한 결과는 아닙니다.
신뢰와 이름 오류를 따로 재현하기
다음 첫 요청은 테스트 CA를 지정하지 않고, 두 번째는 CA를 지정하되 인증서에 없는 IP 주소로 접속합니다. 두 명령은 실패가 예상되므로 오류 시 바로 종료하는 실습 셸과 별도로 실행하거나 각 명령 뒤에 종료 코드를 확인합니다.
curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"
검증에서는 두 경우 모두 curl 종료 코드 60이었지만, 첫 번째는 신뢰하지 않는 발급자, 두 번째는 이름 불일치가 원인이었습니다. 숫자만 보고 같은 원인으로 묶지 말고 오류 문구를 함께 읽습니다. -k로 검증을 끄고 성공한 결과는 인증서 신뢰 확인으로 사용할 수 없습니다.
파일 자체의 체인·이름과 만료는 다음처럼 확인합니다. 서버 인증서 경로는 root 전용 디렉터리 안에 있으므로 sudo를 사용합니다.
sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600
-checkend 3600은 앞으로 3,600초 안에 만료하는지 검사하며, 만료가 가까우면 0이 아닌 상태를 반환합니다. 이것만으로 체인이나 이름까지 검증하는 것은 아닙니다. OpenSSL x509 옵션 설명에 따라 날짜·SAN·체인 검사 목적을 구분합니다.
재발급 파일과 실제 제공 인증서를 비교하기
서버 인증서를 바꿔도 실행 중 Nginx가 새 인증서를 제공한다고 보장할 수 없습니다. 먼저 새 연결에서 제공되는 인증서의 일련번호를 확인합니다. -servername은 TLS의 SNI(Server Name Indication)로 원하는 서버 이름을 전달합니다. 이 명령은 인증서를 관찰하기 위한 것이며, 실제 신뢰·이름 검증은 앞의 curl과 openssl verify로 수행합니다.
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
처음 일련번호는 16진수 26입니다. 다음은 같은 실습 CA와 CSR로 유효기간 2일·일련번호 27의 새 인증서를 만들고, 검증이 끝난 뒤 같은 디렉터리 안에서 파일 이름을 교체합니다. 이 비교는 ACME 갱신이 아니라 배포 단계를 분리해 관찰하는 로컬 재발급입니다.
sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT
위 블록을 끝낸 직후 파일의 일련번호는 27이지만, 새 연결에서 받은 인증서는 여전히 26이었습니다. 파일 저장 성공과 배포 성공이 다르다는 증거입니다. 정상본 server-before.crt는 이 단계에서 보존했습니다.
아래 전용 배포 스크립트는 검사 성공 때만 reload합니다. 이 실습에서는 아직 이 이름의 파일이 없음을 준비 단계에서 확인했습니다. 운영 서버의 기존 스크립트를 덮어쓰는 용도로 사용하지 않습니다.
sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
검증에서는 reload 후 새 연결의 일련번호가 27로 바뀌고 HTTP 응답도 정상이었습니다. 직후 예전 worker가 종료 중이면 잠시 뒤 새 연결로 다시 확인합니다. 설정 검사가 실패하면 reload하지 않고 파일·키의 대응과 경로·권한을 조사합니다. 이 실습 인증서를 원복할 때는 보관한 server-before.crt를 해당 server.crt로 복사하고 검사·reload·제공 인증서 확인을 같은 순서로 수행합니다.
공개 도메인이 준비된 경우의 Certbot 절차
이 절은 실제 도메인을 운영하는 경우에만 적용하는 절차입니다. 127.0.0.1:8443의 로컬 사이트와 별개로, 도메인의 A·AAAA가 올바른 서버를 가리키고 사용 중인 모든 경로에서 HTTP-01의 80번 접근이 가능해야 합니다. 잘못된 IPv6 주소, 프록시·CDN·방화벽·NAT 설정도 확인합니다. 다른 네트워크에서 도메인 접속을 검사하고 Nginx 사이트의 server_name을 실제 도메인에 맞춥니다.
아래는 이미 준비된 Nginx 사이트에 적용하는 조건부 명령입니다. 직접 제어하는 도메인과 연락 이메일을 입력하며, 실제 서버에서는 먼저 설정을 백업합니다. --dry-run은 staging 검증을 시도하므로 외부 조건이 없는 VM에서 실행할 필요가 없습니다.
read -r -p "직접 제어하는 실제 도메인: " domain
read -r -p "인증서 연락 이메일: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos
staging 인증서는 일반 클라이언트가 신뢰하지 않습니다. Let’s Encrypt staging 안내에 따라 검증 오류를 먼저 해결한 뒤 운영 발급을 진행합니다. dry-run이 성공해도 운영 인증서가 저장된 것은 아닙니다. 정상 조건에서 다음 명령은 운영 인증서를 발급하고 Nginx 구성을 수정하므로 변경 내역을 검토해야 합니다.
sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"
실제 인증서 이름과 live 경로는 certificates 출력으로 확인합니다. Nginx에는 서버 인증서와 필요한 중간 인증서를 담은 fullchain.pem과 대응 privkey.pem이 연결되어야 합니다. 파일이 존재한다는 확인으로 끝내지 말고 외부 HTTPS 응답과 제공 인증서 이름·발급자·만료를 확인합니다.
운영 갱신 검증은 sudo certbot renew --dry-run으로 수행합니다. 설치된 4.0.0의 도움말에서는 deploy hook은 기본 dry-run에서 실행되지 않고 --run-deploy-hooks를 추가해야 한다고 안내했습니다. Nginx 플러그인이 처리하는 재적용과 별도로 자신이 deploy hook을 구성한 경우에는 적용 대상과 중복 reload를 검토하고, hook을 포함한 시험은 유지보수 범위에서 수행합니다.
certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager
갱신 대상이 없어 아무 작업 없이 끝나는 결과는 갱신 성공의 증거가 아닙니다. 실제 관리 중인 인증서가 있는지부터 확인하고, 필요한 시점의 갱신 결과·배포 결과·새 연결의 인증서를 따로 기록합니다. 플러그인과 hook의 의미는 Certbot 공식 사용 안내를 참고하되 설치한 버전의 도움말과 실제 구성을 우선 확인합니다.
로컬 실습만 정리하기
공개 Certbot 설정을 구성한 독자는 이 정리 절을 공개 사이트에 적용하지 않습니다. 아래 블록은 앞서 생성한 lf-tls26의 링크를 제거한 뒤 검사·reload하고 8443 리스너가 사라진 경우에만 전용 키·인증서·폴더를 삭제합니다. 신뢰 저장소를 바꾸지 않았으므로 시스템 CA 제거 작업도 필요 없습니다.
sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT
검증 VM에서는 전용 HTTPS 사이트·키·CA·배포 스크립트가 제거되고 기존 Nginx 기본 설정 해시가 유지됐습니다. Certbot 패키지와 활성 타이머는 남았지만 관리 인증서는 없었습니다. 이 상태와 공개 인증서의 자동 갱신 운영을 같은 것으로 취급하지 않습니다.




