장치 연동 차단 에이전트

이것은 AF 장치 연동 차단 기능을 후속으로 연결하기 위해 FastMCP 최신 버전을 기반으로 구축된 AiPy 확장 스캐폴드입니다.

프로젝트 구조

• device_block_agent/: 핵심 Python 소스 코드 및 MCP 도구 구현.

• docs/: API 정리 문서, 솔루션 문서 및 원본 PDF.

• assets/: 아이콘 등 정적 리소스.

• examples/: 화이트리스트 샘플 및 참조 자료.

• 루트 디렉토리: main.py, manifest.json, requirements.txt, README.md 등 프로젝트 진입 파일 유지.

현재 상태

• FastMCP 3.2.4 통합 완료.

• Streamable HTTP MCP 서비스 진입점 제공, 기본 노출 경로는 /mcp.

• AiPy에서 요구하는 addition-system-instruction 프롬프트 제공.

• auth_login, auth_keepalive, auth_logout 3가지 인증 도구 제공.

• block_list_temp, block_list_business, block_get_total_count, block_get_block_time 4가지 읽기 전용 조회 도구 제공.

• 화이트리스트 규칙 로드 및 수동 확인 판정 모듈 제공, 후속 쓰기 작업 도구에서 직접 재사용 가능.

• block_add_business, block_delete_temp, block_delete_business, block_clear_attackers, block_clear_temp, block_clear_business, block_set_block_time 7가지 쓰기 작업 도구 제공.

• 로컬 JSONL 감사 로그 및 작업 유형별 세분화된 재검사 결과 제공.

• 로컬 JSON 파일을 통한 로그인 세션 지속성 지원, 프로세스 간 로그인 상태 재사용 가능.

• 로컬 세션 타임아웃 판단 및 만료 임박 시 자동 keepalive 지원.

• 기본 AF 계정 및 연결 구성 지원, 인증 및 차단 도구에서 직접 재사용 가능.

• AiPy에서 MCP 서비스로의 발견 링크를 검증하기 위한 최소 도구 agent_info 제공.

• 1차 비즈니스 수준 재검사 전략 통합 완료, block_clear_attackers가 전후 기준 비교 판정으로 업그레이드됨.

로컬 실행

1. 의존성 설치: pip install -r requirements.txt

2. 서비스 시작: python main.py

3. 서비스 시작 후 표준 출력에 무작위 포트 번호가 출력됩니다.

위험 관리 구성

1. examples/whitelist.sample.json에서 로컬 화이트리스트 예시 제공.

2. confirm_mode는 manual 및 auto 두 가지 모드를 지원합니다.

3. WHITELIST_FILE 및 CONFIRM_MODE는 manifest.json의 user_config를 통해 실행 환경에 주입할 수 있습니다.

4. 비우기 유형 작업은 항상 명시적 확인을 요구하며, 일괄 추가 및 일괄 삭제는 manual 모드에서 명시적 확인을 요구합니다.

5. LOG_FILE을 사용하여 로컬 JSONL 감사 로그 경로를 지정할 수 있습니다.

6. SESSION_FILE을 사용하여 로컬 JSON 세션 지속성 경로를 지정할 수 있습니다.

7. SESSION_TIMEOUT_SECONDS 및 SESSION_REFRESH_WINDOW_SECONDS를 사용하여 로컬 세션 타임아웃 및 자동 유지보수 창을 제어할 수 있습니다.

계정 구성

1. af_host는 기본 AF 호스트 주소를 구성하는 데 사용됩니다.

2. af_namespace는 기본 네임스페이스를 구성하는 데 사용되며, 기본값은 public입니다.

3. af_username 및 af_password는 기본 로그인 계정을 구성하는 데 사용됩니다.

4. af_verify_tls는 기본 HTTPS 인증서 검증 스위치를 구성하는 데 사용됩니다.

5. 구성 완료 후 auth_login, auth_keepalive, auth_logout 및 차단 관련 도구에서 이러한 기본값을 직접 재사용할 수 있습니다.

현재 구현된 도구

1. agent_info

2. auth_login

3. auth_keepalive

4. auth_logout

5. account_config_status

6. block_list_temp

7. block_list_business

8. block_get_total_count

9. block_get_block_time

10. block_add_business

11. block_delete_temp

12. block_delete_business

13. block_clear_attackers

14. block_clear_temp

15. block_clear_business

16. block_set_block_time

다음 단계 구현

1. 프로덕션 환경 배포 시 로그 순환 및 민감 필드 등급별 마스킹 추가.

2. 더 강력한 재검사 기능이 필요한 경우 비즈니스 기록 ID 또는 작업 결과 객체 기반의 정밀 비교 추가.

3. 장기 실행이 필요한 경우 토큰 만료 후 자동 재인증 전략 추가.