CSAF Walker

从远程服务器“遍历”CSAF数据，允许您处理这些数据。

此外，此仓库还包含一个用于处理SBOM数据的工具。大多数选项对SBOM和CSAF都有效。

从命令行

有一个命令行工具，可以直接使用。

安装

从GitHub发布页面下载一个可执行的二进制文件：https://github.com/ctron/csaf-walker/releases

您还可以使用cargo binstall安装此类二进制文件

cargo binstall csaf-cli
cargo binstall sbom-cli

或自行编译，使用简单的cargo install

cargo install csaf-cli
cargo install sbom-cli

使用方法

通过提供CSAF可信提供者的域名，您可以下载所有文档

mkdir out
csaf sync -3 -v -d out/ redhat.com

也可以只下载文件，跳过验证步骤（稍后可以使用已下载的副本进行验证）

mkdir out
csaf download -3 -v -d out/ redhat.com

[!NOTE] 在数据使用GPG v3签名的情况下，您可以使用-3标志，这仍被视为有效。

另一种方法是使用--policy-date参数，并手动提供策略日期。另请参阅：https://docs.sequoia-pgp.org/sequoia_openpgp/policy/struct.StandardPolicy.html。

差异同步

默认情况下，HTTP服务器报告的时间戳将应用于下载的文件。当重新运行时，将使用changes.csv文件作为源，以发现文件何时被更改。如果文件已经存在，并且在changes.csv文件中有更新的修改时间戳，则将再次下载该文件。否则，将跳过。

使用--since选项，可以提供起始时间戳，这将跳过在时间戳之前报告的所有更改，并强制在时间戳之后（无论文件本地时间戳如何）的所有更改重新同步。

使用--since-file选项，可以通过最初从文件中加载“since”值，并在成功运行结束时将其存储到文件中来自动化“since”值。

如果同时提供了--since和--since-file，则首先使用“since file”，如果文件不存在，则“since”值将作为后备。

发送数据

除了存储之外，还可以将数据发送到远程实例（使用Vexination或Bombastic API）。

csaf send -3 redhat.com https://127.0.0.1:8083

当然，也可以使用文件系统作为源

csaf send -3 file:out/ https://127.0.0.1:8083

作为库

使用crate csaf-walker，这也可以用作库

use anyhow::Result;
use url::Url;
use csaf_walker::source::HttpSource;
use csaf_walker::walker::Walker;
use csaf_walker::retrieve::RetrievingVisitor;
use csaf_walker::validation::{ValidatedAdvisory, ValidationError, ValidationVisitor};
use walker_common::fetcher::Fetcher;

async fn walk() -> Result<()> {
    let fetcher = Fetcher::new(Default::default()).await?;
    let metadata = MetadataRetriever::new("redhat.com");
    let source = HttpSource::new(metadata, fetcher, Default::default());

    Walker::new(source.clone())
        .walk(RetrievingVisitor::new(
            source.clone(),
            ValidationVisitor::new(
                move |advisory: Result<ValidatedAdvisory, ValidationError>| async move {
                    log::info!("Found advisory: {advisory:?}");
                    Ok::<_, anyhow::Error>(())
                },
            )
        ))
        .await?;

    Ok(())
}