Hermes 에이전트 API 서버는 프론트엔드, 내부 도구, OpenAI 호환 클라이언트에 연결할 수 있으나, 포트를 공개 네트워크에 직접 노출하는 것은 권장되지 않습니다. 올바른 접근법은 이를 키, 역대리, 네트워크 경계를 포함한 고허가 자동화 진입구로 간주하고, 팀원들이 사용하는 것에 대해 논의하는 것입니다.
왜 우리는 단 하나의 열린 항구만으로는 믿을 수 없는 걸까?
API 서버 뒤에는 단순한 채팅 인터페이스가 아니라 에이전트 기능이 있습니다. 프로젝트를 읽고, 도구를 호출하며, 작업을 트리거하고, 심지어 설정을 통해 외부 서비스에 접근할 수도 있습니다. 포트가 노출되면, 위험은 단순히 '누군가 모델 할당량을 악용하는 것'이 아니라, 낯선 요청이 에이전트가 예상치 못한 행동을 하게 만들 수 있다는 점입니다.
팀 장면 설정 방법
소규모 팀은 내부에서 시도해 보시는 것이 좋으며, 가능하다면 인트라넷, Tailscale, Zero Trust, VPN 등 뒤에 배치하는 것이 좋습니다; 웹 프론트엔드에 접속한 후 Nginx나 Caddy 같은 역대리서를 사용해 HTTPS를 추가하고, 로그 접근 권한과 속도 제한을 설정해야 합니다. API 키는 공개 웹페이지에 기록될 수 없으며, 여러 사람이 동일한 장기 키를 공유해서는 안 됩니다. 최소한 누가 사용하고 있는지, 어떤 진입점이 사용되는지, 예외 요청을 차단할 수 있는지 등을 알 수 있어야 합니다.
클라이언트 접근도 레이어링이 필요합니다
오픈 웹 UI, 스크립트, CI 작업, 내부 백엔드는 서로 다른 키와 권한으로 설명하는 것이 가장 좋습니다. "데모 인터페이스"와 "운영 가능한 프로덕션 프로젝트 실행 가능한 에이전트"를 같은 구성으로 연결하지 마세요.
라이브 전 간단한 수락 점검: 외부 네트워크가 포트를 직접 스캔할 수 있는지 여부; 키가 없는 요청을 거부하는지; 오류 키가 기록되는지 여부; 고위험 상품이 여전히 승인을 필요로 하는지 여부; 통화 기록에서 통화 출처를 확인할 수 있나요? 이 요구사항을 충족하고 팀에 시험 절차를 넘기는 과정은 조금 느리겠지만, 에이전트가 무인 원격 집행 입구가 되지는 않습니다.
