globster-usercheck
Tento skript je určen ke kontrole uživatelů při připojení. Je vhodný k identifikací známých spammerů, upozorňování uživatelů na nedostatky, ale také oznamování příchodu pingerů či významných uživatelů hubu. Hledané hodnoty jsou regulární výrazy a vždy je třeba shody u všech polí v jednom profilu (obdoba kontroly uživatelů obsažená v OP klientech).
Závislosti
- Globster (samozřejmě)
- Perl 5 (s instalovaným XML Simple modulem)
- D-Bus
Instalace a spuštění
Skript stáhněte a uložte kamkoli na váš systém. Vytvořte konfigurační XML soubor globster-responder.xml a uložte jej do stejné složky se skriptem. K vytvoření souboru můžete využít příklad na konci tohoto dokumentu.
Skript spustíte následujícími příkazy:
cd /cesta/ke/skriptu
./globster-usercheck.pl [<konfigurace>]
Vždy zadávejte celou cestu ke konfiguraci. Pokud není zadán konfigurační soubor, skript vyhledá globster-usercheck.xml v adresáři, ve kterém se nachází skript nebo v /etc/globster. V předchozím kroku jsme změnili adresář a nacházíme se v adresáři se skriptem, proto můžeme tento argument vynechat.
Pro spuštění na pozadí:
./globster-usercheck.pl &
XML konfigurace
Následující tabulka popisuje tagy použitelné v konfiguračním XML souboru. Většina z nich je nezbytná pro chod skriptu.
| Tag | Popis | Nadřazený tag |
|---|---|---|
| config | Počáteční tag konfigurace. Může být nahrazen jiným tagem, kromě následujících. | - |
| hub | Nový hub objekt. | config |
| userinfo | Profil hledaných hodnot polí. | hub |
| inffield | Hledaná hodnota pole (regulární výraz). | userinfo |
| actiontosend | ID akcí oddělené čárkou, které se mají vykonat při nalezené shodě. | userinfo |
| action | Akce, která je vykonána v případě shody. Příkaz nebo zpráva musí být konstruovány tak, aby mohly být odeslány na hlavní chat hubu nebo soukromou zprávu, nikoli jako raw příkaz pro hub. K vyplnění nicku uživatele lze použít proměnnou %[userNI]. | config |
Následující tabulka popisuje atributy použitelné v konfiguračním XML souboru. Většina z nich je nezbytná pro chod skriptu.
| Atribut | Popis | Tag |
|---|---|---|
| dbusaddr | DBUS_SESSION_BUS_ADDRESS použitý pro spuštění klienta Globster. Ukládá tuto adresu k identifikaci session Globsteru při restartech skriptu. Tento atribut je volitelný. | config |
| hubid | Hub id z Globsteru. | hub |
| field | Název pole, které má být kontrolováno. Hodnoty: nick, description, client, mail, slots, sharedfiles, sharesize, conn, ip4, ip6, as. CID, počty otevřených hubů a flags uživatele nejsou plně zatím plně podporovány. | inffield |
| actionid | ID akce, používá se v tagu actiontosend. | action |
| destination | Určuje kam se akce odešle. Hodnoty: chat, user. | action |
| me | Odeslání akce ve tvaru systémové zprávy. Hodnoty: 0 vypnuto, 1 zapnuto | action |
Příklad konfigurace
Vzorové nastavení naleznete zde.