NanumOS

HTTPS 웹 서버와 자동 인증서 — 내 기기가 안전한 웹 앞문이 되기

이 기능은

나눔OS 는 웹 사이트를 직접 HTTPS 로 내보낼 수 있습니다. httpsd 가 암호화된 연결(TLS 1.3·1.2)을 받고, acme 가 Let's Encrypt 에서 무료 인증서를 받아 두었다가 만료 전에 알아서 새로 받습니다. 다른 앞문 프로그램(리버스 프록시) 없이 나눔OS 하나가 사이트를 받습니다.

기초

인증서는 「이 주소의 주인이 맞다」는 신분증, TLS 는 그 신분증을 보여 준 뒤 잠그는 봉투에 비유할 수 있습니다. 신분증을 내주는 곳(Let's Encrypt)은 「그 주소의 80번 문에 내가 준 쪽지를 붙여 보라」고 하고, 나눔OS 가 그 쪽지를 붙여 보이면 신분증을 줍니다. 지금 할 일: 터미널에서 acme status 를 쳐서 받아 둔 인증서가 있는지 보세요.

쓰는 법

작동 원리

손님(브라우저)이 연결하면 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