inhibitor_tool

inhibitor_tool

Introduction

inhibitor_tool is a Python CLI tool for adding items to an inhibition list via an API, with authentication handled via auth_token.

Installation

link: https://pypi.org/project/inhibitor-tool/

bash 复制代码
pip3 install inhibitor_tool==5.2.1




---

**inhibitor_tool**  

📌 Introduction  

inhibitor_tool is a Python CLI tool that allows users to send inhibition requests via an API.  
It supports authentication through environment variables loaded from auth_token.  


---

🛠 Installation  
You can install the package using pip:  

pip3 install inhibitor_tool


---

🔧 Configuration  

1️⃣ Set Up Authentication  
Before using inhibitor_tool, you must configure authentication credentials in ~/.auth_token and load them into the environment:  

export USERNAME=mmwei3
export PASSWORD=mmwei
export LOGIN_URL=http:///api/v1/user/login
export INHIBIT_URL=http:///api/v1/alarm/blacklist
export REMOVE_URL=http://api/v1/alarm/blacklist
export LIST_URL=http:///api/v1/alarm/blacklist?

source ~/.auth_token

💡 Important: The source ~/.auth_token command must be executed every time a new session is started.


---


---

🚀 Usage  

2️⃣ Inhibit an Item (Default TTL: 3 hours)  
[root@domp ~]# inhibitor-tool  --help
usage: inhibitor-tool [-h] [--version] {add,remove,list} ...

CLI tool for inhibition requests.

positional arguments:
  {add,remove,list}  Available commands
    add              Send an inhibition request.
    remove           Remove an inhibition request.
    list             List all active inhibitions.

optional arguments:
  -h, --help         show this help message and exit
  --version, -V      Show program's version number and exit.
[root@domp ~]#



inhibitor-tool add --content "MaliciousIP:192.168.1.1"

3️⃣ Specify a Custom TTL  
inhibitor-tool add --content "MaliciousIP:192.168.1.1" --ttl 6
- --ttl 6 means the inhibition will last 6 hours (default is 3 hours).  

4️⃣ Add a Custom Remark  
inhibitor-tool add --content "MaliciousIP:192.168.1.1" --ttl 6 --remark "Security alert"
- The remark helps track the reason for inhibition.  
- If omitted, it defaults to "tmp_inhibitor".

5️⃣ Remove an Inhibition  
inhibitor-tool remove --content "MaliciousIP:192.168.1.1"
- This command removes an inhibition entry matching the provided content.  

6️⃣ List Active Inhibitions  
inhibitor-tool list
- Displays active inhibitions in a shell-friendly table format.

🔹 JSON Output Format  
inhibitor-tool list --json
- Outputs inhibition data in JSON format, suitable for scripting.

7️⃣ Check Version  
inhibitor-tool --version
inhibitor-tool -V


---

2️⃣ Inhibit an Item (Default TTL: 3 hours)  
inhibitor-tool --content "MaliciousIP:192.168.1.1"

3️⃣ Specify a Custom TTL  

[root@domp ~]# inhibitor-tool  --help
usage: inhibitor-tool [-h] [--version] {add,remove,list} ...

CLI tool for inhibition requests.

positional arguments:
  {add,remove,list}  Available commands
    add              Send an inhibition request.
    remove           Remove an inhibition request.
    list             List all active inhibitions.

optional arguments:
  -h, --help         show this help message and exit
  --version, -V      Show program's version number and exit.
[root@domp ~]#





inhibitor-tool add  --content "MaliciousIP:192.168.1.1" --ttl 6
- --ttl 6 means the inhibition will last 6 hours (default is 3 hours).  

4️⃣ Add a Custom Remark  
inhibitor-tool add  --content "MaliciousIP:192.168.1.1" --ttl 6 --remark "Security alert"
- The remark helps track the reason for inhibition.  
- If omitted, it defaults to "tmp_inhibitor".


---

📜 Open-Source Information  
- Author: mmwei3  
- Email: [email protected]  
- Contact: 178555350258  
- Date: 2025-03-19  
- License: MIT License  


---

📦 Packaging & Deployment  

5️⃣ Build the Package  
python setup.py sdist bdist_wheel

6️⃣ Install from Local Package  
pip install dist/inhibitor_tool-1.0.0-py3-none-any.whl

7️⃣ Uninstall the Package  
pip uninstall inhibitor_tool


---

📜 License (MIT)  
MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...


---

**📌 Dependencies (requirements.txt)**  
requests


---

This README.md provides a clear, structured, and fully configurable CLI tool for API-based inhibition with authentication and pip installation. 🚀
相关推荐
只可远观8 小时前
Flutter 泛型 泛型方法 泛型类 泛型接口
服务器·windows·flutter
葡萄学妹9 小时前
Windows server:
windows
zhishishe9 小时前
如何修复卡在恢复模式下的 iPhone:简短指南
windows·macos·ios·objective-c·cocoa·iphone
Icoolkj10 小时前
在 Windows 系统上升级 Node.js
windows·node.js
长沙火山12 小时前
9.ArkUI List的介绍和使用
数据结构·windows·list
donglxd15 小时前
老电脑优化全知道(包括软件和硬件优化)
运维·windows·系统安全
ZXF-BW20 小时前
联想笔记本电脑在Windows下通过联想驱动实现风扇控制
windows·电脑·联想·风扇
csdn_aspnet1 天前
如何在 Windows 10 中使用 WSL 和 Debian 安装 Postgresql 和 Postgis
windows·postgresql·debian
九鼎科技-Leo1 天前
写windows服务日志-.net4.5.2-定时修改数据库中某些参数
数据库·windows·.net
扛枪的书生1 天前
AD 侦查-MSRPC
windows·渗透·kali·提权·域渗透