modernleft-docs/Applications/fail2ban-manager/plugins/telegram.md

fail2ban-manager telegram

Usage:

$ fail2ban-manager telegram [OPTIONS] COMMAND [ARGS]...

Options:

• --install-completion: Install completion for the current shell.
• --show-completion: Show completion for the current shell, to copy it or customize the installation.
• --help: Show this message and exit.

Commands:

• ls: List all jails with Telegram notifications.
• add-to-jail: Add the Telegram provider to a jail.
• remove-from-jail: Remove the Telegram provider from a jail.
• edit-message: Set the message for a specific action.
• enable-message: Enable a message for a specific action in...
• send: Send a messague to a Telegram bot.

fail2ban-manager telegram ls

List all jails with Telegram notifications.

Usage:

$ fail2ban-manager telegram ls [OPTIONS]

Options:

• --help: Show this message and exit.

fail2ban-manager telegram add-to-jail

Add the Telegram provider to a jail.

Usage:

$ fail2ban-manager telegram add-to-jail [OPTIONS] JAILNAME TOKEN CHATID

Arguments:

• JAILNAME: [required]
• TOKEN: [env var: TELEGRAM_API_TOKEN; required]
• CHATID: [env var: TELEGRAM_CHAT_ID; required]

Options:

• --help: Show this message and exit.

fail2ban-manager telegram remove-from-jail

Remove the Telegram provider from a jail.

Usage:

$ fail2ban-manager telegram remove-from-jail [OPTIONS] JAILNAME

Arguments:

• JAILNAME: [required]

Options:

• --help: Show this message and exit.

fail2ban-manager telegram edit-message

Set the message for a specific action.

Usage:

$ fail2ban-manager telegram edit-message [OPTIONS] JAILNAME ACTION MESSAGE

Arguments:

• JAILNAME: [required]
• ACTION: The action to send a message for. [required]
• MESSAGE: The action to send. [required]

Options:

• --help: Show this message and exit.

fail2ban-manager telegram enable-message

Enable a message for a specific action in a jail.

Usage:

$ fail2ban-manager telegram enable-message [OPTIONS] JAILNAME

Arguments:

• JAILNAME: [required]

Options:

• --start: Enable message for start action.
• --stop: Enable message for stop action.
• --check: Enable message for check action.
• --ban: Enable message for ban action.
• --unban: Enable message for unban action.
• --help: Show this message and exit.

fail2ban-manager telegram send

Send a messague to a Telegram bot.

Usage:

$ fail2ban-manager telegram send [OPTIONS] ACTION JAILNAME [TOKEN] [CHATID]

Arguments:

• ACTION: The action to send a message for. [required]
• JAILNAME: Name of the jail sending the message [required]
• [TOKEN]: [env var: TELEGRAM_API_TOKEN]
• [CHATID]: [env var: TELEGRAM_CHAT_ID]

Options:

• --ip TEXT: IP address of the banned/unbanned IP
• --failures INTEGER: Number of failures before ban [default: 0]
• --help: Show this message and exit.