Skip to main content

Configura les notificacions d'accés Telegram

PortGuard Server pot enviar un missatge Telegram després que un paquet SPA vàlid afegeixi un regla del tallafoc. Les notificacions inclouen el nom d'amfitrió del servidor, la IP d'origen permesa, IP font del paquet, nom d'usuari SPA, accés sol·licitat, hora d'obertura, caducitat temps, i temps d'espera.

1. Creeu un bot Telegram​

  1. Obriu @BotFather a Telegram.
  2. Envieu /newbot i seguiu les instruccions.
  3. Copieu el Bot Token retornat per BotFather. Sembla que 123456789:AAExampleToken.

Tracteu el Bot Token com a contrasenya. No el comprometeu al control de fonts, enganxeu-lo en missatges de suport o exposar-lo en captures de pantalla.

2. Trobeu la destinació Chat ID​

Per a un xat privat, obriu el bot nou, seleccioneu Inici i envieu-li un missatge. Per a un grup, afegiu el bot al grup i envieu un missatge o ordre al bot pot rebre.

Al servidor, introduïu el Bot Token sense desar-lo a l'historial de shell:

read -rsp 'Telegram Bot Token: ' TG_TOKEN; echo

Llegeix les últimes actualitzacions del bot:

curl --config - <<EOF
silent
show-error
fail
url = "https://api.telegram.org/bot${TG_TOKEN}/getUpdates"
EOF
unset TG_TOKEN

Cerqueu message.chat.id a la resposta JSON. Els Chat ID privats normalment són nombres positius. Els grups Chat ID solen ser negatius i sovint els ID de supergrup comença amb -100.

Si result està buit, envieu un altre missatge al bot i torneu a executar la sol·licitud. Per a un canal, podeu utilitzar @channel_username després d'afegir el bot com a canal administrador amb permís per publicar missatges.

3. Configura PortGuard Server​

Inicieu la consola del tallafoc com a root:

sudo portguard-fwknopd --fw-console

Seleccioneu 5. Configure Telegram notifications i, a continuació, introduïu:

  • Fitxa de bot: el testimoni subministrat per BotFather.
  • Chat ID: l'identificador numèric privat/grup o @channel_username.
  • Interval mínim de notificació: 0 envia una notificació per a cada cop d'èxit. Un valor més gran suprimeix les notificacions addicionals durant tants segons.

Confirmeu la configuració i trieu y quan se us demani que envieu una prova notificació. La consola emmagatzema la configuració a /etc/fwknop/fwknopd.conf amb el mode 600 i torna a carregar el dimoni en execució.

4. Configura'l manualment​

La mateixa configuració es pot afegir directament a /etc/fwknop/fwknopd.conf:

PORTGUARD_TG_BOT_TOKEN       123456789:replace_with_bot_token;
PORTGUARD_TG_CHAT_ID          -1001234567890;
PORTGUARD_TG_NOTIFY_INTERVAL  0;

Tant el Bot Token com el Chat ID són necessaris. Protegiu la configuració i reinicieu el servei després d'un canvi manual:

sudo chmod 600 /etc/fwknop/fwknopd.conf
sudo portguard-fwknopd --exit-parse-config \
  -c /etc/fwknop/fwknopd.conf \
  -a /etc/fwknop/access.conf
sudo systemctl restart fwknopd

5. Verifica les notificacions​

Seguiu el registre del dimoni mentre envieu un paquet SPA vàlid des de PortGuard Client:

sudo journalctl -u fwknopd -f

Una notificació només es posa a la cua després d'acceptar el paquet SPA i un tallafoc la regla s'ha afegit correctament. Un cop repetit mentre segueix la mateixa regla active no pot crear una altra regla. Espereu que la regla anterior caduqui abans tornant a provar.

Si la prova de la consola falla o un cop acceptat no envia cap missatge, comproveu:

  • El servidor pot resoldre api.telegram.org i fer connexions sortints HTTPS.
  • S'ha iniciat el xat privat o el bot té permís per publicar-hi grup o canal de destinació.
  • El Chat ID pertany a la mateixa conversa de bot que s'utilitza amb getUpdates.
  • PORTGUARD_TG_NOTIFY_INTERVAL no suprimeix la notificació.
  • fwknopd s'ha tornat a carregar o es va reiniciar després d'un canvi de configuració manual.

6. Desactiva les notificacions​

Torneu a executar la consola, seleccioneu l'opció 5, introduïu disable com a Bot Token i confirmar. PortGuard elimina els tres paràmetres de Telegram i torna a carregar el dimoni.