"스테이징(Staging) 서버"의 딜레마

개발팀이라면 누구나 겪는 골치 아픈 상황이 있습니다.

완벽하게 구성된 스테이징 환경이 있지만, 사내 방화벽 뒤에 있거나 폐쇄망(VPC) 안에 갇혀 있습니다. 배포 전에 SiteSnapshot으로 시각적 회귀 테스트를 돌려보고 싶지만, 외부 서비스인 SiteSnapshot이 내부망에 접근할 방법이 없습니다.

이때부터 위험한 타협이 시작됩니다:

• "보안팀에 IP 화이트리스트 요청할까?" (보안팀: 절대 안 됩니다.)
• "ngrok 같은 터널링 툴을 쓸까?" (URL이 계속 바뀌고, 보안상 불안합니다.)
• "그냥 배포하고 상용에서 테스트하자." (장애 발생의 지름길입니다.)

이러한 문제를 해결하기 위해 **Agent Mode(에이전트 모드)**를 출시했습니다.

Agent Mode란 무엇인가요?

Agent Mode는 사용자의 사내 서버나 로컬 PC에 가벼운 에이전트 프로그램을 설치하여 SiteSnapshot과 통신하는 기능입니다.

중요한 점은, SiteSnapshot 클라우드 서버가 여러분의 네트워크로 들어오는(Inbound) 것이 아니라, 여러분의 에이전트가 우리 서버로 나가는(Outbound) 방식이라는 것입니다.

즉, 단방향 아웃바운드 연결입니다.

• 방화벽 포트를 열 필요가 없습니다.
• 외부 공인 IP가 필요 없습니다.
• 복잡한 보안 설정이 불필요합니다.

왜 사용해야 할까요?

1. 로컬호스트(Localhost) 모니터링

새로운 기능을 개발 중이신가요? 개발자 노트북에 에이전트를 켜두세요. http://localhost:3000 주소를 바로 모니터링할 수 있습니다. 코드를 수정하면 SiteSnapshot이 즉시 로컬 환경의 변화를 감지하고 기록합니다.

2. 보안이 필수적인 내부 대시보드

고객 데이터를 다루는 내부 어드민(Intranet Admin) 패널이 있으신가요? 외부 인터넷에 노출할 순 없지만, 모니터링은 필요할 때가 있습니다. Agent Mode를 사용하면 http://admin.internal 같은 사내 전용 주소도 안전하게 시각적 테스트를 수행할 수 있습니다.

3. 스테이징/QA 환경 완벽 커버

상용 배포 전 단계에서 버그를 잡으세요. CI/CD 파이프라인이나 스테이징 서버에 에이전트를 연동해두면, 배포 전 최종 관문으로 활용할 수 있습니다.

시작하는 방법

첫 에이전트를 연결하는 데 30초면 충분합니다.

1. 대시보드 > Agents 메뉴로 이동합니다.
2. "Generate New Key" 버튼을 클릭합니다.
3. 실행 명령어를 복사합니다.
4. 내부 서버 터미널에서 실행합니다:

   ./sitesnapshot-agent start --key=sk_agent_12345...

연결이 완료되면 대시보드에서 상태가 Online으로 바뀌는 것을 확인할 수 있습니다. 이제 사내망 URL을 입력하여 모니터링을 시작하세요.

보안 최우선 설계 (Security First)

Agent Mode는 가장 엄격한 엔터프라이즈 환경을 기준으로 설계되었습니다.

• 암호화 통신: 모든 데이터는 TLS 1.3을 통해 암호화되어 전송됩니다.
• 데이터 미저장 (Ephemeral): 에이전트는 작업을 수행한 후 어떠한 데이터도 로컬에 저장하지 않습니다.
• 엄격한 권한 분리: 에이전트는 오직 읽기 전용(Read-only) 렌더링 작업만 수행합니다.

마치며

모니터링이 방화벽 앞에서 멈춰선 안 됩니다. 지금 바로 Agent Mode를 통해 로컬호스트부터 폐쇄망 인트라넷까지, 여러분의 시야를 확장하세요.