오래된 그누보드에 진짜 작동하는 AI를 붙이는 법

"홈페이지에 AI 붙여주세요"는 쉬운 말처럼 들리지만, 오래된 PHP 사이트에 실제로 태우려면 챙길 게 많습니다. 한솔애드의 AI 간판 시안 미리보기를 그누보드5에 붙이며 겪은 것들입니다.

1. API 키는 절대 브라우저로 내려가면 안 된다

이미지 생성 API 키가 프론트에 노출되면 그대로 도용됩니다. 그래서 요청은 항상 서버를 거치게 하고, 데모는 세션당 횟수를 제한합니다. 무제한이 필요한 사용자는 본인 키를 브라우저에서 직접 쓰되, 그 키는 우리 서버에 저장하지 않습니다(BYOK).

2. 그누보드의 함정

• CSRF 토큰: 글쓰기·요청에 그누보드 고유 토큰이 필요 — 우회하지 말고 정식 경로로
• 1시간 캐시: 최신글 위젯이 캐시돼서, 이관 직후 빈 화면이 뜸 → 캐시 비우기를 배포 절차에 포함
• 스킨 경로: 테마 안의 스킨은 theme/ 접두어가 없으면 전역 스킨을 찾아 깨짐

3. "작동하는" AI의 기준

데모용 AI와 운영되는 AI는 다릅니다. 실패했을 때 사용자에게 뭐라고 말할지, 비용이 폭주하지 않게 어떻게 막을지, 결과가 이상할 때 재시도는 어떻게 할지 — 이걸 다 설계해야 비로소 홈페이지에 얹을 수 있습니다.

지금 한솔애드에서 그 AI는 매일 실제 고객이 씁니다. 데모가 아니라 운영입니다.