인증서 만료를 놓친 뒤, 기억 대신 확인하는 도구를 만들었다

인증서 만료를 놓친 경험에서 출발해 도메인·SSL 인증서 만료를 자동으로 확인하고, 계약이나 교체 주기처럼 직접 챙겨야 하는 날짜도 함께 알려 주는 아차를 만들었다. 서버 체크·하트비트·웹 크론으로 지금 상태와 정해진 작업까지 같은 곳에서 본다.

서기 14분 분량 조회 35
아침 햇살이 드는 부엌 조리대에서 머그잔을 든 여성이 노트북을 내려다보며 확인하는 모습

인증서에는 끝나는 날짜가 있었다

서비스를 만들고 운영하다 보면 신경 쓸 일이 많다. 기능을 고치고, 사용자의 문의를 받고, 데이터를 확인하고, 다음 작업을 준비한다. 당장 눈앞에 있는 일부터 처리하다 보면 자주 돌아오지 않는 일은 뒤로 밀린다.

나도 인증서 만료를 놓친 적이 있다. 인증서에 유효기간이 있다는 것을 몰라서가 아니었다. 알고 있는 것과 제때 챙기는 것은 달랐다. 머릿속에 넣어 두었다고 생각한 날짜도 다른 일을 하다 보면 지나간다.

이 글에서 이야기하려는 것은 큰 장애를 겪었다는 이야기가 아니다. 내가 놓친 것은 인증서의 만료였고, 그 경험을 통해 확인할 날짜를 기억에만 맡기는 방식이 불편하다고 느꼈다.

프로그램을 고치는 일과 프로그램을 계속 쓸 수 있게 관리하는 일은 다르다. 새 기능을 만들 때는 눈에 보이는 결과가 남지만, 만료일을 확인하는 일은 문제가 없으면 아무 일도 일어나지 않는다. 그래서 오히려 놓치기 쉬웠다.

날짜를 달력에 적으면 끝날까

가장 간단한 방법은 달력에 만료일을 적어 두는 것이다. 한 달 전이나 일주일 전에 알림을 받으면 된다. 관리할 것이 몇 개 없다면 충분히 좋은 방법이다.

그런데 날짜가 바뀌면 달력도 고쳐야 한다. 도메인을 연장했거나 인증서가 새로 발급됐다면 이전에 적은 날짜는 더 이상 맞지 않을 수 있다.

반대로 자동 갱신을 설정해 두었더라도, 설정했다는 사실만으로 실제 갱신이 끝났다고 볼 수는 없다. 작업이 실패하거나 인증서 적용 과정에 문제가 생길 수도 있다. 내가 만료를 놓쳤던 원인이 자동 갱신 실패였다는 뜻은 아니다. 날짜 관리 도구를 생각하면서 함께 확인해야겠다고 본 부분이다.

알림을 만들어 놓고도 그 알림의 날짜를 다시 관리해야 한다면 손이 남는다. 도메인이나 인증서처럼 바깥에서 확인할 수 있는 정보는 프로그램이 직접 알아오면 어떨까. 그 생각을 바탕으로 만든 서비스가 아차(아차.com)다.

도메인 이름만 넣고 시작한다

아차에서는 도메인을 등록하면 도메인 만료일과 SSL 인증서 정보를 조회한다. 사람이 날짜를 찾아 입력하는 대신, 도메인 이름을 출발점으로 삼았다.

도메인이 여러 개라면 줄바꿈이나 쉼표로 구분해 한 번에 넣을 수 있다. 서비스별로 등록기관에 들어가 날짜를 확인하고 따로 옮겨 적는 작업을 줄이려는 방식이다.

도메인 만료일은 RDAP을 먼저 조회하고, 확인되지 않으면 WHOIS로 조회한다. 두 용어를 알아야 서비스를 쓸 수 있는 것은 아니다. 도메인 등록 정보를 확인하는 경로를 순서대로 이용한다고 이해하면 된다.

도메인과 인증서는 돋보기가 돌며 자동으로 확인하고, 달력·필터·선물 상자 같은 날짜는 손으로 적어 넣어 두 흐름이 봉투 하나로 모이는 그림

등록한 뒤에도 처음 확인한 날짜를 계속 쓰는 것은 아니다. 남은 기간에 따라 다시 조회하고, 만료가 가까워질수록 더 자주 확인한다. 도메인을 연장해 만료일이 늘어나면 바뀐 날짜와 갱신 기록을 반영한다. 사용자가 관리할 것은 도메인 목록이고, 바깥에서 알아낼 수 있는 날짜는 아차가 다시 확인하는 구조다.

발급 기록보다 지금 쓰는 인증서를 본다

SSL 인증서는 서버에 접속해 실제로 사용 중인 인증서의 만료일을 읽는다. 인증서가 새로 발급된 것과 서비스에 새 인증서가 적용된 것은 같은 이야기가 아니다. 그래서 외부에서 접속했을 때 서버가 어떤 인증서를 보여 주는지 확인하는 것이 중요하다.

직접 읽을 수 없는 서버는 인증서 투명성 로그를 바탕으로 추정한다. 여기에는 차이가 있다. 서버에서 직접 확인한 정보와 발급 로그를 통해 추정한 정보는 근거가 다르다. 로그에 새 인증서가 있다고 해서 서버에도 적용됐다고 단정할 수는 없다.

아차를 소개할 때도 이 부분은 구분해서 설명하고 싶었다. 자동으로 확인한다는 말이 모든 환경에서 같은 방식으로 완벽하게 알아낸다는 뜻은 아니다. 확인할 수 있는 경로를 이용하되, 정보가 어디에서 왔는지 이해할 필요가 있다.

만료일만 보는 것도 아니다. 인증서에 적힌 도메인 이름이 접속한 주소와 맞지 않거나, 중간 인증서가 빠져 있거나, 발급기관이 바뀌면 다음 날 알린다. 만료일이 넉넉해도 브라우저나 일부 기기에서 경고가 뜰 수 있는 상태라서 함께 넣었다.

홈페이지가 아닌 메일서버에도 인증서가 있다

인증서라고 하면 보통 브라우저 주소창의 HTTPS를 먼저 떠올린다. 하지만 메일을 주고받는 서버에도 인증서가 쓰인다.

아차는 호스트 이름 뒤에 포트를 붙여 메일서버 인증서도 확인할 수 있게 했다. 예를 들어 mail.example.com:993처럼 등록하는 방식이다. 993, 465, 995, 8443 같은 암호화 연결 포트뿐 아니라, 587, 143, 110처럼 STARTTLS로 암호화 연결로 전환하는 방식도 지원한다. 다만 25번 포트는 현재 실행 환경의 정책상 접속할 수 없다.

이 기능이 있다고 메일 시스템 전체를 검사하는 것은 아니다. 메일이 실제로 수신되는지, 모든 발송이 정상인지까지 보증하는 도구는 아니다. 여기서 확인하는 것은 지정한 서버와 포트에서 쓰는 인증서다. 홈페이지 주소만 챙기다 빠뜨릴 수 있는 확인 대상을 함께 넣어 두고 싶었다.

만료일이 남았는데도 문제가 생길 수 있다

도메인을 오래 연장해 놓았다고 해서 모든 관리가 끝나는 것은 아니다. 만료일 외에도 살펴볼 변화가 있다.

아차는 도메인의 삭제 예정 상태, 만료 뒤 복구 기간, 사용 정지, 이전 잠금 해제 같은 상태 변화를 확인한다. 네임서버가 바뀌었는지도 이전 조회 결과와 비교한다. 메일 관련 DNS도 본다. 메일을 받을 서버를 지정하는 MX, 발송 서버를 확인하는 데 쓰이는 SPF, 메일 인증 결과에 대한 처리 정책을 정하는 DMARC 레코드가 바뀌거나 사라지는지 확인한다. 메일 서명에 쓰는 DKIM(많이 쓰는 셀렉터)과 인증서를 발급할 수 있는 기관을 정하는 CAA도 본다. 접속 주소인 A·AAAA 레코드는 이전 주소와 하나도 겹치지 않게 바뀌었을 때만 알린다. 서버를 여러 대 두고 주소가 조금씩 바뀌는 경우까지 매번 알리면 소음이 되기 때문이다.

물론 변경이 발견됐다고 곧바로 사고라는 뜻은 아니다. 호스팅을 옮기면서 네임서버를 바꿨을 수도 있고, 메일 서비스를 변경하면서 DNS를 수정했을 수도 있다. 이전 잠금을 의도적으로 해제하는 경우도 있다.

중요한 것은 내가 알고 바꾼 것인지 확인할 기회다. 만료까지 며칠 남았는지만 알려 주는 데서 그치지 않고, 운영 중에 달라진 조건도 함께 알려 주도록 했다.

날짜가 아니라 지금 상태를 봐야 하는 일

만료일을 챙기다 보니 날짜와는 다른 종류의 확인도 필요했다. 인증서가 멀쩡해도 서버가 멈추면 서비스는 열리지 않는다. 그래서 서버 체크를 넣었다. example.com:22, db.example.com:3306처럼 호스트 이름과 포트를 넣으면 그 포트에 TCP 연결이 되는지 보고, https:// 주소를 넣으면 응답 코드와 응답 시간을 본다.

확인 간격은 무료 10분부터, 베이직 5분, 프로 1분까지 고를 수 있다. 첫 실패가 나면 1분 뒤 다시 확인하고, 두 번 연속 실패해야 장애로 알린다. 한 번 튄 실패로 알림이 오지 않게 하려는 장치다. 복구되면 다시 알린다. 응답이 기준(0.5~5초)보다 두 번 연속 느리면 느림 알림을 보내고, URL 체크는 응답에 있어야 할 글자와 있으면 안 되는 글자로도 판단할 수 있다.

운영하다 보면 일부러 서버를 내리는 때도 있다. 서버마다 30분에서 4시간까지 점검 시간을 걸면 그동안은 알림을 보내지 않는다. 조용한 시간을 정해 두면 그 시간에는 급한 알림만 푸시로 보낸다. 다만 바깥에서 접속해 보는 방식이라 공개된 주소만 확인할 수 있고, 내부망이나 localhost는 등록할 수 없다.

바깥에서 볼 수 없는 작업은 신호로 확인한다

서버 체크는 바깥에서 문을 두드려 보는 방식이다. 그런데 백업 스크립트나 매일 도는 배치 작업은 문이 없다. 돌았는지 안 돌았는지는 작업 쪽에서 알려 주지 않으면 모른다. 그래서 하트비트를 만들었다.

하트비트를 만들면 신호 주소가 하나 생긴다. 작업이 끝날 때 그 주소를 한 번 부르게 해 두면, 정한 간격(5분~1주)과 기다려 주는 시간(1분~6시간) 안에 신호가 오지 않을 때 장애로 알린다. 신호가 다시 오면 복구 알림이 간다. 작업이 실패했다는 걸 스스로 알면 주소 끝에 /fail을 붙여 불러 바로 실패 알림을 보낼 수도 있다.

신호를 보내는 쪽이 바깥으로 나가기만 하면 되기 때문에 내부망 서버의 작업도 확인할 수 있다. 서버 체크로 볼 수 없던 영역을 반대 방향에서 채운 셈이다.

정한 시각에 대신 불러 주는 웹 크론

반대로 아차가 먼저 부르는 기능도 있다. 웹 크론은 정해진 시각마다 지정한 URL을 호출한다. N분마다, 매시간, 매일, 매주, 매월 중에서 고르거나 5칸짜리 cron 식을 한국 시간 기준으로 넣으면 된다. 서버에 crontab을 둘 수 없는 호스팅이나, 서버 바깥에서 정시에 불러야 하는 작업에 쓴다.

호출 방식은 GET부터 DELETE, HEAD까지 고를 수 있고 요청 헤더도 10개까지 붙인다. 기본으로 2xx·3xx 응답은 성공, 4xx·5xx나 시간 초과는 실패로 본다. 성공으로 볼 상태 코드를 따로 정하거나 응답에 있어야 할 글자로 판단하게 할 수도 있다. 실패하면 5초 간격으로 0~3번 다시 시도하고, 바로 또는 2·3·5번 연속 실패했을 때 알리도록 정할 수 있다. N번 연속 실패하면 저절로 꺼지게도 할 수 있고, 최근 50건의 실행 기록이 남는다.

주소와 본문, 헤더에는 {{date}}, {{yesterday}}, {{month_start}} 같은 날짜 변수를 한국 시간으로 넣을 수 있다. 설·추석·대체공휴일·선거일 같은 한국 공휴일을 건너뛰는 설정과, 한 번만 실행하고 꺼지는 예약 실행도 있다. 이 블로그의 검색엔진 색인 요청도 매일 아침 아차의 웹 크론이 부르고 있다.

급한 경보와 아침에 확인하는 메일은 다르다

알림을 많이 보내면 더 안전할 것 같지만, 너무 자주 오는 메일은 읽지 않게 된다. 여러 도메인에서 각각 알림이 오면 중요한 내용이 다른 안내에 묻힐 수도 있다. 그래서 알림을 성격에 따라 두 갈래로 나눴다.

만료처럼 미리 챙기면 되는 일은 그날 알릴 내용을 모아 한국 시간 오전 9시에 한 번에 보낸다. 알릴 내용이 있는 날에만 보내는 방식이다. 만료 알림은 30일 전, 7일 전, 1일 전처럼 받을 시점을 설정할 수 있다. 도메인 상태나 DNS 변화는 감지한 내용을 다음 날 아침 알림 맨 위에 넣는다.

서버 장애, 하트비트 신호 끊김, 웹 크론 실패는 기다릴 이유가 없어서 생기는 즉시 알린다. 받는 곳은 이메일(함께 받을 주소 최대 3개)과 푸시 알림이 기본이고, 슬랙·디스코드·텔레그램·웹훅을 최대 5곳까지 더 연결할 수 있다. 아차는 PWA라 앱 스토어 없이 안드로이드·PC 크롬·엣지에서는 [앱 설치]로, 아이폰에서는 사파리 [홈 화면에 추가]로 설치해 푸시를 받는다. 아침에 한 번 볼 것과 지금 바로 봐야 할 것을 섞지 않는 것이 이 구분의 목적이다.

자동으로 알 수 없는 날짜도 있었다

도메인 만료일은 외부에서 조회할 수 있다. 하지만 내 계약이 언제 끝나는지, 정수기 필터를 언제 갈았는지는 도메인을 넣는다고 알아낼 수 없다. 그래서 밖에서 조회할 수 없는 날짜는 직접 등록하도록 했다.

계약 만료일이나 무료체험 종료일처럼 한 번만 챙기면 되는 날짜가 있다. 생일처럼 해마다 돌아오는 날짜도 있고, 몇 개월 또는 며칠마다 반복해야 하는 일도 있다. 아차에서는 이런 반복 방식을 나눠 등록할 수 있다.

생일과 제사를 챙길 때 필요한 음력 날짜와 윤달도 지원한다. 매년 양력 날짜를 다시 찾아 달력에 옮겨 적는 일을 줄이려는 기능이다. 계약서나 보증서처럼 날짜와 함께 봐야 하는 서류는 알림마다 사진이나 PDF를 10개까지 붙여 둘 수 있고, 본인만 열어 볼 수 있다. 자동 확인과 직접 입력은 서로 다른 방식이지만 목적은 같다. 필요한 시점이 왔을 때 사용자가 떠올릴 수 있게 하는 것이다.

필터 교체는 생일과 달랐다

반복 알림이라고 모두 같은 방식으로 계산할 수는 없다. 생일은 정해진 날짜에 돌아온다. 하지만 필터 교체는 실제로 언제 교체했는지가 다음 주기의 기준이 될 수 있다. 예정일보다 늦게 바꿨는데도 다음 알림이 예전 일정대로 잡히면 실제 사용 기간과 어긋난다.

필터를 예정보다 늦게 교체한 날에 체크 표시가 있고, 그 날부터 새 주기 화살표가 다시 시작되며 예전 고정 일정은 점선으로 남아 있는 그림

아차의 교체형 항목은 완료 처리한 날을 기준으로 주기를 다시 시작한다. 작은 차이지만 날짜를 관리하는 목적을 생각하면 필요한 구분이었다. 달력에 같은 간격으로 표시하는 것과, 실제 작업이 끝난 시점을 기준으로 다음 일을 챙기는 것은 다르다.

자동으로 조회할 수 없는 일도 마지막으로 한 날짜와 반복 주기를 남겨 두면 기억해야 할 부담을 줄일 수 있다.

개발자도 날짜를 챙겨야 한다

직접 입력하는 기한은 생활 속 날짜에만 해당하지 않는다. 개발자에게도 API 키와 액세스 토큰 만료, 코드 서명 인증서, 개발자 멤버십 갱신, 서버 계약 만기처럼 가끔 돌아오는 일이 있다. 백업 복구 점검처럼 만료일은 없어도 정기적으로 해야 하는 일도 있다.

아차에는 이런 항목을 등록할 때 참고할 수 있는 가이드와 템플릿을 마련했다. 다만 템플릿의 주기가 모든 사람에게 맞는 정답은 아니다. 실제 계약, 발급기관, 서비스 설정에 따라 날짜와 주기를 확인해 등록해야 한다.

API 토큰이나 계약 정보를 아차가 자동으로 찾아온다는 뜻도 아니다. 이런 항목은 사용자가 날짜를 넣어 관리한다. 자동 확인 대상과 직접 입력 대상을 섞어 설명하면 편리함이 과장될 수 있다. 알아낼 수 있는 것은 자동으로 확인하고, 알아낼 수 없는 것은 사람이 알려 주는 선을 분명하게 두었다.

알림 밖에서 쓰는 기능들

알림을 받는 것만으로 끝나지 않는 일도 있었다. 고객사 서비스를 운영하면 지금 정상인지 묻는 연락을 받는다. 상태 페이지를 만들면 /status/이름 주소에 고른 서버 체크와 하트비트의 지금 상태, 최근 90일 가동률이 나온다. 서버 주소와 오류 내용은 감추고 이름과 상태만 보여 준다. 매달 1일에는 지난달 가동률 리포트도 메일로 온다.

날짜는 결국 달력에서 보고 싶어 하는 사람이 많다. 캘린더 구독 주소(ICS)를 구글·애플·아웃룩 캘린더에 넣으면 직접 입력 알림의 다음 날짜와 도메인·SSL 만료일이 종일 일정으로 뜬다. 처음에 달력에 적는 방식의 불편함을 이야기했지만, 날짜를 사람이 고치지 않고 아차가 채워 준다는 점이 다르다.

등록과 정리도 손이 덜 가게 했다. 도메인과 서버 체크는 여러 개를 줄마다 붙여 넣어 한 번에 추가하고, 도메인·직접 입력 알림·서버 체크·웹 크론·하트비트 목록은 CSV로 내려받는다. 개발자라면 REST API로 도메인·알림·서버 체크·웹 크론·하트비트를 등록하고 고치고 지울 수 있다. 배포 스크립트에서 새 서비스의 도메인을 바로 등록하는 식으로 쓸 수 있다.

누구에게 필요한 도구일까

직접 서비스를 운영하는 개발자, 여러 사이트를 관리하는 담당자, 고객사 도메인을 함께 챙기는 사람이라면 자동 확인과 서버 체크, 웹 크론을 먼저 쓸 수 있다. 기술적인 서비스를 운영하지 않더라도 계약이나 생활 속 교체 주기를 한곳에 모으고 싶은 사람은 직접 입력 기능을 이용할 수 있다.

도메인·직접 입력 알림·서버 체크·웹 크론을 합쳐 20개까지는 무료다. 더 필요하면 베이직(100개, 월 1,900원)이나 프로(1,000개, 월 9,900원)를 고르면 되고, 요금제마다 기능은 같고 개수와 확인 간격만 다르다. 구글이나 깃허브 계정으로 바로 시작할 수 있다. 처음부터 모든 기한을 등록할 필요는 없다. 놓치면 곤란한 도메인 하나나 자주 잊는 날짜 하나부터 넣어 보면 된다.

도구의 가치는 등록한 항목 수보다, 필요할 때 한 번이라도 제대로 떠올리게 해 주는 데 있다고 생각한다.

회고

인증서 만료를 놓쳤던 경험은 특별히 어려운 기술 문제에서 시작된 것이 아니었다. 알고 있던 날짜를 제때 챙기지 못한 일이었다. 그런 일일수록 다음에는 기억하겠다고 넘어가기 쉽다. 하지만 기억할 것을 줄이는 도구를 만드는 편이 나에게는 더 나은 방법이었다.

아차는 도메인과 인증서처럼 확인할 수 있는 정보는 다시 조회하고, 계약과 교체 주기처럼 밖에서 알 수 없는 날짜는 직접 입력하게 했다. 서로 다른 종류의 기한을 같은 알림 흐름으로 모았다. 그러다 보니 날짜뿐 아니라 서버가 지금 살아 있는지, 정해진 작업이 제때 돌았는지까지 같은 곳에서 보게 됐다.

아차가 도메인을 대신 연장하거나 인증서를 대신 갱신해 주는 것은 아니다. 알림을 확인하고 필요한 조치를 하는 일은 남는다. 다만 언제 무엇을 확인해야 하는지까지 혼자 기억하고 있을 필요는 줄이고 싶었다.

가끔 하는 일은 덜 중요한 일이 아니라, 잊기 쉬운 일일 때가 많다. 아차는 그 일을 놓친 뒤에 떠올리는 대신, 아직 할 수 있을 때 한 번 더 알려 주는 도구가 되었으면 한다.

용어 쉽게 보기

글에 나온 용어를 개발자가 아닌 분도 읽을 수 있게 풀었다.

용어쉬운 설명
SSL 인증서여기서는 웹이나 메일 서버의 신원을 확인하고 암호화 통신을 하는 데 쓰이는 TLS 인증서를 뜻한다. 유효기간이 있다.
RDAP · WHOIS도메인의 등록기관과 만료일 같은 등록 정보를 조회하는 방법.
인증서 투명성 로그인증서 발급 내역을 공개적으로 기록하는 곳. 실제 서버 적용 여부와는 구분해야 한다.
STARTTLS연결을 시작한 뒤 암호화 통신으로 전환하는 방식.
네임서버도메인의 DNS 정보를 안내하는 서버.
MX · SPF · DMARC메일 수신 위치와 발송 인증, 인증 실패 시 처리 정책 등에 사용하는 DNS 정보.
DKIM보내는 메일에 서명을 붙여 위조가 아님을 증명하는 데 쓰는 DNS 정보.
CAA이 도메인의 인증서를 발급할 수 있는 기관을 정해 두는 DNS 정보.
A · AAAA도메인이 가리키는 서버의 접속 주소(IPv4·IPv6).
TCP두 컴퓨터가 연결을 맺고 데이터를 주고받는 기본 방식. 포트에 연결되는지로 서버가 살아 있는지 본다.
하트비트작업이 끝날 때마다 보내는 "살아 있다" 신호. 신호가 끊기면 문제가 생긴 것으로 본다.
웹 크론정해진 시각마다 지정한 주소를 대신 불러 주는 기능.
cron 식"매일 3시"처럼 반복 시각을 숫자 다섯 칸으로 적는 형식.
웹훅일이 생기면 정해 둔 주소로 내용을 자동으로 보내 주는 방식.
PWA앱 스토어 없이 웹사이트를 휴대폰·PC에 앱처럼 설치해 쓰는 방식.
가동률정해진 기간 동안 서비스가 정상으로 열려 있던 시간의 비율.
ICS캘린더 일정을 주고받는 표준 파일 형식. 구독하면 일정이 자동으로 갱신된다.
CSV쉼표로 칸을 나눈 표 파일. 엑셀에서 바로 열린다.
REST API다른 프로그램이 주소를 불러 데이터를 등록·조회·수정하게 해 주는 창구.
공유 X 페이스북

비슷한 시스템을 검토하고 계신가요?

요건 정리 단계부터 함께 봅니다. 구축 범위와 일정, 예상 비용을 무료로 진단해 드립니다.

기술 상담 신청 →