首页 / 文章

反重力CLI迁移:终端中的OWASP扫描与自动修复功能

将 Gemini CLI 安全扩展移至 Antigravity CLI,运行支持 ISO 27001 控制的本地 OWASP 及依赖项扫描,并让代理程序修复 SQL 注入漏洞。

发布者:REACTAPP.TOP阅读约 6 分钟1347 词

来源: From Gemini CLI to Antigravity CLI: Automated OWASP Security Compliance and Agentic Remediation in Your Terminal

谷歌已将 Gemini CLI 更名为Antigravity CLI,它属于更广泛的 Antigravity 2.0 生态系统的一部分。过去一年里一直使用 Gemini CLI 扩展功能来定制终端的用户,很自然会想知道自定义工作流和自动化安全审计在本次变更后是否依然有效。答案是肯定的,而且迁移过程也非常简单。以下内容将介绍为何本地 OWASP 扫描对合规性至关重要、如何将安全扩展功能迁移过去,以及代理如何在不离开终端壳层的情况下修复检测出的问题。

为何合规性要求进行本地扫描

企业采购方及其内部的合规官员迟早会问一个问题:该团队是否遵循安全编码标准?通常这是依据国际信息安全管理体系标准ISO/IEC 27001来进行的检查。2022年修订版中有三项控制措施直接适用于开发工作:

  • A.8.25,安全开发生命周期:规定在整个软件生命周期中保障安全的规则与指南。
  • A.8.28,安全编码:防止常见软件漏洞出现在代码中的原则。
  • A.8.29,开发过程中的安全测试:在开发过程中规划并执行安全测试,包括静态应用安全测试和依赖关系分析。

要在不被繁琐文档工作淹没的情况下满足这些要求,最简单的方法是将编码规则与广为认可的网页漏洞清单OWASP Top 10相结合。如果一个团队能够证明其持续依据该清单对代码进行扫描和修复,就能让审计人员感到十分安心。

从 Gemini CLI 到 Antigravity CLI

直到最近,谷歌的轻量级终端助手还是开源工具 Gemini CLI,它拥有用于执行基于人工智能的 SAST 审计的官方安全扩展。在 Gemini CLI 中,安装命令为:

gemini extensions install https://github.com/gemini-cli-extensions/security

Antigravity 2.0 将可视化工具与命令行界面整合为统一的工具集。该命令行界面支持多步骤推理、多文件编辑、沙箱式执行,还可直接通过 shell 调用相关工具,其二进制别名为 agy。

得益于内置的一次性导入功能,现有的 Gemini 扩展程序也能轻松被引入。

agy plugin import gemini

该命令会读取旧的 ~/.gemini/ 目录,获取安全扩展及其他所有自定义扩展,将它们重新打包为新的 Plugins 格式并存放在 ~/.gemini/antigravity-cli/plugins/ 下,同时将 settings.json 转换为新的格式。在确认之前原始文件不会被修改,因此升级只需几秒钟,且可以轻松撤销。

新安装的 Antigravity 可以跳过导入步骤,直接安装该插件:

agy plugin install https://github.com/gemini-cli-extensions/security

为何不将一切交给持续集成?

成熟的团队通常已经部署了包含企业级扫描工具的完善持续集成/持续交付流程:

  • 静态分析(SAST):如SonarQube、Semgrep或GitHub Advanced Security中的CodeQL等工具。
  • 依赖项扫描(SCA):Snyk和Mend是常见的选择。
  • 动态测试(DAST):StackHawk,或免费的OWASP ZAP。

这些工具能为生产环境提供出色的防护机制,但有一个重大缺点:它们运行速度慢且反应迟缓。想象一下,你提交代码、创建拉取请求并去喝咖啡,结果15分钟后却收到测试失败的消息,因为扫描工具发现了不安全的CORS设置或SQL注入问题。开发者不得不切换工作环境、拉取对应分支、修复问题后再推送并再次等待。这便是所谓的“流程等待之痛”。

对于个人项目、在 Google AI Studio 中快速制作的原型,或是完全没有流程管理的旧代码库而言,情况会更糟。一个在本地运行的安全插件可以填补这一空白,在任何人输入 git push 之前就进行基于 AI 的扫描。

C 语言的实战示例

以一个典型的 ASP.NET Core 控制器为例。为了尽快发布,开发人员在 Controllers/UserController.cs 中编写了如下代码:

[HttpGet("{id}")]
public async Task<IActionResult> GetUser(string id)
{
    // [VULNERABILITY] Classic raw string concatenation SQL Injection!
    string query = "SELECT * FROM Users WHERE Id = '" + id + "'";
    using (var connection = new SqlConnection(_connectionString))
    {
        var command = new SqlCommand(query, connection);
        connection.Open();        using (var reader = await command.ExecuteReaderAsync())
        {
            // Read user info and return...
        }
    }
}

这属于典型的 OWASP A03:2021 注入 漏洞,因为用户输入被直接拼接到了 SQL 字符串中。

要在本地检测该漏洞,进入项目目录并启动 CLI:

agy

在交互式会话中,一个原生的反重力安全插件会通过以下命令执行完整分析:

/security:analyze

从 Gemini CLI 导入的配置会获得一个命名空间前缀,从而避免命令冲突:

/gemini-cli-security:analyze

两者都使用相同的引擎。带前缀的形式只是保持现有设置不变,包括那些调用旧命令的硬编码终端脚本。该插件会启动基于人工智能的静态扫描,并在几秒钟内输出格式化的报告:

[HIGH] SQL Injection Vulnerability Detected
File: Controllers/UserController.cs, Line 5
Severity: High (OWASP A03:2021-Injection)
Description: The query is constructed by concatenating untrusted user input directly. An attacker can manipulate the 'id' parameter to execute arbitrary SQL commands.

检查依赖项

第三方软件包也需要进行扫描,该插件为此提供了专用命令。其原生版本如下所示:

/security:scan-deps

导入版本带有前缀:

/gemini-cli-security:scan-deps

它会解析 .csproj 或 package.json 文件,并将其中的内容与谷歌的开源漏洞数据库OSV.dev进行比对。最终会列出存在已知CVE漏洞的不安全包以及应升级到的版本。

与 Gemini CLI 相比有一个值得注意的不同点:在 Gemini CLI 中,与 MCP 相关的功能会自动以斜杠命令的形式出现,而 Antigravity CLI 并不会这样处理,这些功能必须明确以命令格式书写。由于 OSV-Scanner MCP 是随安全工具包一同安装的,因此如截图所示,仍可通过对话式请求来使用这些功能。

让智能体自行修复

传统的扫描工具只是旁观者。它们只会发出故障警告,却从不亲自处理问题,随后将报告留在收件箱中,把重构工作推给开发者。

Antigravity CLI具有智能代理功能。它能够查看工作区中的文件,在安全的容器沙箱中执行命令,并对多步骤的修改进行逻辑处理。在通过/security:analyze或/gemini-cli-security:analyze指令检测到注入漏洞后,无需手动编辑ADO.NET查询语句,只需发送简单请求即可,例如让代理修复UserController.cs中发现的SQL注入问题。

该智能代理会读取文件,规划修复方案,然后使用参数化查询重新编写代码:

[HttpGet("{id}")]
public async Task<IActionResult> GetUser(string id)
{
    // [REMEDIATED] Secure parameterized query!
    string query = "SELECT * FROM Users WHERE Id = @Id";
    using (var connection = new SqlConnection(_connectionString))
    {
        var command = new SqlCommand(query, connection);
        command.Parameters.AddWithValue("@Id", id);
        connection.Open();        using (var reader = await command.ExecuteReaderAsync())
        {
            // Read user info and return...
        }
    }
}

以代码审查为驱动的开发模式是默认设置,因此该工具不会盲目覆盖任何内容。它会在终端中显示差异,并要求用户确认:

Antigravity Agent applied changes to Controllers/UserController.cs.
Do you want to accept these changes?
> Yes, apply changes.
  No, undo changes.

按下回车键后更改即刻生效,无需上下文切换或管道等待,可直接进行审计。

对团队而言有哪些变化

从 Gemini CLI 转换为 Antigravity CLI 后,原本类似代码检查工具的辅助程序变成了驻留在终端中的自主安全代理。由此带来三大实际优势:

  • 持续合规性。本地 OWASP 扫描可在不降低交付速度的情况下,支持 ISO 27001 等标准中的安全编码要求。
  • 轻松迁移。原有的 Gemini 扩展可通过 agy plugin import gemini 变为 Antigravity 插件。
  • 提前干预的代理式防护。不仅能在本地发现漏洞,该代理还能立即修复它们。

最简单的判断方法是在本地项目中试一试:导入旧的安全扩展,运行分析,让智能代理提出修复方案。