# security-assistant-for-hermes

**Repository Path**: aliyun/security-assistant-for-hermes

## Basic Information

- **Project Name**: security-assistant-for-hermes
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hermes 安全助手插件

`security-assistant-for-hermes` 是由阿里云提供的安全防护插件，为 Hermes 的 Agent 生命周期提供全方位的安全保护。

## 核心特性

- **LLM 请求/响应检测**：自动拦截发往大模型的请求和响应，进行安全审计
- **Tool Call 安全审计**：在工具执行前后进行安全检查，防止恶意工具调用和敏感数据泄露
- **智能降级机制**：安全服务不可用时自动放行（fail-open），保障业务连续性

## 兼容性

要求 Hermes 版本 >= `0.6.0`。

> **注意**：Tool Call 安全审计能力要求 Hermes >= `0.10.0`。

## 快速开始

欢迎前往阿里云 AI 安全护栏控制台获取 Hermes 运行时防护插件。该插件基于 Qwen 审核大模型，提供针对提示词注入、数据泄露、工具滥用等各类风险的全栈实时防护，让安全成为您 AI 应用最坚实的底座。

启用后重启 Gateway 即可生效。

## 配置说明

所有配置通过环境变量设置（写入 `~/.hermes/.env`）：

| 变量名 | 必填 | 默认值 | 说明 |
|--------|------|--------|------|
| `INSTALL_KEY` | 是 | - | APS 安装密钥，用于首次注册获取 Token |
| `ENDPOINT_ADDR` | 是 | `https://cn-shanghai.agent-security.aliyuncs.com` | Agent 安全服务地址，包括 LLM 和 Tool Call 的安全审计，身份认证和管理 |

## 安全策略

### LLM

| 检测阶段 | 处置动作 | 说明 |
|----------|----------|------|
| 请求 | `allow` | 请求通过，正常放行 |
| 请求 | `block` | 请求被拦截，返回安全提示信息；风险请求不会发送到模型端 |
| 请求 | `hint` | 请求被标记，返回提示信息但不阻断 |
| 响应 | `allow` | 响应通过，正常放行 |
| 响应 | `block` | 响应被拦截，返回安全提示信息 |
| 响应 | `hint` | 响应被标记，返回提示信息但不阻断 |

### Tool Call

| 检测阶段 | 处置动作 | 说明 |
|----------|----------|------|
| 执行前 | `allow` | Tool 调用请求通过，正常执行 |
| 执行前 | `block` | 拦截 Tool 调用请求，返回安全提示信息 |
| 执行后 | `allow` | Tool 调用结果检测通过，正常返回 |
| 执行后 | `block` | 拦截 Tool 调用结果，返回安全提示信息 |