보안
API 키 관리, 경로 제한, 보안 모범 사례.
Tactic Remote는 iPhone에서 Mac의 터미널을 제어할 수 있게 합니다. 이 페이지에서는 보호 대상, 방식, 설정해야 할 항목을 다룹니다.
API 키 인증
서버는 API 키 인증을 지원합니다. 설정하면 모든 연결에서 올바른 키를 제공해야 합니다.
Mac 앱에서 랜덤 키를 자동 생성할 수도 있습니다.
필수 여부:
- 공개/터널 접근 시 항상 필수 (강력히 권장).
- 로컬 전용 접근 시 선택 사항이지만 설정을 권장.
규칙:
- 스크린샷이나 채팅에 API 키를 공유하지 마세요.
- 키가 노출된 것으로 의심되면 즉시 교체하세요.
- Mac 앱은 키를 macOS Keychain에 저장합니다.
경로 제한
Claude Code가 접근할 수 있는 디렉토리를 제한할 수 있습니다:
기본값은 홈 디렉토리 (~)입니다. 프로젝트 폴더로 좁히면 Claude가 관련 없는 파일에 접근하는 것을 방지합니다.
기본 차단 대상: 허용 경로 설정과 관계없이, .ssh, .aws, .gnupg 등 민감한 디렉토리는 항상 차단됩니다.
세션 보안
- 세션 이름 검증: 영숫자, 밑줄, 하이픈만 허용 (최대 50자). 세션 이름을 통한 명령 주입을 방지합니다.
- 명령어 검증: tmux로 전달되는 명령이 검증됩니다. 승인된 플래그의
claude명령만 실행 가능합니다. - 경로 탐색 공격 (예:
../../etc/passwd) 차단.
속도 제한
서버는 연결당 분당 30건의 요청 속도 제한을 적용합니다. 남용 및 우발적인 요청 폭주를 방지합니다.
네트워크 보안
로컬 네트워크
신뢰할 수 있는 자택/사무실 네트워크에서 로컬 모드는 합리적으로 안전합니다. 주요 위험은 같은 네트워크의 다른 기기입니다. IP와 API 키를 자격 증명으로 취급하세요.
Cloudflare Tunnel
터널 연결은 기본적으로 암호화됩니다 (WSS/TLS). Cloudflare가 DDoS 보호도 제공합니다. 터널을 사용하면 라우터에서 인바운드 포트를 열 필요가 없습니다.
공개 접근 시 항상:
- API 키를 설정하세요.
- 가능하면 안정적인 URL을 가진 Named Tunnel을 사용하세요.
- 더 이상 필요 없는 오래된 터널 설정을 제거하세요.
체크리스트
| 항목 | 상태 |
|---|---|
| 서버 API 키 설정 | 터널 시 필수, 로컬 시 권장 |
| 허용 경로 설정 | 기본 ~, 프로젝트 폴더로 축소 |
| Mac 방화벽에서 앱 허용 | 로컬 연결 시 필수 |
| 민감 디렉토리 차단 | 자동 (.ssh, .aws 등) |
| 속도 제한 활성 | 자동 (30 req/min) |
| 노출 후 키 교체 | 필요 시 수동 조치 |