HTTPS 웹 서버와 자동 인증서 — 내 기기가 안전한 웹 앞문이 되기
이 기능은
나눔OS 는 웹 사이트를 직접 HTTPS 로 내보낼 수 있습니다. httpsd 가 암호화된 연결(TLS 1.3·1.2)을 받고, acme 가 Let's Encrypt 에서 무료 인증서를 받아 두었다가 만료 전에 알아서 새로 받습니다. 다른 앞문 프로그램(리버스 프록시) 없이 나눔OS 하나가 사이트를 받습니다.
기초
인증서는 「이 주소의 주인이 맞다」는 신분증, TLS 는 그 신분증을 보여 준 뒤 잠그는 봉투에 비유할 수 있습니다. 신분증을 내주는 곳(Let's Encrypt)은 「그 주소의 80번 문에 내가 준 쪽지를 붙여 보라」고 하고, 나눔OS 가 그 쪽지를 붙여 보이면 신분증을 줍니다. 지금 할 일: 터미널에서 acme status 를 쳐서 받아 둔 인증서가 있는지 보세요.
쓰는 법
- 인증서 받기:
acme add 내주소.kr www.내주소.kr --agree-tos --email 나@메일— 처음 한 번 약관 동의가 필요합니다. 그 주소의 80번 포트가 이 기기에 닿아야 합니다(공유기 포트 열기·DNS A 레코드). 시험해 보려면--staging(가짜 인증서, 횟수 제한이 넉넉함). - 확인:
u httpsd --check는 쓸 인증서와 남은 날, 이름을 보여 줍니다(열쇠는 보여 주지 않습니다).acme status는 마지막 갱신 결과를 보여 줍니다. - 인증서가 아직 없을 때:
httpsd가 이 기기 이름과localhost로 자체 서명 인증서(selfsigned.crt)를 스스로 만들어, 첫 부팅부터 HTTPS 가 답합니다. 진짜 인증서(acme add)를 넣거나 이 인증서를 믿기 전까지 브라우저는 경고합니다. - 갱신은
acme add가 예약 작업(23 4 * * * acme renew)으로 넣어 두어 날마다 확인하고, 인증서 수명의 2/3 가 지나면 새로 받습니다. httpsd 는 바뀐 인증서를 5초 안에 다시 읽습니다(재시작 없음).
작동 원리
손님(브라우저)이 연결하면 httpsd 는 첫 인사(ClientHello)를 읽어 이름(SNI)과 TLS 판을 봅니다. TLS 1.3 을 말하는 손님은 우리가 RFC 8446 대로 짠 1.3 엔진이, 1.2 만 말하는 손님은 BearSSL 의 1.2 엔진이 받습니다. 이름에 맞는 인증서를 고르고(정확한 이름 → *. 와일드카드 → 없으면 첫 파일), 손님이 받는 서명 방식에 따라 ECDSA 나 RSA 열쇠를 씁니다. 암호는 최신 것만 씁니다: TLS 1.3 은 AES-128-GCM·AES-256-GCM·ChaCha20-Poly1305, 1.2 는 ECDHE 와 같은 세 가지(옛 CBC·RSA 키 교환·TLS 1.0/1.1 은 거절). 다시 오는 손님은 짧은 인사로 이어 받습니다(1.2 세션 ID, 1.3 티켓 — 다른 이름으로는 이어 주지 않음). 연결 하나로 여러 요청을 차례로 받습니다(keep-alive).
기술 자세히
- 코드:
user/cmds/httpd.c(httpsd 는 같은 소스를 TLS 로 빌드),user/tls/tlsserv.c(인증서 고르기·세션 캐시·1.2),user/tls/tls13.c(TLS 1.3: x25519·P-256 키 교환, HelloRetryRequest, PSK 티켓, RSA-PSS),user/tls/acme.c·acmejson.c. 계약docs/contracts/HTTPS.md. - 열쇠의 바이트는 화면·로그·상태 파일 어디에도 찍지 않습니다. 열쇠는 갱신 때마다 새로 만듭니다.
- 네트워크에서 읽는 새 해석기(ClientHello·레코드·티켓, ACME JSON, HTTP 요청)는 퍼징 대상입니다(
tests/fuzz/tls13·acme·httpd). - HTTP/2 는 아직 없습니다(계획은 계약 문서에). OCSP 스테이플링도 하지 않습니다.
이 앱이 가져가는 것
| 가져가는 것 | acme add·acme renew 를 할 때만: acme-v02.api.letsencrypt.org(시험이면 acme-staging-v02.api.letsencrypt.org)에서 인증서 체인. 그 밖에는 아무것도 받지 않습니다. |
| 보내는 것 | Let's Encrypt 에: 계정의 공개 열쇠, 적었다면 연락 메일, 인증서에 넣을 이름들. Let's Encrypt 는 이 기기의 인터넷 주소를 보고, 확인하려고 이 기기의 80번 문에 들어옵니다. 발급된 인증서는 공개 기록(CT 로그)에 실립니다 — 주소 이름이 공개된다는 뜻입니다. 우리 서버는 아무것도 보지 못합니다. |
| 얼마 동안 | acme remove 이름 으로 갱신을 멈추고, 파일을 지울 때까지. |
| 끄는 법 | acme add 를 하지 않으면 아무것도 보내지 않습니다. crontab -e 에서 acme renew 줄을 지우면 자동 갱신이 멈춥니다. |
| 인터넷이 없을 때 | acme 가 까닭을 한 줄로 말하고 끝납니다. 가진 인증서로 httpsd 는 계속 돕니다. |
자주 묻는 것
인증서를 받으려면 80번이 필요한가요?
지금은 그렇습니다(HTTP-01 확인). 80번을 못 여는 곳이나 *.내주소.kr 같은 와일드카드는 DNS-01 확인이 필요한데, 그 자리는 만들어 두었지만 DNS 업체와 잇는 플러그인은 아직 없습니다. 그 경우 acme 는 까닭을 그대로 말합니다.
인증서가 곧 끝나면 어떻게 알 수 있나요?
비서의 점검(os_check)에 「HTTPS 인증서」 줄이 있습니다: 20일 아래면 주의, 7일 아래면 흠, 자동 갱신이 실패하면 그 까닭과 함께 주의로 보입니다.
왜 TLS 1.0·1.1 은 안 받나요?
오래된 방식이라 안전하지 않고, 지금의 브라우저는 모두 1.2 나 1.3 을 씁니다.
내 열쇠가 새지는 않나요?
열쇠 파일은 본인만 읽을 수 있게(600) 두고, 다른 사람이 읽을 수 있으면 httpsd 가 쓰지 않습니다. 열쇠 내용은 어디에도 찍지 않습니다.
NanumOS 0.1.8349 · 2026-11-16