把安装包和 SHA-256 文件一起复制到隔离网,能检查传输损坏,却不能证明包来自发布方:能替换安装包的人,也可能重算旁边的摘要。本文搭建一条离线验收链路:发布方签署清单,接收方用预置公钥验签,再检查版本与包摘要,全部成功后才允许进入部署阶段。

这是一套可复现的实验交付流程,不是生产事故复盘。主要技术栈为 OpenSSL 与 PowerShell 7,适用于 Windows 离线交付、人工介质传递和内部制品中转。示例只接收一个固定文件名,刻意不实现解压与安装,避免把“验签成功”误当成“安装过程安全”。

一、先确定谁可以被信任

签名私钥留在发布侧;接收侧的 release-public.pem 通过独立可信渠道预置,并设置为普通交付账号不可改写。公钥不能从本次待验收包中自动导入,否则攻击者可以替换包、清单、公钥和签名四件套。

接收侧还必须预先知道本次批准的版本,例如 2026.11.18.1。这不是从清单里读出来再传回验收函数的值,而应来自审批记录或受控部署参数。签名正确只证明持钥方签过这些字节,不证明它是当前批准版本,也不证明构建源代码没有漏洞。

本例协议固定如下:清单为 UTF-8 无 BOM JSON,字段仅有 schema、product、version、file、sha256;产品固定为 demo-agent,文件固定为 package.bin,摘要为 64 位大写十六进制。签名针对清单文件的原始字节,验签前不重新序列化 JSON。

二、准备一个不会忽略退出码的命令边界

在 PowerShell 7 中创建独立实验目录,进入后执行下面的定义。OpenSSL 3.x 必须已安装;如果没有在 PATH 中,将 $opensslPath 改成已知的可执行文件路径。实验不需要网络。

$ErrorActionPreference = 'Stop'
# 统一 PowerShell 与 .NET 的相对路径基准,实验期间不再切换目录。
[System.Environment]::CurrentDirectory = (Get-Location).Path
$opensslPath = (Get-Command openssl -ErrorAction Stop).Source
$utf8 = [System.Text.UTF8Encoding]::new($false, $true)

function Invoke-Crypto {
    param([string[]]$Arguments)
    $start = [System.Diagnostics.ProcessStartInfo]::new()
    $start.FileName = $opensslPath
    $start.UseShellExecute = $false
    # 输出不经管道转码;固定英文输出来自 OpenSSL 协议工具。
    foreach ($argument in $Arguments) { $start.ArgumentList.Add($argument) }
    $process = [System.Diagnostics.Process]::Start($start)
    try {
        if (-not $process.WaitForExit(30000)) {
            $process.Kill($true)
            $process.WaitForExit()
            throw 'OpenSSL 执行超时'
        }
        if ($process.ExitCode -ne 0) {
            throw "OpenSSL 执行失败,退出码:$($process.ExitCode)"
        }
    } finally {
        $process.Dispose()
    }
}

使用参数数组传参,不把路径拼成 shell 字符串。示例让 OpenSSL 直接向终端输出,不捕获或猜测其编码;自动采集日志时应另建字节读取与显式解码边界。生产日志只保留命令名称、退出码、版本和验收阶段,不能把私钥或敏感文件内容写进去。

三、发布侧:签署一个明确的交付版本

以下代码在新的实验目录中执行一次;release-private.pem 是临时实验密钥,不得用于真实发布,也不要把它打进交付包。为了让实验自动运行,这里生成未加密私钥。真实环境应使用受控签名服务、硬件密钥或经过权限与加密保护的私钥,不能照搬本例的密钥存储方式。

Invoke-Crypto -Arguments @('genpkey', '-algorithm', 'RSA', '-pkeyopt', 'rsa_keygen_bits:3072', '-out', 'release-private.pem')
Invoke-Crypto -Arguments @('pkey', '-in', 'release-private.pem', '-pubout', '-out', 'release-public.pem')

[System.IO.File]::WriteAllBytes('package.bin', [byte[]](10, 20, 30, 40))
$manifest = [ordered]@{
    schema = 1
    product = 'demo-agent'
    version = '2026.11.18.1'
    file = 'package.bin'
    sha256 = (Get-FileHash -LiteralPath 'package.bin' -Algorithm SHA256).Hash
}
[System.IO.File]::WriteAllText('manifest.json', ($manifest | ConvertTo-Json -Compress), $utf8)
Invoke-Crypto -Arguments @('dgst', '-sha256', '-sign', 'release-private.pem', '-out', 'manifest.sig', 'manifest.json')

对 RSA 密钥,本例使用 dgst 的 RSA PKCS#1 v1.5 签名默认行为,摘要显式指定 SHA-256。算法由接收程序固定,不能让不可信清单决定使用哪个验证算法。OpenSSL 的签名与验签参数见官方 dgst 文档。

实际传输三件套:package.bin、manifest.json、manifest.sig。公钥走预置信任渠道;私钥绝不传输。清单签署后,格式化、换行转换、编码变化都会改变被签名字节,不能在中转环节美化 JSON。

四、接收侧:先验签,再判断是否允许部署

实验中继续使用当前目录的公钥;真实接收端应把代码中的公钥参数换成受保护的绝对路径。将三件套放在受控暂存目录中,停止上传后再执行验收;验收期间不允许其他账号写入。否则检查后被替换的文件可能进入安装阶段,形成检查与使用之间的竞态。

function Assert-Delivery {
    param([Parameter(Mandatory)][string]$ExpectedVersion)
    foreach ($name in @('manifest.json', 'manifest.sig', 'package.bin')) {
        $item = Get-Item -LiteralPath $name -Force
        if ($item.PSIsContainer -or ($item.Attributes -band [System.IO.FileAttributes]::ReparsePoint)) {
            throw "交付项必须是普通文件:$name"
        }
    }
    if ((Get-Item -LiteralPath 'manifest.json').Length -gt 4096 -or
        (Get-Item -LiteralPath 'manifest.sig').Length -ne 384) {
        throw '清单或 RSA-3072 签名长度不符合协议'
    }
    Invoke-Crypto -Arguments @('dgst', '-sha256', '-verify', 'release-public.pem', '-signature', 'manifest.sig', 'manifest.json')
    $document = [System.IO.File]::ReadAllText('manifest.json', $utf8) | ConvertFrom-Json -AsHashtable
    $keys = @($document.Keys | Sort-Object)
    if (($keys -join ',') -cne 'file,product,schema,sha256,version') {
        throw '清单字段不符合协议'
    }
    if ($document.schema -isnot [long] -and $document.schema -isnot [int]) {
        throw '清单协议版本必须是整数'
    }
    if ($document.schema -ne 1 -or $document.product -cne 'demo-agent' -or
        $document.file -cne 'package.bin' -or
        $document.version -isnot [string] -or $document.version -cne $ExpectedVersion -or
        $document.sha256 -isnot [string] -or $document.sha256 -cnotmatch '^[0-9A-F]{64}$') {
        throw '产品、版本、文件名或摘要格式不符合批准记录'
    }
    $actualHash = (Get-FileHash -LiteralPath 'package.bin' -Algorithm SHA256).Hash
    if ($actualHash -cne $document.sha256) { throw '制品摘要不匹配,拒绝部署' }
    Write-Host '交付验收通过,允许进入部署审批后的安装步骤'
}

Assert-Delivery -ExpectedVersion '2026.11.18.1'

签名长度 384 字节来自固定 RSA-3072 协议,轮换为其他位数时必须同步修改协议,不能直接套用。本例把文件名固定在程序里,不接受清单提供的任意路径,因此 ../../、绝对路径和跨目录文件名都不能成为读取目标。

验签成功后才解析清单,意味着无签名的外部 JSON 不能驱动后续文件读取。本例依赖受信发布方生成固定格式 JSON,不是通用多租户签名文档解析器;不要拓展成接受未知签发者、重复 JSON 键或任意嵌套结构的平台接口。

五、用失败演练证明门禁确实存在

下面的实验会恢复原始制品并生成一把临时错误密钥。预期每次被拒绝时打印中文提示;若某次意外放行,测试会抛错。整段执行完毕后正常交付仍必须通过。

function Assert-Rejected {
    param([scriptblock]$Action)
    $isRejected = $false
    try { & $Action } catch { $isRejected = $true }
    if (-not $isRejected) { throw '失败演练意外放行' }
    Write-Host '失败演练按预期拒绝'
}
$originalPackage = [System.IO.File]::ReadAllBytes('package.bin')
$originalManifest = [System.IO.File]::ReadAllBytes('manifest.json')
try {
    [System.IO.File]::WriteAllBytes('package.bin', [byte[]](10, 20, 30, 41))
    Assert-Rejected { Assert-Delivery -ExpectedVersion '2026.11.18.1' }
    [System.IO.File]::WriteAllBytes('package.bin', $originalPackage)
    [System.IO.File]::WriteAllText('manifest.json', '{}', $utf8)
    Assert-Rejected { Assert-Delivery -ExpectedVersion '2026.11.18.1' }
} finally {
    [System.IO.File]::WriteAllBytes('package.bin', $originalPackage)
    [System.IO.File]::WriteAllBytes('manifest.json', $originalManifest)
}
Invoke-Crypto -Arguments @('genpkey', '-algorithm', 'RSA', '-pkeyopt', 'rsa_keygen_bits:3072', '-out', 'wrong-private.pem')
Invoke-Crypto -Arguments @('pkey', '-in', 'wrong-private.pem', '-pubout', '-out', 'wrong-public.pem')
Assert-Rejected {
    Invoke-Crypto -Arguments @('dgst', '-sha256', '-verify', 'wrong-public.pem', '-signature', 'manifest.sig', 'manifest.json')
}
# 模拟审批已要求新版本,但交付侧重放了旧版本的完整合法三件套。
Assert-Rejected { Assert-Delivery -ExpectedVersion '2026.11.19.1' }
Assert-Delivery -ExpectedVersion '2026.11.18.1'
演练 签名是否仍可能正确 拦截位置
修改制品一个字节 是,清单没变 制品摘要比较
替换清单为其他内容 否 清单验签
使用其他公钥验签 否 清单验签
重放旧版本的完整三件套 是 受控批准版本比较

不要以终端出现 Verified OK 作为整个部署成功的标准:它只对应清单验签这一阶段。摘要检查、版本策略与实际安装仍是独立步骤。OpenSSL 输出文本可能随版本变化,程序应依赖退出码。

六、接入真实发布流程时的取舍

本地签名比只发布摘要多了一条身份信任链,但也增加了私钥生命周期管理成本。多人发布、短期身份或需要公开透明审计的场景,应评估现有制品签名平台,避免自己逐步造出一个不完整的证书体系。

密钥轮换先通过可信渠道分发新公钥及指纹,接收侧只允许明确批准的有限公钥集合,再切换签发侧。不要尝试包内所有公钥直到某一把通过;密钥泄露时停止签发、撤销接收信任并重新核准制品,单纯换钥不能让已签恶意包自动失效。

制品大时 Get-FileHash 会读取整个文件;将验收放在隔离暂存区,并按交付容量限制磁盘占用与操作时长。不要先解压或执行安装脚本再验签。若需要目录交付,先封装为单个固定格式归档,验收归档后还要独立处理解压路径穿越、链接文件和权限问题。

审计建议记录 product、release_version、artifact_sha256、key_id、verification_stage 和 result。部署记录必须关联实际使用的那个受保护文件;验收后仍允许覆盖的共享目录无法提供这个保证。回滚同样要有独立批准版本,不能通过关闭版本检查来实现。

验证范围

本文在 Windows PowerShell 7.6.5、OpenSSL 3.5.6 上执行完整代码,覆盖正常交付、制品篡改、清单篡改、错钥和旧版本回放。另将摘要比较门禁删除后,制品篡改演练因意外放行而失败,确认测试能发现这一防线缺失。UTF-8 无 BOM、代码围栏与 PowerShell 语法检查通过。实验目录中的所有私钥均为临时生成,不包含生产身份。未验证真实介质传输、权限隔离、硬件密钥、CI 签名服务或安装程序;这些集成边界需要在自己的环境验收。

签名门禁的价值在于把“发布方身份、批准版本、实际字节”连接起来。只有这三个条件都满足,交付包才有资格进入部署流程。