AiSOC: 오픈소스 셀프호스팅 AI 보안 운영 센터 시작 가이드

적합한 사용자

• 로컬 또는 자체 서버에서 AI 보안 운영 센터(SOC)를 운영하려는 보안 팀 또는 개인 연구자: AiSOC은 오픈소스 셀프호스팅 프로젝트로, 보안 텔레메트리 데이터를 수집하고 위협을 탐지·상관 분석하며, 감사 가능한 추론 과정을 갖춘 AI 에이전트로 조사를 수행하고, 사람의 승인을 받는 대응 조치를 제안합니다.
• 클라우드 API 키 없이 실행하고 싶은 사용자: 공식 설명에 따르면 API 키 없이도 실행할 수 있습니다.
• Claude, Cursor, Continue 등의 클라이언트를 사용하며 MCP를 통해 연동하려는 사용자.

적합하지 않은 경우:

• 리소스 요구 사항을 충족하는 Docker 환경이 없는 사용자(아래 전제 조건 참조)는 설치를 완료할 수 없습니다.
• 프로덕션급 SOC 대체제로 적합한지, 어떤 텔레메트리 데이터 소스 형식을 지원하는지는 근거에서 확인되지 않습니다. 이는 미지의 사항이므로, 선택 전에 리포지토리에서 직접 확인해야 합니다.

3분 만에 첫 시도하기

권장 기본 경로는 공식 Quick start입니다. 리포지토리를 클론하고 make로 실행합니다.

전제 조건:

• Docker Compose v2, 그리고 Docker VM에 8 GB 메모리와 20 GB의 가용 디스크 공간.
• python3(3.9 이상)와 bash.
• 환경이 요구 사항을 충족하는지 확실하지 않다면, 먼저 공식 제공 make doctor를 실행하세요. 위의 모든 요구 사항을 점검해 줍니다.

설치 및 실행(공식 원문 명령어):

git clone https://github.com/beenuar/AiSOC && cd AiSOC
make up

첫 실행 시 약 2 GB의 모델을 다운로드하며, 이는 make clean으로만 제거할 수 있는 볼륨에 저장됩니다. 즉, 실행 전에 알아두어야 할 부작용입니다.

성공 신호: 서비스가 로컬에서 시작되면 UI 또는 MCP 인터페이스를 통해 상호작용할 수 있습니다. 근거에는 첫 실행 이후의 구체적인 UI 단계나 기본 접속 주소가 제시되지 않으므로, 이 단계는 리포지토리 README의 후속 설명을 따라야 합니다.

저위험 첫 시도: 근거에 구체적인 MCP 도구 이름과 읽기/쓰기 속성이 나열되어 있지 않아, 첫 호출로 지정할 만한 "읽기 전용 도구"를 특정할 수 없습니다. 도구의 부작용을 확인하기 전에는 UI와 의사 결정 기록(decision ledger) 같은 표시 기능을 먼저 살펴보고, 대응 유형 작업을 직접 실행하는 것은 피하는 것이 좋습니다.

사용 사례

사례 1: 실행 전 환경 점검. 상황: Docker VM의 리소스가 충분한지 확실하지 않은 경우. 방법: 리포지토리를 클론한 뒤 먼저 make doctor를 실행하면 Docker Compose v2, 8 GB 메모리, 20 GB 디스크, python3 3.9+, bash를 항목별로 점검합니다. 기대 결과: 점검을 통과한 후 make up을 실행하면, 첫 실행 도중 리소스 부족으로 실패하는 상황을 피할 수 있습니다.

사례 2: MCP를 통해 Claude, Cursor 또는 Continue에서 AiSOC 연동. 상황: 이러한 클라이언트에서 AiSOC의 탐지 결과나 조사 결론을 직접 조회하고 싶은 경우. 방법: 프로젝트 공식 설명에 따르면 Claude, Cursor, Continue용 MCP server가 내장되어 있습니다. 각 클라이언트에서의 구체적인 설정 필드와 연결 방식은 근거에 그대로 제시되지 않았으므로, 리포지토리의 해당 MCP 설정 설명을 따라야 합니다. 확인 가능한 범위: MCP server와 대상 클라이언트가 제공된다는 점은 확인할 수 있지만, 첫 연결 이후 사용 가능한 도구 목록, 매개변수, 출력 형식은 근거가 다루지 않는 부분이므로 가정해서는 안 됩니다.

사용 경계

• 읽기/쓰기 성격: 보안 텔레메트리를 수집해 위협을 탐지하고, AI 에이전트가 조사를 수행하며 대응을 "제안"하지만, 대응은 사람이 승인합니다. 즉, 쓰기 작업에는 확인 지점이 있습니다. MCP 도구 중 어떤 것이 읽기 전용이고 어떤 것이 실제 동작을 유발하는지는 근거에 명시되어 있지 않습니다.
• 로컬 데이터와 디스크 부작용: 첫 실행 시 약 2 GB의 모델을 볼륨에 다운로드하며, make clean으로만 제거할 수 있습니다. 이는 실제 디스크 공간을 차지하며, 제거 작업 자체도 해당 볼륨의 내용을 삭제합니다.
• 자격 증명 요구 사항: 공식 설명에 따르면 API 키 없이 실행 가능하며, 그 외 자격 증명 요구 사항은 언급되지 않았습니다.
• 명시적 제약: Docker Compose v2(8 GB 메모리 / 20 GB 디스크), python3 3.9+, bash가 필요합니다.
• 아직 확인되지 않은 사항: 구체적인 MCP 도구 목록, 각 도구의 읽기 전용 여부, 기본 접속 포트, 지원되는 텔레메트리 소스 유형, 업그레이드 및 제거 절차는 이번 근거에서 공식 페이지가 제시하지 않았으므로, 사용 전에 리포지토리의 최신 README를 확인해야 합니다.