운영·보안

블로그 글에 서버 정보가 들어갔을까, 발행 전 보안 검토 규칙을 만들었습니다

목차 보기

minml에 서버 작업 과정을 설명하는 글을 연달아 작성하던 때였습니다. SSH로 상태를 확인한 명령, 정적 사이트 파일 권한을 고친 방법과 월간 유지보수 결과까지 실제 경험을 넣으니 글은 구체적이 됐습니다. 그런데 발행 직전에 새로운 질문이 생겼습니다.

“이 글에 공개하면 안 되는 서버 정보가 들어가 있지는 않을까?”

기술 글은 실제 명령과 결과를 보여줄수록 유용해집니다. 동시에 터미널 출력을 그대로 붙이면 서버 IP, 호스트 이름, 계정, 내부 경로와 로그 속 개인정보까지 함께 공개될 수 있습니다. 명령 자체는 평범해도 결과가 민감할 수 있고, Markdown 원문에서는 보이지 않던 값이 빌드된 HTML이나 이미지 메타데이터에 남을 수도 있습니다.

그래서 글을 커밋하고 배포하기 전에 별도의 보안·개인정보 검토 단계를 만들었습니다. 처음에는 그때그때 패턴을 검색하고 사람이 읽는 방식이었고, 2026년 9월 26일부터는 같은 검사를 스크립트로 고정했습니다. 그 스크립트를 처음 돌렸을 때 이미 발행한 글에서 수동 검토가 놓친 값이 하나 나왔습니다.

명령어와 실제 출력의 구분

예를 들어 서버에 접속해 호스트 이름과 웹 서버 상태를 확인하는 구조는 다음처럼 설명할 수 있습니다.

ssh example-server "hostname; systemctl is-active example-service"

example-server와 example-service는 설명용 값이므로 이 명령만으로 실제 서버에 접근할 수 없습니다. 하지만 운영 환경에서 실행한 결과를 그대로 붙이면 비공개 호스트 이름과 서비스 구성이 나타날 수 있습니다. 터미널 프롬프트까지 복사했다면 계정명과 현재 디렉터리가 함께 보일 수도 있습니다.

그래서 명령과 출력을 다음처럼 구분합니다.

구분 발행할 때 처리
일반적인 명령 구조 독자가 이해할 수 있도록 유지
실제 접속 대상 example-server 같은 값으로 교체
실제 계정·호스트 이름 제거하거나 역할만 설명
내부 절대 경로 공개용 예시 경로로 변경
상태 결과 active, 200처럼 설명에 필요한 값만 유지
원문 로그 그대로 붙이지 않고 필요한 행만 다시 작성

찾는 정보의 네 종류

모든 서버 관련 숫자를 무조건 지우면 실제 경험이 사라지고 글이 다시 일반론이 됩니다. 반대로 “비밀번호만 아니면 괜찮다”고 생각하면 불필요한 접근 정보와 개인정보가 남을 수 있습니다. 그래서 발견한 값을 네 종류로 나눠 처리합니다.

1. 발견 즉시 제거하고 교체해야 하는 비밀

비밀번호와 데이터베이스 자격 증명, API 키와 액세스 토큰, SSH 개인키, 쿠키와 세션 식별자, 인증서 개인키와 복구 코드입니다. 이 값은 일부를 가리는 것만으로 충분하지 않을 수 있습니다. 이미 공개 저장소나 웹페이지에 올라갔다면 원문에서 지우기 전에 해당 자격 증명을 폐기하거나 교체해야 합니다.

2. 공개 승인을 받지 않은 개인정보

개인 이메일과 전화번호, 실명, 주소와 계정 식별자, 로그에 포함된 방문자 IP와 요청값, 브라우저 화면에 보이는 로그인 계정, QR 코드입니다. 작성자 이름이나 사이트의 공개 문의 주소처럼 이미 의도적으로 공개한 정보는 글에 필요할 때 유지하지만, 터미널 로그에 우연히 들어간 주소와 연락처까지 공개 정보로 보지는 않습니다.

3. 설명에 필요하지 않은 운영 정보

  • 실제 서버 IP와 비공개 호스트 이름
  • SSH 별칭, 사용자 이름과 키 파일 위치
  • 로컬 홈 디렉터리와 서버 내부 절대 경로
  • 정확한 방화벽 구성과 불필요한 포트 정보
  • 계정 구조와 서비스 간 내부 연결
  • 설명에 필요하지 않은 세부 패치 버전

이 정보가 모두 비밀키처럼 즉시 악용되는 것은 아닙니다. 하지만 독자가 글의 핵심을 이해하는 데 필요하지 않다면 최소한으로 줄입니다.

4. 근거로 유지할 수 있는 공개·집계 정보

의도적으로 공개한 사이트 도메인, 200·301·404 같은 HTTP 상태, 문제 전후의 파일 개수처럼 개인을 식별하지 않는 집계값, 일반적인 서비스와 명령 이름입니다. 예를 들어 개인 사이트 유지보수 체크리스트의 디스크 사용 비율과 보관 릴리스 개수는 유지했습니다. 특정 계정이나 경로를 알려주지 않으면서 “왜 지금 삭제하지 않고 관찰 대상으로 남겼는가”를 설명하는 근거였기 때문입니다.

첫 적용에서 바꾼 내용

이 규칙을 처음 적용한 대상은 유지보수 체크리스트 글이었습니다. 자동 검색에서는 키, 토큰, 실제 IP와 계정 정보가 발견되지 않았습니다. 그래도 수동으로 다시 읽으면서 정확한 커널 패치 버전이 적혀 있는 문장을 찾았습니다.

커널 버전은 비밀번호가 아니고 서버에 접속할 방법도 아닙니다. 하지만 그 글에서 독자에게 필요한 결론은 “업데이트 뒤 재부팅이 필요한가”였습니다. 정확한 패치 문자열이 없어도 판단 과정은 설명할 수 있었기 때문에, 버전을 삭제하고 재부팅 필요 표시가 없었다는 결과만 남겼습니다.

명령 예시의 인증서 경로는 실제 도메인 대신 example.com을 사용했습니다. 반면 공개 사이트의 HTTP 상태, 디스크 비율과 인증서 잔여일처럼 판단 근거가 되는 집계 결과는 유지했습니다.

원문과 렌더링 HTML

Astro 글은 Markdown으로 작성하지만 방문자가 받는 것은 빌드된 HTML입니다. 테마의 공통 스크립트, 메타 태그와 이미지 경로가 합쳐진 최종 결과는 원문과 다릅니다. 그래서 작성한 Markdown 원문과 Astro가 생성한 해당 글의 index.html을 각각 검사했습니다.

8월에 처음 렌더링 HTML을 검사했을 때는 HostName이라는 문자열이 잡혔습니다. 문맥을 열어보니 실제 호스트 이름이 아니라 페이지 공통 JavaScript의 location.hostname이었습니다. 자동 검사는 사람이 놓치기 쉬운 문자열을 빠르게 찾지만, 일치 결과가 실제 유출인지는 문맥을 열어 판단해야 한다는 것을 보여준 오탐이었습니다.

GitHub 공식 문서도 Secret Scanning이 지원하는 비밀 형식과 탐지 조건에 따라 작동한다고 설명합니다. 일부 자격 증명은 ID와 비밀값이 같은 파일에 함께 있어야 탐지되고, 지원하지 않는 형식은 잡히지 않을 수 있습니다. 스캐너가 조용하다는 사실만으로 공개해도 된다고 판단하지 않는 이유입니다.

자동 검사 스크립트와 실행 결과

매번 검색어를 새로 떠올리면 빠지는 항목이 생깁니다. 그래서 2026년 9월 26일 저장소에 scripts/privacy-scan.mjs를 추가했습니다. 기본 실행은 draft: true가 아닌 글과 페이지의 Markdown 전체를 frontmatter까지 한 줄씩 검사하고, 찾는 패턴은 다음과 같습니다.

분류 찾는 형태
네트워크 IPv4 주소, 호스트:포트 형태, 사이트 도메인의 하위 도메인
개인정보 이메일 주소
키·토큰 개인 키 헤더, SSH 공개 키, SHA256: 키 지문, 알려진 API 키·토큰 접두사
경로 Windows 절대 경로, 홈·관리자 디렉터리, 웹 루트·인증서·Nginx 설정 경로
SSH Host·HostName·IdentityFile·User 설정 줄, 백틱 뒤에 “별칭”이 붙은 표현, ssh 명령의 실제 대상

경로와 SSH 대상 패턴은 example이나 <로 시작하는 플레이스홀더를 건너뛰도록 만들었습니다. 사이트의 공개 문의 주소처럼 의도적으로 공개한 값은 허용 목록에 따로 적었습니다. 예를 들어 SSH 별칭 후보는 다음 한 줄로 찾습니다.

["SSH 별칭 후보", /`(?!<)[A-Za-z0-9_.-]+`\s*(?:별칭|alias)/gi],

이미지는 featureImage·ogImage 같은 frontmatter 이미지와 본문 이미지 경로를 모은 뒤 sharp로 메타데이터를 읽어 EXIF, XMP, IPTC 블록이 있으면 후보로 올립니다. sharp 문서에 따르면 metadata()는 압축된 픽셀을 디코딩하지 않고 이미지 헤더에서 이 값들을 읽습니다(2026년 9월 26일 확인).

const metadata = await sharp(file).metadata();
const embedded = ["exif", "xmp", "iptc"].filter((key) => metadata[key]);

옵션은 두 개입니다. --include-drafts는 초안까지 검사 대상에 넣고, --dist는 빌드된 HTML에서 <script> 블록과 태그를 지워 방문자가 읽는 텍스트만 남긴 뒤 같은 패턴을 적용합니다. 8월에 오탐이 나왔던 location.hostname은 인라인 스크립트 안에 있으므로 이 방식에서는 검사 대상이 아닙니다. 후보가 하나라도 있으면 종료 코드 1로 끝나고, 후보가 없어도 “문맥 검토는 따로 진행하세요”라는 문장을 출력합니다.

이 스크립트를 만든 계기는 같은 날 사이트 전체를 다시 읽으며 찾은 값 하나였습니다. AI에게 SSH 서버 작업을 맡길 때 확인하는 7가지의 본문에 실제 SSH 별칭이 백틱 안에 그대로 남아 있었습니다. 그 글은 8월 27일 발행 직후 한 차례 접속 정보를 일반화했고 명령 예시에는 이미 <서버별칭>을 쓰고 있었지만, 샌드박스 승인 과정을 설명하는 문장 속 별칭 하나는 그 작업과 이후 수동 검토에서 모두 빠졌습니다.

처음 만든 패턴 목록으로는 이 값을 찾지 못했습니다. ssh 명령이나 설정 줄이 아니라 평범한 문장 속 백틱에 들어 있었기 때문입니다. 그래서 위의 별칭 후보 패턴을 추가했습니다. 첫 버전은 반대로 본문 코드 예시 속 이미지 경로까지 이미지로 모아 “파일을 읽을 수 없음” 오탐을 5건 냈고, frontmatter와 본문 이미지 문법만 읽도록 고쳤습니다. 두 가지를 고친 뒤의 결과는 다음과 같았습니다.

node scripts/privacy-scan.mjs
검사한 이미지: 21개
사람이 확인할 후보: 1건
- src\content\posts\ai-ssh-server-work-checklist.md:<줄 번호> [SSH 별칭 후보] <값 생략>

그 값을 같은 플레이스홀더로 바꾼 뒤 다시 실행하자 후보는 0건이었습니다.

이번 일로 역할이 분명해졌습니다. 패턴 검사는 이미 아는 형태를 빠짐없이 반복해서 찾는 데 강하고, 처음 보는 형태는 사람이 읽어서 찾아야 합니다. 그래서 사람이 새 유형을 찾으면 다음부터는 자동으로 걸리도록 패턴에 옮겨 두는 방식으로 두 단계를 연결했습니다.

규칙 파일과 자동 검사가 못 하는 일

프로젝트의 AGENTS.md에는 글을 쓴 뒤와 고친 뒤마다 이 검토를 반복하고, 검토가 끝나기 전에는 커밋이나 배포를 하지 않는다는 규칙을 넣었습니다. 그래도 자동 검사는 “이 문자열을 확인해보라”고 알려줄 뿐 공개할 가치와 위험을 대신 판단하지 못합니다. 스크립트가 조용해도 사람이 따로 읽는 항목은 다음과 같습니다.

  • 문장으로 풀어 쓴 서버 구조와 서비스 간 연결
  • 설명에 필요 이상으로 자세한 버전, 포트와 방화벽 구성
  • 이미지 화면 속 글자, 주소창, 계정, QR 코드
  • 캡션과 대체 텍스트에 들어간 실제 도구·서버 이름
  • 패턴에 없는 형식의 별칭이나 식별자

대표 이미지는 실제 화면을 캡처하지 않고 글자, 숫자, 코드와 주소가 없는 3D 이미지로 만듭니다. AI 블로그 대표 이미지 스타일 가이드의 글자·로고 금지 규칙이 이 점검에도 도움이 됐습니다.

공개 뒤 비밀을 발견했을 때

커밋 전에 발견했다면 원문을 고치고 다시 검사하면 됩니다. 하지만 실제 키나 토큰이 이미 저장소나 웹페이지에 공개됐다면 글에서 문자열을 지우는 것만으로 끝나지 않습니다. 복사본, Git 기록과 캐시에 값이 남아 있을 수 있기 때문입니다.

GitHub의 민감정보 제거 안내는 비밀번호·토큰·자격 증명이 노출됐다면 먼저 폐기하거나 교체하라고 권합니다. 그다음 필요하다면 저장소 기록 제거를 검토합니다. Git 기록을 다시 쓰는 작업은 커밋 해시와 협업자의 복제본에도 영향을 주므로, 명령 하나를 복사해 실행할 작업으로 다루지 않습니다. 제가 정한 순서는 다음과 같습니다.

  1. 노출된 키·토큰·비밀번호를 즉시 폐기하거나 교체
  2. 공개 페이지와 현재 소스에서 해당 값 제거
  3. 배포본, 캐시와 검색 노출 범위 확인
  4. Git 기록과 다른 복제본에 남았는지 조사
  5. 영향 범위를 확인한 뒤 기록 정리 방법 결정
  6. 같은 유형을 자동 검사 패턴에 추가

OWASP의 비밀정보 관리 안내도 로그에 비밀값이 들어갔을 때 로그의 무결성을 유지하면서 해당 값을 제거할 절차가 필요하다고 설명합니다. 그래서 실제 로그 전체를 글에 붙이지 않고, 필요한 결과만 개인·접근 정보를 제외한 문장이나 표로 다시 작성합니다.

참고한 공식 자료