Sliver 审计日志(Audit Log)完全指南:日志定位、JSON 解析与源码级实现原理
Sliver 审计日志(Audit Log)完全指南:日志定位、JSON 解析与源码级实现原理
Sliver 服务器内置了一套完整的审计日志(Audit Log)系统,用于记录服务器上执行的每一条命令及其参数,以及绝大多数关键事件(如新 session、新 beacon 上线),其设计目的是支撑事后分析(after-action analysis),为整个交战(engagement)提供详尽的可追溯历史。本文将基于官方文档并结合仓库源码,完整讲解审计日志的定位、覆盖范围、日志位置定制、JSON 格式解析方法,并深入剖析其底层实现(gRPC 拦截器、脱敏逻辑、日志轮转),帮助你真正用好这一安全审计能力。
审计日志的定位与设计目标
Sliver 的审计日志服务于一个非常明确的目标:事后分析。它不追求实时的业务可读性,而是要为每一次交战提供"谁、在何时、在哪个主机上、执行了什么命令"的完整历史记录。
根据 Audit Log 文档 的说明,审计日志会记录:
- 服务器执行的每一条命令及其参数:包括 multiplayer(多人协作)模式下由 operator(操作员)执行的命令;
- 绝大多数事件:例如新的 session 或 beacon 连接到服务器;
- 任何操作员在任何 session 上执行的任何命令:这意味着审计日志是全量、跨操作员的统一记录,而不是某个控制台的本地记录。
正因如此,审计日志是运维、合规审计和红队演练复盘的核心数据来源:在一次演练结束后,你可以从审计日志中完整还原整个攻击链上所有操作的时间线与执行对象。
审计日志的记录范围与边界
理解审计日志能记录什么,同样要理解它不记录什么,否则在复盘时容易产生误判。文档明确指出了三类边界情况:
- 仅作用于"客户端侧"的控制台命令可能不会出现在审计日志中。例如某些只在本地 console 中生效的命令(如本地设置类操作),它们不会触发服务器端的 gRPC 调用,因此不会写入审计日志;但它们仍会出现在客户端自己的命令历史(command history)中。
- 交互式命令(如
shell)通常只记录命令的首次使用。也就是说,日志中会留下shell命令被调用的记录,但随后在交互式 shell 内部执行的操作不会逐条进入审计日志。 - 命令的执行主体可能是任何 operator:在 multiplayer 模式下,所有 operator 的操作都会统一落入同一份审计日志,这为多操作员协作场景提供了清晰的责任追溯基础。
从实现上看,这种"命令即 gRPC 调用"的映射关系正是审计日志的根基:每条服务器端命令最终都会对应一个 gRPC RPC 方法(如 /rpcpb.SliverRPC/StartMTLSListener),拦截器在 RPC 层统一采集,从而保证了覆盖面的一致性(详见下文源码分析)。
审计日志文件位置与路径定制
默认情况下,审计日志存放在服务器端:
~/.sliver/logs/audit.json
其中 ~ 是运行服务器的系统用户的 home 目录。这一点可以从源码得到印证:在 server/log/log.go 中,GetRootAppDir() 在没有设置环境变量时返回 <用户主目录>/.sliver,而 GetLogDir() 则在根目录下追加 logs 子目录;随后 server/log/audit.go 将审计日志输出到 GetLogDir()/audit.json。
如果你需要将日志迁移到其他磁盘或统一归档目录,可以通过修改环境变量 SLIVER_ROOT_DIR 来改变整个 Sliver 根目录的位置,审计日志会随之移动到:
$SLIVER_ROOT_DIR/logs/audit.json
该环境变量在 server/log/log.go 中被定义为 envVarName = "SLIVER_ROOT_DIR",并在 GetRootAppDir() 中优先读取:若环境变量非空则直接使用其值作为根目录,否则回退到 ~/.sliver;目录不存在时会自动以 0700 权限创建。
审计日志格式:换行分隔的嵌套 JSON
审计日志采用换行分隔(newline-delimited)的嵌套 JSON 格式存储,即每一行是一个独立的 JSON 对象(one object per line)。这种格式的主要设计目标是机器可读——方便使用 jq、Python、Go 等工具进行流式解析和二次分析。官方文档给出的示例条目如下:
{"level":"info","msg":"{\"request\":\"{\\\"Port\\\":8888}\",\"method\":\"/rpcpb.SliverRPC/StartMTLSListener\"}","time":"2021-06-16T10:22:54-05:00"}
注意: 由于底层日志 API 的限制,审计日志中存在嵌套 JSON 对象,msg 字段本身是一个被编码为字符串的 JSON 对象,因此在解析时需要额外的二次解析(double parsing) 步骤。
顶层字段说明
每一行审计日志的顶层 JSON 始终包含以下三个字段:
| 字段 | 含义 | 取值说明 |
|---|---|---|
level |
表示动作类型 | 目前 info 表示命令,warn 表示事件(如新 session/beacon 注册) |
msg |
编码为字符串的 JSON 对象 | 该对象始终包含 request 和 method 两个键:method 指明执行的是哪条命令(对应 gRPC 全限定方法名),request 包含该命令的参数 |
time |
服务器记录该日志条目的时间戳 | 采用带时区的 RFC3339 格式,如 2021-06-16T10:22:54-05:00 |
request 的具体内容随命令不同而变化,但始终基于对应的 gRPC/Protobuf 消息结构生成。这意味着:如果你了解某个 RPC 的 Protobuf 定义,就能精确还原该命令当时携带的全部参数。
解析审计日志的实战方法
由于是换行分隔的嵌套 JSON,最直接的方式就是逐行读取、逐行解析。下面给出两种常见工具的解析示例。
使用 jq 提取方法名与请求参数
先用 jq 解析外层 msg,再对 msg 做一次 fromjson 得到内层对象:
# 查看每条审计日志的 method(执行了哪条命令)
jq -r '.msg | fromjson | .method' ~/.sliver/logs/audit.json
# 查看 method 与对应的 request 参数
jq -c '.msg | fromjson | {method, request}' ~/.sliver/logs/audit.json
# 按时间筛选某时间段内的命令
jq -c 'select(.time >= "2024-01-01T00:00:00" and .time <= "2024-01-02T00:00:00") | .msg | fromjson' ~/.sliver/logs/audit.json
使用 Python 流式解析
import json
with open("~/.sliver/logs/audit.json", "r") as f: # 请替换为实际路径
for line in f:
line = line.strip()
if not line:
continue
entry = json.loads(line) # 第一层解析
inner = json.loads(entry["msg"]) # 第二层解析:msg 是字符串形式的 JSON
print(entry["time"], entry["level"], inner["method"], inner["request"])
由于 request 是基于 Protobuf 消息生成的 JSON,它保留了对应 RPC 的字段结构。例如上面的示例中 StartMTLSListener 的请求对象形如 {"Port":8888},即启动 mTLS 监听器时的端口参数。你可以利用这一点构建针对性的统计脚本,例如统计每种命令的执行频率、按 operator 汇总操作、或还原某台主机上执行过的全部命令序列。
源码级实现原理
审计日志并非简单地在业务代码中逐条打印,而是由专门的审计日志器 + gRPC 拦截器 + 事件处理器三层机制共同构成。理解这些实现有助于你判断日志覆盖范围、字段来源以及如何扩展自定义解析。
1. 审计日志器的构造(server/log/audit.go)
server/log/audit.go 定义了一个独立的全局日志器 AuditLogger:
- 它基于
logrus创建,Formatter设置为logrus.JSONFormatter,保证输出为 JSON 格式; - 输出目标是一个轮转写入器(rotating writer),文件名为
GetLogDir()/audit.json; - 日志级别设置为
DebugLevel,确保所有需要审计的信息都不会被过滤。
这意味着审计日志与服务器普通日志(sliver.json / sliver.log)是相互独立的两条输出链路,各有独立的文件和轮转策略。
2. 命令记录的入口:gRPC 一元拦截器(server/transport/middleware.go)
所有服务器端命令最终都会落到 gRPC RPC 调用上,因此审计的核心入口是 server/transport/middleware.go 中的 auditLogUnaryServerInterceptor。该拦截器在认证与权限校验之后、业务 handler 执行之前运行,流程如下:
- 将请求对象序列化为 JSON(
rawRequest); - 尝试从请求中提取目标
session或beacon(通过getActiveTarget解析请求中的SessionID/BeaconID); - 从 gRPC 对端信息中提取调用者身份
User(取自 TLS 客户端证书的CommonName,见getUser)与RemoteIP; - 组装
auditUnaryLogMsg结构并以info级别写入审计日志。
auditUnaryLogMsg(server/transport/middleware.go)的字段定义如下:
| 字段 | 说明 |
|---|---|
request |
请求参数的 JSON 字符串 |
method |
gRPC 全限定方法名,如 /rpcpb.SliverRPC/StartMTLSListener |
session |
(可选)本次命令作用的目标 session 信息(JSON) |
beacon |
(可选)本次命令作用的目标 beacon 信息(JSON) |
remote_ip |
发起调用的对端 IP |
user |
调用者身份,来自 TLS 证书 CN |
由此可以推断:现代版本的审计日志不仅记录了命令与参数,还额外记录了调用者身份、来源 IP 以及作用目标(session/beacon),这比文档示例中的原始三元组(level/msg/time)提供了更丰富的事后分析维度。
3. 敏感数据脱敏(sanitizeAuditRequest)
审计日志会记录命令参数,这自然带来敏感数据泄露风险(例如密码、token、文件内容)。为此,server/transport/middleware.go 提供了 sanitizeAuditRequest 函数,对部分高危 RPC 的请求做写入前的脱敏处理:
- 对
CrackJobCancel/Pause/Resume/Delete等任务控制类 RPC,仅保留任务ID; - 对
Crack(发起破解任务)RPC,清除其中所有字符串与字节类型字段; - 对
CrackTaskByID / CrackTaskUpdate,清空LeaseToken、命令输出(Stdout/Stderr)、状态与恢复数据等敏感字段; - 对
CrackFileChunkUpload等文件传输类 RPC,清空文件数据Data字段。
这提醒我们:审计日志中的 request 字段不一定与真实请求完全一致,对涉及 crack(密码破解)的敏感操作会存在脱敏后的字段空缺,分析时需要注意这一点,避免误判。
4. 事件记录的入口:session / beacon 注册(server/handlers)
审计日志中 level: warn 的条目对应"事件",目前最典型的事件就是新 session / 新 beacon 注册:
- server/handlers/sessions.go 中的
auditLogSession在 session 注册成功后,将Session(protobuf 序列化)与Register(注册信息,含主机、进程、架构等)打包后以warn级别写入审计日志; - server/handlers/beacons.go 中的
auditLogBeacon以同样的方式记录新 beacon 的上线信息(含 beacon 的间隔、抖动、下次回连时间等)。
这就是为什么"新 session/beacon 连接服务器"会作为 warn 级别事件出现在审计日志中的根本原因——它们由专用的注册处理器在核心业务路径上主动写入,而非经过 gRPC 拦截器。
日志轮转与磁盘占用管理
审计日志会持续追加写入,若不加以控制可能无限增长。仓库在 server/log/log.go 中使用 lumberjack 实现了按大小轮转、自动清理的写入器,默认参数为:
DefaultLogMaxSizeMB = 50:单个日志文件超过 50 MB 触发轮转;DefaultLogMaxBackups = 20:最多保留 20 个轮转后的历史文件;DefaultLogMaxAgeDays = 90:超过 90 天的轮转文件会被自动删除;- 轮转文件默认启用压缩(
Compress: true)。
这些默认值可以通过服务器配置文件中的 logs 段覆盖(server/configs/server.go):
logs:
level: 4
grpc_unary_payloads: false
grpc_stream_payloads: false
tls_key_logger: false
max_size_mb: 50
max_backups: 20
max_age_days: 90
compress: true
配置加载后,server/configs/server.go 会调用 log.SetRotationConfig(...) 将上述值应用到包括审计日志在内的所有轮转写入器(见 server/log/log.go 的 SetRotationConfig)。同时,grpc_unary_payloads 与 grpc_stream_payloads 这两个布尔开关控制的是 gRPC 普通日志(非审计日志)中是否记录请求/响应负载,与审计日志是两套独立机制。
实战建议与注意事项
基于上述分析,在真实使用审计日志时建议关注以下几点:
- 尽早确认日志位置:单机模式下审计日志位于
~/.sliver/logs/audit.json;若通过SLIVER_ROOT_DIR定制了根目录,则位于$SLIVER_ROOT_DIR/logs/audit.json。建议在演练开始前明确归档位置,避免事后找不到完整记录。 - 解析时必须做双层 JSON 解析:
msg是字符串化的 JSON,直接jq '.msg'得到的仍是字符串,需二次fromjson才能取出method与request。 - 区分
info与warn:info代表命令执行记录,warn代表事件(新 session/beacon 注册等)。统计命令时用info,统计上线事件时用warn。 - 注意覆盖边界:客户端侧命令、交互式 shell 内部操作不会逐条进入审计日志;涉及 crack 的敏感请求在日志中可能已被脱敏。复盘时应结合客户端命令历史与业务日志交叉核对。
- 监控磁盘轮转:默认 50 MB / 20 个备份 / 90 天的轮转策略适用于大多数场景;若交战周期长、命令量大,可在服务器配置中按需调整
logs段参数。
审计日志是 Sliver 中成本极低但价值极高的基础设施:从单条命令的参数还原,到整场交战的时序重建,再到多 operator 协作的责任追溯,它都能提供完整、机器可读的证据链。掌握其格式与实现原理,你就能针对自身工作流定制出高效的审计分析管线。