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: mmwei3@iflytek.com  
- 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. 🚀
相关推荐
汤愈韬10 小时前
NTFS权限基础、权限累加规则、权限继承规则
windows·网络安全
刺客xs11 小时前
linux GDB调试器
linux·运维·windows
哦你看看11 小时前
学习Python 03
开发语言·windows·python
草莓工作室12 小时前
数据结构3:线性表2-顺序存储的线性表
数据结构·windows
阿拉-M8313 小时前
IntelliJ IDEA Windows 系统高频快捷键使用手册
java·windows·intellij-idea
lingggggaaaa13 小时前
小迪安全v2023学习笔记(一百三十四讲)—— Windows权限提升篇&数据库篇&MySQL&MSSQL&Oracle&自动化项目
java·数据库·windows·笔记·学习·安全·网络安全
是店小二呀16 小时前
远程办公自由:rdesktop+cpolar让Windows桌面随身而行
windows
油丶酸萝卜别吃17 小时前
java8中常用的工具函数
windows
Bruce_Liuxiaowei18 小时前
Win7虚拟机加入域错误排查指南:解决无法启动服务问题
运维·网络·windows·安全·网络安全
雨中风华1 天前
Windows 平台 HOOK DWM 桌面管理程序,实现输出变形的桌面图像到显示器
windows·计算机外设