보안 개요

┌─────────────────────────────────────────────────────────────────────┐
│                        외부 위협                            │
│                      (악의적 프롬프트)                   │
└─────────────┬───────────────────────────────────────────────────┘
              │
              ▼
     ┌────────────────┐
     │   보안 계층   │
     └────┬────┬─────┘
          │     │
     ┌────┴────┐  ┌──────┴──────────┐
     │ DM 페어링 │  │   샌드박스      │
     │   정책   │  │  (Docker)      │
     └──────────┘  └─────┬──────────┘
                    │
                    ▼
          ┌──────────────────────┐
          │   권한 시스템      │
          └────────┬───────────┘
                   │
         ┌───────────┼──────────┐
         ▼           ▼           ▼
    ┌────────┐ ┌────────┐ ┌────────┐
    │ 브라우저│ │  Canvas │ │  노드 │
    │ 자동화  │ │  A2UI   │ │ 제어  │
    └────────┘ └────────┘ └────────┘

1. 알 수 없는 발신자가 메시지 전송

2. Gateway가 짧은 페어링 코드 생성
   예: "pairing-code-ABC123"

3. 발신자에게 코드가 포함된 응답 전송
   "알 수 없는 발신자입니다.
    페어링 코드: pairing-code-ABC123"

4. 사용자가 CLI에서 승인
   clawdbot pairing approve whatsapp pairing-code-ABC123

5. 발신자가 로컬 allowlist에 추가
   .clawdbot/channels/whatsapp/allowlist.json:
   ["+9876543210"]

6. 이후 메시지가 정상 처리됨

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",  // 또는 "open"
      allowFrom: ["+1234567890", "*"]  // "*": 모든 연결 허용
    },
    discord: {
      dm: {
        policy: "pairing",
        allowFrom: ["1234567890123456789", "*"]
      }
    }
  }
}

{
  sandbox: {
    mode: "non-main",
    allowlist: [
      "bash",           // 쉘 명령 실행
      "process",        // 프로세스 정보
      "read",           // 파일 읽기
      "write",          // 파일 쓰기
      "edit",          // 파일 편집
      "sessions_list",  // 세션 목록 조회
      "sessions_history" // 세션 기록 조회
    ],
    denylist: [
      "browser",        // 브라우저 자동화
      "canvas",         // 캔버스 제어
      "nodes",          // 디바이스 노드
      "cron",          // 크론 작업
      "discord",        // Discord 액션
      "slack",          // Slack 액션
      "gateway"        // Gateway 제어
    ]
  }
}

// 샌드박스 실행 로직
async function runInSandbox(tool: string, params: any, session: Session) {
  if (session.isMain) {
    // main 세션은 호스트에서 직접 실행
    return await executeTool(tool, params);
  }

  // 비-main 세션은 Docker 컨테이너에서 실행
  if (!sandbox.allowlist.includes(tool)) {
    throw new Error(`Tool ${tool} not in allowlist`);
  }

  if (sandbox.denylist.includes(tool)) {
    throw new Error(`Tool ${tool} in denylist`);
  }

  // Docker 컨테이너 실행
  return await executeInDocker(tool, params, session.workspace);
}

# 샌드박스 Docker 이미지 (개념)
FROM node:22-alpine

# 필요한 의존성만 설치
RUN apk add --no-cache git curl bash

# 작업 디렉토리
WORKDIR /workspace

# 샌드박스 실행
ENTRYPOINT ["node", "/usr/local/bin/clawdbot-sandbox"]

{
  gateway: {
    auth: {
      mode: "password",  // 또는 "token", "none"
      password: "secure-password"  // mode="password" 시 필요
      // 또는
      // token: "auth-token-xyz123"  // mode="token" 시 필요
    }
  }
}

{
  gateway: {
    tls: {
      enabled: true,
      certPath: "~/.clawdbot/gateway/cert.pem",
      keyPath: "~/.clawdbot/gateway/key.pem",
      caPath: "~/.clawdbot/gateway/ca.pem",  // 선택적
      autoGenerate: true  // 자체 서명 인증서 자동 생성
    }
  }
}

{
  gateway: {
    tailscale: {
      enabled: true,
      allowTailscale: true  // Tailscale IP 자동 인증 허용
    }
  }
}

// 도구 권한 체크
interface ToolPermission {
  tool: string;
  allowed: boolean;
  reason?: string;
}

// 권한 검사 로직
function checkPermission(tool: string, session: Session): boolean {
  if (session.isMain) {
    return true;  // main 세션은 모든 도구 허용
  }

  if (sandbox.mode === 'non-main') {
    return sandbox.allowlist.includes(tool);
  }

  return false;
}

{
  // Gateway 보안
  gateway: {
    auth: {
      mode: "password"  // 비밀번호 인증 권장
    },
    tls: {
      enabled: true,  // TLS 활성화 권장
      autoGenerate: true
    },
    bind: "loopback"  // 루프백만 바인드 권장
  },

  // 채널 DM 정책
  channels: {
    whatsapp: {
      dmPolicy: "pairing",  // 페어링 권장
      groupPolicy: {
        mode: "mention"  // 멘션 모드 권장
      }
    }
  },

  // 샌드박스
  sandbox: {
    mode: "non-main",  // 비-main 세션만 샌드박스
    denylist: [
      // 위험한 도구는 비-Main에서 거부
      "browser",
      "canvas",
      "nodes",
      "cron",
      "discord",
      "slack",
      "gateway"
    ]
  }
}

# 보안 설정 확인
clawdbot config get gateway.auth.mode
clawdbot config get gateway.tls.enabled
clawdbot config get channels.*.dmPolicy
clawdbot config get sandbox.mode

# 로그 검사
clawdbot logs gateway --follow | grep -i "auth\|denied\|error"