网络安全【免费下载链接】HavocThe Havoc Framework项目地址https://gitcode.com/gh_mirrors/ha/Havoc点击查看免费下载Havoc 的 Teamserver 用一套类 HCL 的结构化配置语言仓库中内嵌于teamserver/pkg/profile/yaotl/称为 yaotl来描述 Teamserver 监听地址、操作员账号、Listener、Demon 行为等全部运行参数。本文以仓库内 HCL 官方文档的入门页 intro.rst 为主体完整讲解 argument、block、label、body 等核心概念与 JSON 备选语法、参数表达式并结合 Havoc 的 profile 结构体、解码链路与真实.yaotl示例文件说明这套语言在 Havoc 中的具体落地方式。读完后你能够读懂并手写一份合法的 Havoc profile并理解团队服务器是如何按 schema 校验、解码它的。一、HCL 的两个基本构造argument 与 blockHCL-based configuration 由两种主构造组成arguments参数与blocks块。入门文档给出的示例如下io_mode async service http web_proxy { listen_addr 127.0.0.1:8080 process main { command [/usr/local/bin/awesome-app, server] } process mgmt { command [/usr/local/bin/awesome-app, mgmt] } }其中io_mode是一个顶层 argument由名 值构成service引入了一个block块体内可以再包含参数和更深层的嵌套块如上例中service块内的process子块块类型还可以期望若干个labels标签——即service关键字后面的引号名http、web_proxy。需要特别强调的一点是io_mode、service、process这些关键字本身是由应用程序定义的。HCL 只提供通用的块结构语法并基于应用提供的 schema 对配置进行校验和解码。这与 Havoc 的做法完全一致Havoc 把Teamserver、Operators、Listeners、Demon、Service、WebHook这些关键字写进了 Go 结构体标签见下文第三节的 config.goHCL 语言本身并不内置它们。HCL 是一门结构化配置语言而不是数据序列化语言。这意味着与 JSON、YAML、TOML 不同HCL 在解码时始终依赖应用定义的 schema——没有 schema 就无法知道一个块里哪些参数必填、哪些可选。入门文档在 intro.rst 中还给出了同目录 index.rst 中的项目定位作为佐证HCL 是“一种创建对人类和机器都友好的结构化配置语言的工具集”同时提供原生语法和 JSON 变体两种写法。术语辨析body、argument 与 attribute文档对两个术语做了精确区分阅读后续 HCL 资料时经常遇到body主体某一嵌套层级上 arguments 与 blocks 的集合。一个文件永远有一个包含顶层元素的根 body每个块也有自己的 body表示块内的元素attribute vs argument“attribute”也可指代前文所说的“argument”同时它还被用于表示对象值字段。因此argument 专指直接出现在 body 里的那类 attribute以和对象表达式里的字段区分。入门示例展示的是 HCL 配置的一般“质地”texture完整语法细节则收录在同目录的 language_design.rst 等语言规范文档中。整个 guide 是 Sphinx 项目可通过 guide/Makefile 提供的标准sphinx-build目标构建 HTML 文档项目元信息见 guide/conf.py。二、JSON 备选语法同一结构的机器友好写法HCL 提供基于 JSON 的备选语法允许用标准 JSON 序列化器程序化生成配置而不必手写。上一节的示例对应的 JSON 写法为{ io_mode: async, service: { http: { web_proxy: { listen_addr: 127.0.0.1:8080, process: { main: { command: [/usr/local/bin/awesome-app, server] }, mgmt: { command: [/usr/local/bin/awesome-app, mgmt] }, } } } } }这里有两个设计要点值得注意调用方应用自行决定支持哪种语法。JSON 语法对某些应用并不重要但对需要程序化生成配置的应用可用JSON 语法本身是模糊的——例如一个 JSON 对象到底表示“嵌套块”还是“对象表达式”单看 JSON 无法判定。HCL 依靠调用方提供的 schema来消解这种歧义从而正确解码。这与第一节“结构化配置语言”的定位一脉相承无论哪种语法schema 都是解码的必要条件。三、argument 表达式内置运算、变量与自定义函数argument 的值既可以是上文所示的字面量也可以是表达式以支持算术运算、从一个值派生另一个值等listen_addr env.LISTEN_ADDR入门文档对表达式能力给出的事实边界是所有 HCL-based 配置语言自动内置算术与比较运算符调用方应用可以可选地向用户提供变量如示例中的env和自定义函数用于以应用特定方式转换值表达式语法的完整细节在 HCL 原生语法规范中由于JSON 没有表达式语法基于 JSON 的配置文件中表达式以原生语法表达式嵌入 JSON 字符串的方式表达。也就是说表达式的“动态性”上限取决于宿主应用注入了哪些变量和函数——语言本身只提供求值框架。四、在 Havoc 中的落地yaotl 与“schema 即结构体标签”回到 Havoc 仓库上述概念不是纸上谈兵而是 Teamserver 的配置地基HCL 源码被内嵌为 teamserver/pkg/profile/yaotl/ 目录包注释见 doc.go其中明确推荐了最简入口子包hclsimple的Decode函数可将原生 HCL 或 JSON 语法一步解码进 Go 结构体Havoc 的 profile schema 就是第一节所说的“应用提供的 schema”它写在 config.go 的结构体标签里例如type HavocConfig struct { Server *ServerProfile yaotl:Teamserver,block Operators *OperatorsBlock yaotl:Operators,block Listener *Listeners yaotl:Listeners,block Demon *Demon yaotl:Demon,block Service *ServiceConfig yaotl:Service,block WebHook *WebHookConfig yaotl:WebHook,block }这里Teamserver、Operators等正是应用自定义的块关键字对应标签中的block标记而yaotl:Name,label这样的标签声明则实现了第一节描述的带 label 的块如user 5pider { ... }中的5pideroptional标记则对应 schema 中“非必填参数”的校验规则。解码链路见 profile.goSetProfile(path, def)调用yaotl.DecodeFile(path, nil, p.Config)把磁盘上的.yaotl文件直接解入HavocConfig注意第二个参数EvalContext传的是nil——对应hclsimple.Decode的ctx参数“提供表达式求值时使用的变量与函数不需要时可传 nil”也就是说Havoc 的 profile 解析阶段未注入自定义变量/函数配置值均为字面量一步解码的内部实现在 hclsimple.goDecode先经hclsyntax.ParseConfig将源码解析为抽象结构再由gohcl.DecodeBody按 schema 解码求值DecodeFileL72-L96在其上封装了读文件逻辑并对“文件不存在/读取失败”返回带具体摘要的hcl.Diagnostics诊断而不是裸的io错误。该包注释同时说明返回的非 nil 错误均可类型断言为hcl.Diagnostics方便调用方拿到完整错误细节。五、真实 profile 示例从最小配置到完整配置仓库提供了几份可直接对照 schema 的示例 profile最小示例 data/havoc.yaotl——只声明了 Teamserver 监听地址、两个操作员账号和 Demon 基础参数Teamserver { Host 0.0.0.0 Port 40056 } Operators { user 5pider { Password password1234 } user Neo { Password password1234 } } Demon { Sleep 2 Injection { Spawn64 C:\\Windows\\System32\\notepad.exe Spawn32 C:\\Windows\\SysWOW64\\notepad.exe } }其中user 5pider正是 label 语法块关键字user后跟一个引号标签作为用户名密码则是块内 argument。完整示例 profiles/http_smb.yaotl 覆盖了几乎所有顶层块可与 config.go 中的字段一一对应Teamserver { Host 0.0.0.0 Port 40056 Build { Compiler64 /usr/bin/x86_64-w64-mingw32-gcc Compiler86 /usr/bin/i686-w64-mingw32-gcc Nasm /usr/bin/nasm } } Operators { user 5pider { Password password1234 } user Neo { Password password1234 } } Listeners { Http { Name teams profile - http Hosts [5pider.net] HostBind 0.0.0.0 HostRotation round-robin PortBind 443 PortConn 443 Secure false KillDate 2024-01-02 12:00:00 UserAgent Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 ... Uris [/Collector/2.0/settings/] Headers [ Accept: json, Referer: https://teams.microsoft.com/_ ] Response { Headers [ Content-Type: application/json; charsetutf-8, Server: Microsoft-HTTPAPI/2.0 ] } } Smb { Name Pivot - Smb PipeName demon_pipe } } Service { Endpoint service-endpoint Password service-password } Demon { Sleep 2 Jitter 20 TrustXForwardedFor false Injection { Spawn64 C:\\Windows\\System32\\Werfault.exe Spawn32 C:\\Windows\\SysWOW64\\Werfault.exe } }对照 config.go 可以看到几个与 HCL 概念直接对应的细节Listeners块下Http、Smb、External是三种并列的子块对应结构体中ListenerHTTP、ListenerSMB、ListenerExternal三个切片字段yaotl:Http,block等即同一 body 下可出现多个同类型块解码结果为数组KillDate、Jitter、UserAgent等字段带optional标记可省略而Host、Port、HostBind、PortBind等不带属于 schema 必填项注释中的格式约定也值得注意KillDate采用2006-01-02 15:04:05布局WorkingHours采用8:00-17:00区间写法见 config.go 中的字段注释其他可参考的示例还有 profiles/havoc.yaotl 与 profiles/webhook_example.yaotl后者演示WebHook.Discord块对应WebHookConfig结构体。六、小结以 intro.rst 为骨架HCL 的核心要点可以浓缩为四句话配置由arguments 与 blocks构成块可带labels每个嵌套层级是一个body块关键字与参数名由应用定义HCL 依据应用提供的schema完成校验与解码——Havoc 中该 schema 就是config.go的结构体标签提供JSON 备选语法便于程序化生成配置其歧义同样由 schema 消解argument 值可以是表达式内置算术与比较运算符宿主应用可注入变量与自定义函数Havoc 当前通过EvalContext nil未注入变量见 profile.go 修正见 profile.go。掌握以上内容后阅读 guide/go.rst、guide/go_decoding_gohcl.rst 等进阶文档时就能把 HCL 的解析、求值、解码多阶段管线与 Havoc 的hclsimple.DecodeFile单步调用对应起来。赞分享网络安全【免费下载链接】HavocThe Havoc Framework项目地址https://gitcode.com/gh_mirrors/ha/Havoc点击查看免费下载相关推荐Havoc Teamserver yaotl userfunc用 HCL 用户自定义函数扩展 .yaotl 配置语言Havoc Teamserver yaotl userfunc用 HCL 用户自定义函数扩展 .yaotl 配置语言 在 Havoc 的 Teamserver网络安全Havoc Teamserver 配置体系解析HCL 配置语言工具包与 yaotl Profile 的完整实现Havoc Teamserver 配置体系解析HCL 配置语言工具包与 yaotl Profile 的完整实现 HCLHashiCorp Configura网络安全Havoc Teamserver 配置解析管线hclparse 入口与 YaotlHCL解析机制详解Havoc Teamserver 配置解析管线hclparse 入口与 YaotlHCL解析机制详解 本篇以 Havoc 团队服务器Teamserver网络安全上一篇终极网盘直链解析工具告别限速开启全平台高速下载新时代下一篇告别网盘限速困扰LinkSwift直链下载助手的完整解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
