지원 티켓에 최소 HTML 버그 재현 링크를 안전하게 첨부하기

버그를 HTML 파일 하나로 줄이고 개인정보를 대체한 뒤 예상·실제 결과와 재현 순서를 적어 짧게 만료되는 검증된 URL로 공유합니다.

좋은 지원 링크는 한 가지 버그를 가장 적은 코드와 개인정보 없는 데이터로 재현합니다. 검토자가 할 일, 기대 결과, 실제 결과, 시험 환경을 바로 알 수 있어야 합니다. 운영 페이지 전체 복사는 원인을 숨기고 노출 위험만 키웁니다.

공유 전에 줄입니다

  1. 새 로컬 HTML에 실패를 복사합니다.
  2. 무관한 프레임워크, 컴포넌트, 스타일, 데이터를 제거합니다.
  3. 이름, 이메일, ID, URL, 토큰, 고객 내용을 fixture로 바꿉니다.
  4. 운영 API 호출은 결정적인 로컬 응답으로 대체합니다.
  5. 버그가 여전히 발생하는지 확인합니다.
  6. 의존성 하나를 더 지우고 다시 시험합니다.
  7. 기대·실제 결과, 순서, 브라우저, viewport, 날짜를 페이지 위에 적습니다.

최소 재현 예제는 문제를 보여주는 데 필요한 코드는 남기고 원인과 무관한 것은 제거합니다.

페이지 안에 재현 계약을 둡니다

기대: Escape를 누르면 dialog가 닫히고 Open 버튼으로 focus가 돌아간다.
실제: dialog는 닫히지만 focus가 body로 이동한다.
순서: dialog 열기 → Escape → Tab.
환경: Chrome desktop, 2026-08-12.

console 출력은 필요한 것만 남깁니다. 분석 ID, session storage 전체, 요청 헤더, 운영 로그를 넣지 않습니다.

미리보기 경계를 압니다

HTML2WEB은 격리 뷰어에서 인라인 HTML·CSS·스크립트를 실행하지만 외부 연결을 막습니다. 한 파일로 재현되는 브라우저 문제에 맞습니다. 인증 API, cookie, service worker, CORS, 서버 렌더링, 이메일, 운영 DB 상태는 여기서 정확히 재현할 수 없습니다.

백엔드를 제거하면 버그도 사라지는 경우에는 지원팀의 승인된 보안 채널로 저장소 fixture나 스테이징을 제공합니다.

게시 후 검증

  • 비밀값과 개인정보를 검색합니다.
  • 짧은 만료를 고릅니다.
  • HTML 한 파일을 게시합니다.
  • 시크릿 창에서 같은 순서를 반복합니다.
  • 관리 URL은 비공개로 둡니다.
  • 공개 URL과 간결한 절차만 티켓에 붙입니다.
  • 분석이 끝나면 삭제합니다.

만료와 삭제도 이미 내려받은 사본은 회수하지 못합니다. 자격증명은 게시하지 말고 노출됐다면 교체합니다.

HTML-to-URL 도구로 재현 링크를 만들 수 있습니다. 로컬 CSS·이미지부터 깨진다면 file:// 자산 공유 가이드를 먼저 확인하세요.

이 글의 목차