Netbox Telegram là 1 tool được viết bằng ngôn ngữ python, với mục đích để check các thông tin lưu trên netbox. Với mục đích là sự tiện lợi, có thể thao tác ngay trên telegram để check các thông tin mà không cần truy cập vào netbox trên web.

Vì thông tin dữ liệu trên netbox là thông tin nhạy cảm nên theo mặc định chỉ có thể gửi về 1 ID duy nhất trên telegram.

Tool có các chức năng khi thao tác trên telegram như :

• List all prefix

• Check info single prefix

• List all ip address

• Check info single ip address

• List all device

• Check info single device

Cài đặt trên hệ điều hành CentOS 7

Thực hiện bằng user với quyền sudo hoặc người dùng root

Ta kiểm tra xem đã có version 3 của python được cài trong máy chưa.

python3 --version

Thực hiện cài đặt python3 và các gói cần thiết.

yum groupinstall "Development Tools" -y
yum install python3-devel -y
yum install python3 -y
yum install python3-pip -y
pip3 install virtualenv
yum install -y git wget

cd /opt
git clone https://github.com/nhanhoadocs/netbox-telegram.git
cd netbox-telegram

• Thêm token bot telegram

sed -i 's/TOKEN_TELE =/TOKEN_TELE = "918364925:AAGbl5y7463f8DFFx4RhkeB3_eRhUUNfHHw"/' /opt/netbox-telegram/config.py

Thay 918364925:AAGbl5y7463f8DFFx4RhkeB3_eRhUUNfHHw bằng token bot của bạn

• Thêm message id telegram

sed -i 's/CHAT_ID =/CHAT_ID = "633940211"/' /opt/netbox-telegram/config.py

Thay id 633940211 bằng chat của bạn hoặc của group muốn nhận tin nhắn

• Thêm vào url là đường dẫn đến trang netbox của bạn

sed -i 's/URL_NB =/URL_NB = "https:\/\/netbox.hungnv.com"/' /opt/netbox-telegram/config.py

Thay https://netbox.hungnv.com bằng url đẫn đến trang netbox của bạn. Với mỗi dấu / trên url, ta phải thêm 1 dấu \ vào trước nó.

• Thêm vào token user của netbox.

sed -i 's/TOKEN_NB =/TOKEN_NB = "933f6df395h3b23bdd103k582nf93l450d64b4d260"/' /opt/netbox-telegram/config.py

Thay token 933f6df395h3b23bdd103k582nf93l450d64b4d260 bằng token user trên netbox của bạn.

Nếu chưa biết cách để lấy token, bạn có thể làm theo các bước sau :

• Sau khi đăng nhập vào netbox, kích vào khu vực quản trị user :

• Kích vào tab user có hình bánh răng

• Ở mục token, kích vào Add token

• Lần lượt kích chọn user, ngày giờ hết hạn và lưu lại.

• Sau khi lưu ta sẽ có đoạn mã token. Hãy copy mã và điền vào file config.

Kiểm tra lại file config Sau khi ghi vào file, kiểm tra lại file config để chắc chắn đã điền đủ các thông tin

Sử dụng lệnh sau để kiểm tra :

egrep -v "^*#|^$" /opt/netbox-telegram/config.py

Kết quả các trường đã điền thông tin như sau là ok

cd /opt/netbox-telegram
virtualenv env -p python3.6
source env/bin/activate

pip install -r requirements.txt

vi /etc/systemd/system/netboxinfo.service

và ghi vào file nội dung như sau :

[Unit]
Description= Get data on netbox
After=network.target

[Service]
PermissionsStartOnly=True
User=root
Group=root
ExecStart=/opt/netbox-telegram/env/bin/python3 /opt/netbox-telegram/main.py --serve-in-foreground

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl start netboxinfo
systemctl status netboxinfo
systemctl enable netboxinfo

Để phòng các trường hợp dẫn đến service bị tắt, mình sẽ đặt 1 cron để check nếu service vì bất kỳ lý do gì bị tắt, sẽ tự động khởi động lại service đó.

cd /opt/netbox-telegram
chmod +x checkservice.sh

• Ghi vào dịch vụ muốn giám sát.

sed -i 's/SERVICES=/SERVICES="netboxinfo"/' /opt/netbox-telegram/checkservice.sh

• Sử dụng lệnh crontab -e và lưu đoạn cấu hình sau vào file crontab :

cron check 20 phút 1 lần. Nếu dịch vụ tắt sẽ tự khởi động lại.

*/20 * * * * /opt/netbox-telegram/checkservice.sh > /dev/null 2>&1

Sau khi khởi động, truy cập trực tiếp vào bot hoặc nhóm có bot là thành viên để sử dụng bot. (tùy vào message id bạn đặt ở đâu)

Nhập vào /start để bắt đầu sử dụng bot.

Sau khi nhập vào start, sẽ có những hướng dẫn để bạn có thể sử dụng thao tác với bot để lấy thông tin.

• Muốn xem tất cả các device hiện có, ta sử dụng /alldevice

• Muốn xem tất cả các prefix hiện có, ta sử dụng /allprefix

• Muốn xem tất cả các IP address hiện có, ta sử dụng /allipaddr

• Để xem thông tin của từng IP, ta sử dụng ipaddr kèm địa chỉ IP

• Để xem thông tin của từng thiết bị, ta sử dụng device kèm tên thiết bị

• Để xem thông tin của từng prefix, ta sử dụng prefix kèm địa chỉ prefix