YESHTML5 AI 로 만든 웹 점검·보완·배포

점검 사례

돌아가는 코드와 안전한 코드는 다릅니다

AI 생성 코드에서 흔히 보이는 문제 8가지를 넣은 작은 결제 데모 앱으로 점검 과정을 보여 드립니다. 결제·비밀 키·권한·DB·접근성 문제를 재현하고, 고친 뒤 같은 검사를 다시 돌려 전부 통과한 것을 확인했습니다.

실제 고객 코드가 아닌 판매용 데모입니다. 문제는 일부러 넣었고, 데이터와 키는 모두 가짜입니다. 실제 의뢰에서 문제 수와 종류는 코드마다 다릅니다.

01왜 점검이 필요한가

AI 가 만든 코드는 "화면에서 동작하는가"까지는 잘 맞춥니다. 놓치기 쉬운 것은 화면에 드러나지 않는 부분입니다.

  1. 동작은 한다로그인·주문·결제 화면이 정상으로 보입니다.
  2. 남이 쓰면 뚫린다다른 사람 주문 조회, 가짜 결제 완료 요청이 그대로 통과합니다.
  3. 사람이 늘면 느려진다목록 하나에 쿼리가 수십 번 나갑니다.

02찾은 문제 8건

심각도는 "터지면 돈·개인정보가 바로 새는가" 기준입니다. 치명 3 · 높음 2 · 중간 3.

  1. 치명

    결제 웹훅에 서명 검사가 없음

    결제사 알림 주소로 아무나 요청을 보내 주문을 "결제 완료"로 바꿀 수 있었습니다.

  2. 치명

    결제 비밀 키가 브라우저 코드에 들어감

    환경변수 이름에 VITE_ 를 붙여 빌드 결과물에 키가 그대로 실렸습니다.

  3. 치명

    /.env 파일을 주소로 내려받을 수 있음

    프로젝트 폴더 전체를 정적 파일로 서빙해 비밀 값 파일이 공개됐습니다.

  4. 높음

    다른 사람 주문 조회 (IDOR)

    로그인만 확인하고 주문 주인은 확인하지 않아 주소가 노출됐습니다.

  5. 높음

    .env 가 저장소에 올라가는 구조

    .gitignore 가 없어 git add -A 한 번에 비밀 값이 커밋됩니다.

  6. 중간

    N+1 쿼리

    주문마다 상품을 따로 조회해, 주문이 늘수록 DB 호출이 같이 늘었습니다.

  7. 중간

    키보드로 팝업을 못 빠져나감

    Tab 을 막고 닫기 버튼이 버튼이 아니라서 키보드 사용자는 결제까지 갈 수 없었습니다.

  8. 중간

    입력 라벨 없음 · 글자 대비 부족

    스크린리더가 입력 칸 이름을 못 읽고, 회색 안내문 대비가 2.05:1 이었습니다.

03이렇게 고쳤습니다

구조를 갈아엎지 않고 필요한 줄만 고칩니다. 이 데모 전체 수정은 코드 +46 / −23줄과 설정 파일 3개입니다.

결제 웹훅 — 서명 확인

server.js
+const WEBHOOK_TOLERANCE_SEC = 300;
+function verifySignature(header = '', raw) {
+  …
+  const expected = createHmac('sha256', process.env.PAYMENT_WEBHOOK_SECRET).update(`${t}.${raw}`).digest();
+  const got = Buffer.from(parts.v1, 'hex');
+  return got.length === expected.length && timingSafeEqual(got, expected);
+}
 app.post('/api/webhooks/payment', (req, res) => {
-  const { orderId, status } = req.body;
+  if (!verifySignature(req.headers['x-signature'], req.body)) return res.status(400).json({ error: 'bad signature' });
+  const { orderId, status } = JSON.parse(req.body);

다른 사람 주문 — 주인 확인

server.js
  const [order] = q('SELECT * FROM orders WHERE id = ?', req.params.id);
  if (!order) return res.status(404).json({ error: 'not found' });
+ if (order.user_id !== req.user.id) return res.status(403).json({ error: 'forbidden' });

비밀 값 — 브라우저·공개 폴더에서 빼기

.env · server.js
-VITE_PAYMENT_SECRET_KEY=sk_test_FAKE_DO_NOT_USE_0000
+PAYMENT_SECRET_KEY=sk_test_FAKE_DO_NOT_USE_0000

-app.use(express.static(here, { dotfiles: 'allow' }));
 app.use(express.static(join(here, 'public')));

N+1 — 한 번에 조회

server.js
-  for (const order of orders) {
-    order.items = q('SELECT * FROM items WHERE order_id = ?', order.id);
-  }
+  const ids = orders.map((o) => o.id);
+  const items = ids.length ? q(`SELECT * FROM items WHERE order_id IN (${ids.map(() => '?').join(',')})`, ...ids) : [];
+  for (const order of orders) order.items = items.filter((i) => i.order_id === order.id);

04고친 뒤 다시 잰 결과

수정 전·후 앱에 같은 검사 스크립트를 돌린 실측값입니다. 검사 9개 항목 모두 통과했습니다.

검사 결과 (수정 전 → 수정 후)
검사방법수정 전수정 후
서명 없는 결제 완료 요청웹훅에 서명 없이 POST200 · 결제 완료됨400 · 거절
다른 키로 위조한 서명틀린 비밀로 HMAC200 · 결제 완료됨400 · 거절
10분 지난 서명 (재전송)오래된 타임스탬프200 · 결제 완료됨400 · 거절
정상 서명올바른 HMAC200200 · 결제 완료
다른 사람 주문 조회사용자 2 토큰으로 1번 주문200 · 주소 노출403
브라우저 코드 속 결제 키번들 JS 에서 키 검색있음없음
/.env 주소 접근HTTP GET200 · 비밀 포함404
커밋에 섞이는 env 파일사본에서 git add -A.env.env.example 만
주문 20건 목록 쿼리 수요청당 쿼리 카운트22회3회
자동 접근성 위반axe-core (WCAG 2 A·AA)3건0건
키보드로 팝업 닫기Tab·Esc 시나리오불가 (포커스 고정)Esc 로 닫힘

접근성은 자동 검사(axe-core)와 키보드 시나리오까지 확인했습니다. 스크린리더 실사용 확인은 이 데모에서 하지 않았습니다. 쿼리 수에는 로그인 확인 1회가 포함됩니다.

05이런 점검을 해 드립니다

AI 도구(Cursor·Claude·ChatGPT·v0·Bolt 등)로 만든 웹 앱을 받아 점검하고, 고치고, 무료 호스팅에 올리는 것까지 돕습니다.

점검·보완

  • 권한: 다른 사람 데이터 조회·수정 가능 여부
  • 비밀 값: 브라우저 코드·저장소·공개 폴더 노출
  • 결제: 웹훅 서명, 금액 위변조, 중복 처리
  • DB: N+1, 빠진 인덱스, 트랜잭션
  • 접근성: 라벨, 대비, 키보드 이동
  • 항목마다 재현 방법 · 수정 diff · 수정 후 검사 결과

배포

  • 정적 사이트: Cloudflare Pages 등 무료 호스팅 연결
  • 환경변수 정리(서버 전용 / 공개 구분)
  • 도메인 연결, HTTPS, 보안 헤더

포함하지 않는 것

  • 새 기능 개발 · 디자인 변경
  • 모의 해킹(침투 테스트) 인증서 발급
  • 유료 서버·DB 비용