1 /* +------------------------------------+
2 * | Inspire Internet Relay Chat Daemon |
3 * +------------------------------------+
5 * InspIRCd: (C) 2002-2009 InspIRCd Development Team
6 * See: http://wiki.inspircd.org/Credits
8 * This program is free but copyrighted software; see
9 * the file COPYING for details.
11 * ---------------------------------------------------
18 /* $ModDesc: Text (spam) filtering */
20 static std::string RegexEngine = "";
21 static Module* rxengine = NULL;
31 class FilterResult : public classbase
41 bool flag_part_message;
42 bool flag_quit_message;
46 FilterResult(const std::string free, const std::string &rea, const std::string &act, long gt, const std::string &fla) :
47 freeform(free), reason(rea), action(act), gline_time(gt), flags(fla)
52 int FillFlags(const std::string &fl)
55 flag_no_opers = flag_part_message = flag_quit_message = flag_privmsg = flag_notice = false;
58 for (std::string::const_iterator n = flags.begin(); n != flags.end(); ++n, ++x)
66 flag_part_message = true;
69 flag_quit_message = true;
78 flag_no_opers = flag_part_message = flag_quit_message =
79 flag_privmsg = flag_notice = true;
93 virtual ~FilterResult()
100 class FilterBase : public Module
102 CommandFilter* filtcommand;
105 std::vector<std::string> exemptfromfilter; // List of channel names excluded from filtering.
107 FilterBase(InspIRCd* Me, const std::string &source);
108 virtual ~FilterBase();
109 virtual int OnUserPreMessage(User* user,void* dest,int target_type, std::string &text, char status, CUList &exempt_list);
110 virtual FilterResult* FilterMatch(User* user, const std::string &text, int flags) = 0;
111 virtual bool DeleteFilter(const std::string &freeform) = 0;
112 virtual void SyncFilters(Module* proto, void* opaque) = 0;
113 virtual void SendFilter(Module* proto, void* opaque, FilterResult* iter);
114 virtual std::pair<bool, std::string> AddFilter(const std::string &freeform, const std::string &type, const std::string &reason, long duration, const std::string &flags) = 0;
115 virtual int OnUserPreNotice(User* user,void* dest,int target_type, std::string &text, char status, CUList &exempt_list);
116 virtual void OnRehash(User* user, const std::string ¶meter);
117 virtual Version GetVersion();
118 std::string EncodeFilter(FilterResult* filter);
119 FilterResult DecodeFilter(const std::string &data);
120 virtual void OnSyncOtherMetaData(Module* proto, void* opaque, bool displayable = false);
121 virtual void OnDecodeMetaData(int target_type, void* target, const std::string &extname, const std::string &extdata);
122 virtual int OnStats(char symbol, User* user, string_list &results) = 0;
123 virtual int OnPreCommand(std::string &command, std::vector<std::string> ¶meters, User *user, bool validated, const std::string &original_line);
124 bool AppliesToMe(User* user, FilterResult* filter, int flags);
125 void OnLoadModule(Module* mod, const std::string& name);
126 virtual void ReadFilters(ConfigReader &MyConf) = 0;
129 class CommandFilter : public Command
133 CommandFilter(FilterBase* f, InspIRCd* Me, const std::string &ssource) : Command(Me, "FILTER", "o", 1, 5), Base(f)
135 this->source = ssource;
136 this->syntax = "<filter-definition> <action> <flags> [<gline-duration>] :<reason>";
139 CmdResult Handle(const std::vector<std::string> ¶meters, User *user)
141 if (parameters.size() == 1)
143 /* Deleting a filter */
144 if (Base->DeleteFilter(parameters[0]))
146 user->WriteServ("NOTICE %s :*** Removed filter '%s'", user->nick.c_str(), parameters[0].c_str());
147 ServerInstance->SNO->WriteToSnoMask('A', std::string("FILTER: ")+user->nick+" removed filter '"+parameters[0]+"'");
152 user->WriteServ("NOTICE %s :*** Filter '%s' not found in list, try /stats s.", user->nick.c_str(), parameters[0].c_str());
158 /* Adding a filter */
159 if (parameters.size() >= 4)
161 std::string freeform = parameters[0];
162 std::string type = parameters[1];
163 std::string flags = parameters[2];
168 if ((type != "gline") && (type != "none") && (type != "block") && (type != "kill") && (type != "silent"))
170 user->WriteServ("NOTICE %s :*** Invalid filter type '%s'. Supported types are 'gline', 'none', 'block', 'silent' and 'kill'.", user->nick.c_str(), type.c_str());
176 if (parameters.size() >= 5)
178 duration = ServerInstance->Duration(parameters[3]);
179 reason = parameters[4];
183 this->TooFewParams(user, ": When setting a gline type filter, a gline duration must be specified as the third parameter.");
189 reason = parameters[3];
191 std::pair<bool, std::string> result = Base->AddFilter(freeform, type, reason, duration, flags);
194 user->WriteServ("NOTICE %s :*** Added filter '%s', type '%s'%s%s, flags '%s', reason: '%s'", user->nick.c_str(), freeform.c_str(),
195 type.c_str(), (duration ? ", duration " : ""), (duration ? parameters[3].c_str() : ""),
196 flags.c_str(), reason.c_str());
198 ServerInstance->SNO->WriteToSnoMask('A', std::string("FILTER: ")+user->nick+" added filter '"+freeform+"', type '"+type+"', "+(duration ? "duration "+parameters[3]+", " : "")+"flags '"+flags+"', reason: "+reason);
204 user->WriteServ("NOTICE %s :*** Filter '%s' could not be added: %s", user->nick.c_str(), freeform.c_str(), result.second.c_str());
210 this->TooFewParams(user, ".");
217 void TooFewParams(User* user, const std::string &extra_text)
219 user->WriteServ("NOTICE %s :*** Not enough parameters%s", user->nick.c_str(), extra_text.c_str());
223 bool FilterBase::AppliesToMe(User* user, FilterResult* filter, int iflags)
225 if ((filter->flag_no_opers) && IS_OPER(user))
227 if ((iflags & FLAG_PRIVMSG) && (!filter->flag_privmsg))
229 if ((iflags & FLAG_NOTICE) && (!filter->flag_notice))
231 if ((iflags & FLAG_QUIT) && (!filter->flag_quit_message))
233 if ((iflags & FLAG_PART) && (!filter->flag_part_message))
238 FilterBase::FilterBase(InspIRCd* Me, const std::string &source) : Module(Me)
240 Me->Modules->UseInterface("RegularExpression");
241 filtcommand = new CommandFilter(this, Me, source);
242 ServerInstance->AddCommand(filtcommand);
243 Implementation eventlist[] = { I_OnPreCommand, I_OnStats, I_OnSyncOtherMetaData, I_OnDecodeMetaData, I_OnUserPreMessage, I_OnUserPreNotice, I_OnRehash, I_OnLoadModule };
244 ServerInstance->Modules->Attach(eventlist, this, 8);
247 FilterBase::~FilterBase()
249 ServerInstance->Modules->DoneWithInterface("RegularExpression");
252 int FilterBase::OnUserPreMessage(User* user,void* dest,int target_type, std::string &text, char status, CUList &exempt_list)
254 flags = FLAG_PRIVMSG;
255 return OnUserPreNotice(user,dest,target_type,text,status,exempt_list);
258 int FilterBase::OnUserPreNotice(User* user,void* dest,int target_type, std::string &text, char status, CUList &exempt_list)
263 /* Leave ulines alone */
264 if ((ServerInstance->ULine(user->server)) || (!IS_LOCAL(user)))
267 FilterResult* f = this->FilterMatch(user, text, flags);
270 std::string target = "";
271 if (target_type == TYPE_USER)
273 User* t = (User*)dest;
274 target = std::string(t->nick);
276 else if (target_type == TYPE_CHANNEL)
278 Channel* t = (Channel*)dest;
279 target = std::string(t->name);
280 std::vector<std::string>::iterator i = find(exemptfromfilter.begin(), exemptfromfilter.end(), target);
281 if (i != exemptfromfilter.end()) return 0;
283 if (f->action == "block")
285 ServerInstance->SNO->WriteToSnoMask('A', std::string("FILTER: ")+user->nick+" had their message filtered, target was "+target+": "+f->reason);
286 if (target_type == TYPE_CHANNEL)
287 user->WriteNumeric(404, "%s %s :Message to channel blocked and opers notified (%s)",user->nick.c_str(), target.c_str(), f->reason.c_str());
289 user->WriteServ("NOTICE "+std::string(user->nick)+" :Your message to "+target+" was blocked and opers notified: "+f->reason);
291 if (f->action == "silent")
293 if (target_type == TYPE_CHANNEL)
294 user->WriteNumeric(404, "%s %s :Message to channel blocked (%s)",user->nick.c_str(), target.c_str(), f->reason.c_str());
296 user->WriteServ("NOTICE "+std::string(user->nick)+" :Your message to "+target+" was blocked: "+f->reason);
298 if (f->action == "kill")
300 ServerInstance->Users->QuitUser(user, "Filtered: " + f->reason);
302 if (f->action == "gline")
304 GLine* gl = new GLine(ServerInstance, ServerInstance->Time(), f->gline_time, ServerInstance->Config->ServerName, f->reason.c_str(), "*", user->GetIPString());
305 if (ServerInstance->XLines->AddLine(gl,NULL))
307 ServerInstance->XLines->ApplyLines();
313 ServerInstance->Logs->Log("FILTER",DEFAULT,"FILTER: "+ user->nick + " had their message filtered, target was " + target + ": " + f->reason + " Action: " + f->action);
319 int FilterBase::OnPreCommand(std::string &command, std::vector<std::string> ¶meters, User *user, bool validated, const std::string &original_line)
322 if (validated && IS_LOCAL(user))
324 std::string checkline;
325 int replacepoint = 0;
326 bool parting = false;
328 if (command == "QUIT")
330 /* QUIT with no reason: nothing to do */
331 if (parameters.size() < 1)
334 checkline = parameters[0];
339 else if (command == "PART")
341 /* PART with no reason: nothing to do */
342 if (parameters.size() < 2)
345 std::vector<std::string>::iterator i = find(exemptfromfilter.begin(), exemptfromfilter.end(), parameters[0]);
346 if (i != exemptfromfilter.end()) return 0;
347 checkline = parameters[1];
353 /* We're only messing with PART and QUIT */
356 FilterResult* f = NULL;
359 f = this->FilterMatch(user, checkline, flags);
362 /* PART or QUIT reason doesnt match a filter */
365 /* We cant block a part or quit, so instead we change the reason to 'Reason filtered' */
366 Command* c = ServerInstance->Parser->GetHandler(command);
369 std::vector<std::string> params;
370 for (int item = 0; item < (int)parameters.size(); item++)
371 params.push_back(parameters[item]);
372 params[replacepoint] = "Reason filtered";
374 /* We're blocking, OR theyre quitting and its a KILL action
375 * (we cant kill someone whos already quitting, so filter them anyway)
377 if ((f->action == "block") || (((!parting) && (f->action == "kill"))) || (f->action == "silent"))
379 c->Handle(params, user);
384 /* Are they parting, if so, kill is applicable */
385 if ((parting) && (f->action == "kill"))
387 user->WriteServ("NOTICE %s :*** Your PART message was filtered: %s", user->nick.c_str(), f->reason.c_str());
388 ServerInstance->Users->QuitUser(user, "Filtered: " + f->reason);
390 if (f->action == "gline")
392 /* Note: We gline *@IP so that if their host doesnt resolve the gline still applies. */
393 GLine* gl = new GLine(ServerInstance, ServerInstance->Time(), f->gline_time, ServerInstance->Config->ServerName, f->reason.c_str(), "*", user->GetIPString());
394 if (ServerInstance->XLines->AddLine(gl,NULL))
396 ServerInstance->XLines->ApplyLines();
409 void FilterBase::OnRehash(User* user, const std::string ¶meter)
411 ConfigReader* MyConf = new ConfigReader(ServerInstance);
412 std::vector<std::string>().swap(exemptfromfilter);
413 for (int index = 0; index < MyConf->Enumerate("exemptfromfilter"); ++index)
415 std::string chan = MyConf->ReadValue("exemptfromfilter", "channel", index);
417 exemptfromfilter.push_back(chan);
420 std::string newrxengine = MyConf->ReadValue("filteropts", "engine", 0);
421 if (!RegexEngine.empty())
423 if (RegexEngine == newrxengine)
426 ServerInstance->SNO->WriteToSnoMask('A', "Dumping all filters due to regex engine change (was '%s', now '%s')", RegexEngine.c_str(), newrxengine.c_str());
427 //ServerInstance->XLines->DelAll("R");
431 RegexEngine = newrxengine;
432 modulelist* ml = ServerInstance->Modules->FindInterface("RegularExpression");
435 for (modulelist::iterator i = ml->begin(); i != ml->end(); ++i)
437 if (RegexNameRequest(this, *i).Send() == newrxengine)
439 ServerInstance->SNO->WriteToSnoMask('A', "Filter now using engine '%s'", RegexEngine.c_str());
446 ServerInstance->SNO->WriteToSnoMask('A', "WARNING: Regex engine '%s' is not loaded - Filter functionality disabled until this is corrected.", RegexEngine.c_str());
452 void FilterBase::OnLoadModule(Module* mod, const std::string& name)
454 if (ServerInstance->Modules->ModuleHasInterface(mod, "RegularExpression"))
456 std::string rxname = RegexNameRequest(this, mod).Send();
457 if (rxname == RegexEngine)
460 /* Force a rehash to make sure that any filters that couldnt be applied from the conf
461 * on startup or on load are applied right now.
463 ConfigReader Config(ServerInstance);
464 ServerInstance->SNO->WriteToSnoMask('A', "Found and activated regex module '%s' for m_filter.so.", RegexEngine.c_str());
471 Version FilterBase::GetVersion()
473 return Version("$Id$", VF_VENDOR | VF_COMMON, API_VERSION);
477 std::string FilterBase::EncodeFilter(FilterResult* filter)
479 std::ostringstream stream;
480 std::string x = filter->freeform;
482 /* Hax to allow spaces in the freeform without changing the design of the irc protocol */
483 for (std::string::iterator n = x.begin(); n != x.end(); n++)
487 stream << x << " " << filter->action << " " << (filter->flags.empty() ? "-" : filter->flags) << " " << filter->gline_time << " :" << filter->reason;
491 FilterResult FilterBase::DecodeFilter(const std::string &data)
494 irc::tokenstream tokens(data);
495 tokens.GetToken(res.freeform);
496 tokens.GetToken(res.action);
497 tokens.GetToken(res.flags);
498 if (res.flags == "-")
500 res.FillFlags(res.flags);
501 tokens.GetToken(res.gline_time);
502 tokens.GetToken(res.reason);
504 /* Hax to allow spaces in the freeform without changing the design of the irc protocol */
505 for (std::string::iterator n = res.freeform.begin(); n != res.freeform.end(); n++)
512 void FilterBase::OnSyncOtherMetaData(Module* proto, void* opaque, bool displayable)
514 this->SyncFilters(proto, opaque);
517 void FilterBase::SendFilter(Module* proto, void* opaque, FilterResult* iter)
519 proto->ProtoSendMetaData(opaque, TYPE_OTHER, NULL, "filter", EncodeFilter(iter));
522 void FilterBase::OnDecodeMetaData(int target_type, void* target, const std::string &extname, const std::string &extdata)
524 if ((target_type == TYPE_OTHER) && (extname == "filter"))
526 FilterResult data = DecodeFilter(extdata);
527 this->AddFilter(data.freeform, data.action, data.reason, data.gline_time, data.flags);
531 class ImplFilter : public FilterResult
536 ImplFilter(Module* mymodule, const std::string &rea, const std::string &act, long glinetime, const std::string &pat, const std::string &flgs)
537 : FilterResult(pat, rea, act, glinetime, flgs)
540 throw ModuleException("Regex module implementing '"+RegexEngine+"' is not loaded!");
542 regex = RegexFactoryRequest(mymodule, rxengine, pat).Create();
550 class ModuleFilter : public FilterBase
552 std::vector<ImplFilter> filters;
558 ModuleFilter(InspIRCd* Me)
559 : FilterBase(Me, "m_filter.so")
564 virtual ~ModuleFilter()
568 virtual FilterResult* FilterMatch(User* user, const std::string &text, int flgs)
570 for (std::vector<ImplFilter>::iterator index = filters.begin(); index != filters.end(); index++)
572 /* Skip ones that dont apply to us */
573 if (!FilterBase::AppliesToMe(user, dynamic_cast<FilterResult*>(&(*index)), flgs))
576 //ServerInstance->Logs->Log("m_filter", DEBUG, "Match '%s' against '%s'", text.c_str(), index->freeform.c_str());
577 if (index->regex->Matches(text))
579 //ServerInstance->Logs->Log("m_filter", DEBUG, "MATCH");
581 if (index != filters.begin())
583 /* Move to head of list for efficiency */
584 filters.erase(index);
585 filters.insert(filters.begin(), fr);
589 //ServerInstance->Logs->Log("m_filter", DEBUG, "NO MATCH");
594 virtual bool DeleteFilter(const std::string &freeform)
596 for (std::vector<ImplFilter>::iterator i = filters.begin(); i != filters.end(); i++)
598 if (i->freeform == freeform)
608 virtual void SyncFilters(Module* proto, void* opaque)
610 for (std::vector<ImplFilter>::iterator i = filters.begin(); i != filters.end(); i++)
612 this->SendFilter(proto, opaque, &(*i));
616 virtual std::pair<bool, std::string> AddFilter(const std::string &freeform, const std::string &type, const std::string &reason, long duration, const std::string &flgs)
618 for (std::vector<ImplFilter>::iterator i = filters.begin(); i != filters.end(); i++)
620 if (i->freeform == freeform)
622 return std::make_pair(false, "Filter already exists");
628 filters.push_back(ImplFilter(this, reason, type, duration, freeform, flgs));
630 catch (ModuleException &e)
632 ServerInstance->Logs->Log("m_filter", DEFAULT, "Error in regular expression '%s': %s", freeform.c_str(), e.GetReason());
633 return std::make_pair(false, e.GetReason());
635 return std::make_pair(true, "");
638 virtual void OnRehash(User* user, const std::string ¶meter)
640 ConfigReader MyConf(ServerInstance);
641 FilterBase::OnRehash(user, parameter);
645 void ReadFilters(ConfigReader &MyConf)
647 for (int index = 0; index < MyConf.Enumerate("keyword"); index++)
649 this->DeleteFilter(MyConf.ReadValue("keyword", "pattern", index));
651 std::string pattern = MyConf.ReadValue("keyword", "pattern", index);
652 std::string reason = MyConf.ReadValue("keyword", "reason", index);
653 std::string action = MyConf.ReadValue("keyword", "action", index);
654 std::string flgs = MyConf.ReadValue("keyword", "flags", index);
655 long gline_time = ServerInstance->Duration(MyConf.ReadValue("keyword", "duration", index));
663 filters.push_back(ImplFilter(this, reason, action, gline_time, pattern, flgs));
664 ServerInstance->Logs->Log("m_filter", DEFAULT, "Regular expression %s loaded.", pattern.c_str());
666 catch (ModuleException &e)
668 ServerInstance->Logs->Log("m_filter", DEFAULT, "Error in regular expression '%s': %s", pattern.c_str(), e.GetReason());
673 virtual int OnStats(char symbol, User* user, string_list &results)
677 std::string sn = ServerInstance->Config->ServerName;
678 for (std::vector<ImplFilter>::iterator i = filters.begin(); i != filters.end(); i++)
680 results.push_back(sn+" 223 "+user->nick+" :"+RegexEngine+":"+i->freeform+" "+i->flags+" "+i->action+" "+ConvToStr(i->gline_time)+" :"+i->reason);
682 for (std::vector<std::string>::iterator i = exemptfromfilter.begin(); i != exemptfromfilter.end(); ++i)
684 results.push_back(sn+" 223 "+user->nick+" :EXEMPT "+(*i));
691 MODULE_INIT(ModuleFilter)