# Schemas 目录说明

本目录用于存放 OSIM 数据标准的 schema JSON 文件。

## 数据来源

所有 schema 文件均来源于 [OSIM 开源工程](https://github.com/osim-project/osim)（Open Security Information Model）。

## 目录结构

schemas 目录应包含以下结构：

```
schemas/
├── alert/                      # 告警分类
│   ├── anomalous_behavior/     # 异常行为
│   ├── data_security/          # 数据安全
│   ├── malware/                # 恶意软件
│   ├── network_attack/         # 网络攻击
│   └── vulnerability_configuration_risk/  # 漏洞配置风险
├── asset/                      # 资产分类
│   ├── business_asset/         # 业务资产
│   ├── cloud_asset/            # 云资产
│   ├── data_asset/             # 数据资产
│   ├── network_asset/          # 网络资产
│   ├── physical_asset/        # 物理资产
│   ├── software_asset/         # 软件资产
│   └── virtual_asset/          # 虚拟资产
├── device_detection/           # 设备检测分类
│   ├── anti_ddos_system/       # 抗DDoS系统
│   ├── antivirus/              # 防病毒
│   ├── firewall/               # 防火墙
│   ├── edr_system/             # EDR系统
│   └── ...                     # 其他设备类型
├── incident/                   # 事件分类
│   └── security_incident/      # 安全事件
├── log/                        # 日志分类
│   ├── authentication_and_access/  # 认证和访问
│   ├── data_security_audit/    # 数据安全审计
│   ├── host_behavior_audit/     # 主机行为审计
│   ├── network_session_audit/  # 网络会话审计
│   └── operation_monitoring_audit/  # 操作监控审计
└── groups.json                 # 分组元数据
```

## 如何获取 Schema 文件

### 方法 1: 从参考项目复制

如果您有访问 `/Users/delin/git/osim-mcp-server` 项目的权限，可以直接复制 schemas 目录：

```bash
cp -r /Users/delin/git/osim-mcp-server/src/main/resources/schemas/* ./schemas/
```

### 方法 2: 从 OSIM 开源项目获取

从 [OSIM 开源工程](https://github.com/osim-project/osim) 的仓库中获取 schema 文件。

## Schema 文件格式

每个 schema JSON 文件应包含以下结构：

```json
{
  "group": "log",
  "category": "network_session_audit",
  "title": "http_audit",
  "description": "HTTP 审计日志记录...",
  "definitions": {
    "字段名": {
      "label": "字段标签",
      "requirement": "REQUIRED|RECOMMENDED|OPTIONAL",
      "description": "字段描述",
      "type": "字段类型",
      "valid_type": "验证类型"
    }
  }
}
```

## 注意事项

- 系统会自动排除 `categories.json` 和 `groups.json` 文件
- 所有 JSON 文件必须使用 UTF-8 编码
- Schema 文件必须包含 `group`、`category`、`title` 和 `definitions` 字段


