1 个不稳定发布

0.1.1 2022 年 2 月 1 日
0.1.0 2022 年 2 月 1 日

#20 in #回归

MIT/Apache

22KB
378

cowbird

Crates.io Docs.rs CI Coverage Status

关于

cowbird 是一个触发端点检测和响应 (EDR) 代理的工具,并生成用于回归测试的结构化日志。

安装

选择安装 cowbird 的方法

从发行版安装

  • 发行版 下载您架构的最新预构建二进制文件。
  • 验证 shasum 并解压缩到您的路径,例如
RELEASE=cowbird-0.1.1-macos-x86_64
sha256sum -c ${RELEASE}.shasum
tar -C /usr/local/bin ${RELEASE}.tar.gz

从 Cargo 安装

  • 按照 此指南 安装 rust 工具链,以便安装 cargo。
  • 运行 cargo install cowbird

命令

cowbird 0.1.1
EDR tool

USAGE:
    cowbird [OPTIONS] <SUBCOMMAND>

OPTIONS:
    -l, --log <LOG>    Log file location [default: cowbird.log]
    -h, --help         Print help information
    -V, --version      Print version information

SUBCOMMANDS:
    start     Starts a new process
    create    Create a file
    modify    Modify a file
    delete    Delete a file
    send      Send data over network
    script    Run commands from YAML input
cowbird-start 
Starts a new process

USAGE:
    cowbird start <EXEC> [ARGS]...

ARGS:
    <EXEC>       
    <ARGS>...    
cowbird-create 
Create a file

USAGE:
    cowbird create <FILE>

ARGS:
    <FILE>    File to create
cowbird-modify 
Modify a file

USAGE:
    cowbird modify <FILE> <DATA> [OFFSET]

ARGS:
    <FILE>      File to modify
    <DATA>      Bytes to write, decode hex if value starts with "0x"
    <OFFSET>    Byte offset for writing data [default: 0]
cowbird-delete 
Delete a file

USAGE:
    cowbird delete <FILE>

ARGS:
    <FILE>    File to delete
cowbird-send 
Send data over network

USAGE:
    cowbird send <DEST> [ARGS]

ARGS:
    <DEST>     Destination address:port
    <DATA>     Bytes to write, decode hex if value starts with "0x" [default: ]
    <PROTO>    Network protocol to use [default: udp] [possible values: tcp, udp]
cowbird-script 
Run commands from YAML input

USAGE:
    cowbird script [FILE]

ARGS:
    <FILE>    File to read [default: -]

OPTIONS:
    -h, --help    Print help information

脚本示例

请参阅 examples/test.yaml,了解如何使用 YAML 文档分隔符来摄取多个命令,以及如何格式化这些命令输入。

如果在一个类似 Unix 的系统上从源代码构建,可以使用 ./examples/test.yaml 运行示例,或者可以使用预构建的二进制文件运行脚本,使用 cowbird script ./examples/test.yaml

许可

根据您选择的任何一种许可

任选其一。

贡献

除非您明确声明,否则根据 Apache-2.0 许可证定义的,您有意提交的任何贡献,包括但不限于在作品中的包含,都应双重许可如上所述,不附加任何额外的条款或条件。

请参阅 CONTRIBUTING.md

依赖

~10–22MB
~312K SLoC