USB Canary 项目使用教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00216/article/details/141243178

USB Canary 项目使用教程

usb-canaryA Linux or OSX tool that uses psutil to monitor devices while your computer is locked. In the case it detects someone plugging in or unplugging devices it can be configured to send you an SMS or alert you via Slack or Pushover.项目地址:https://gitcode.com/gh_mirrors/us/usb-canary

1. 项目的目录结构及介绍

USB Canary 是一个用于监控 USB 设备的 Linux 和 OSX 工具。以下是其目录结构及各部分介绍：

usb-canary/
├── LICENSE.txt
├── README.md
├── requirements.txt
├── settings.json
└── usbcanary.py

LICENSE.txt: 项目的许可证文件，遵循 GPL-3.0 许可证。
README.md: 项目说明文档，包含项目的基本介绍、安装和使用方法。
requirements.txt: 项目依赖的 Python 包列表。
settings.json: 项目的配置文件，用于设置通知方式和相关参数。
usbcanary.py: 项目的主启动文件，负责监控 USB 设备并发送通知。

2. 项目的启动文件介绍

usbcanary.py 是 USB Canary 项目的主启动文件。它使用 psutil 库来监控 USB 设备，并在检测到设备插入或移除时发送通知。以下是该文件的主要功能：

监控 USB 设备: 使用 psutil 库实时监控 USB 设备的插入和移除事件。
发送通知: 根据配置文件中的设置，通过 Twilio、Slack 或 Pushover 发送通知。

3. 项目的配置文件介绍

settings.json 是 USB Canary 项目的配置文件。它包含了用于设置通知方式和相关参数的配置项。以下是一个示例配置文件的内容：

{
  "slack": {
    "api_key": "xoxb-111111111111-abcdefghijklmnopqrstuvwx",
    "channel_name": "usb_canary",
    "botname": "USB Canary"
  },
  "twilio": {
    "auth_token": "l7cy56u3Nys72vPNRS8TAbaW3X1Ap4ma",
    "account_sid": "wP32p6qFNzJ25FD1IKM0YtX629eoHbrMiV",
    "twilio_number": "+61491570156",
    "mobile_number": "+61491570157"
  },
  "pushover": {
    "priority": 1,
    "user_key": "youruserkeygoeshere",
    "api_token": "yourapitokengoeshere"
  }
}

slack: 用于配置 Slack 通知的相关参数，包括 API 密钥、频道名称和机器人名称。
twilio: 用于配置 Twilio 短信通知的相关参数，包括认证令牌、账户 SID、Twilio 号码和移动号码。
pushover: 用于配置 Pushover 推送通知的相关参数，包括优先级、用户密钥和 API 令牌。