From cc0fc68d7c0b45208146f7f7141f99e1fe403932 Mon Sep 17 00:00:00 2001 From: default Date: Tue, 12 Mar 2024 10:48:13 +0100 Subject: [PATCH] Updated documentation. --- doc/snac.5 | 4 +++- doc/snac.8 | 29 ++++++++++++++++++++++++++--- 2 files changed, 29 insertions(+), 4 deletions(-) diff --git a/doc/snac.5 b/doc/snac.5 index 6207d32..e0cc9c2 100644 --- a/doc/snac.5 +++ b/doc/snac.5 @@ -110,7 +110,9 @@ This file contains the list of public posts from all users in the server. This (optional) file contains a list of regular expressions, one per line, to be applied to the content of all incoming posts; if any of them match, the post is rejected. This brings the flexibility and destruction power of regular expressions -to your Fediverse experience. To be used wisely. +to your Fediverse experience. To be used wisely (see +.Xr snac 8 +for more information). .El .Pp Each user directory is a subdirectory of diff --git a/doc/snac.8 b/doc/snac.8 index 85106d3..e8a3562 100644 --- a/doc/snac.8 +++ b/doc/snac.8 @@ -230,9 +230,32 @@ for details. Further, every user can have a private CSS file in their that will be served instead of the server-wide one. It's not modifiable from the web interface to avoid users shooting themselves in the foot by destroying everything. -.Ss Old Data Purging -From version 2.06, there is no longer a need to add a special -cron job for purging old data, as this is managed internally. +.Ss SPAM Mitigation +There have been some SPAM attacks on the Fediverse and, as too many +instances and server implementations out there still allow automatic +account creation, it will only get worse. +.Nm +includes some (not very strong) tools for trying to survive the SPAM +flood that will eventually happen. +.Pp +The +.Ic min_account_age +field in the main configuration file allows setting a minimum age (in +seconds) to consider too recently created accounts suspicious of being +a potential source of SPAM. This is a naïve assumption, because spammers +can create accounts, let them dormant for a while and then start to use +them. Also, some ActivityPub implementations don't even bother to return +a creation date for their accounts, so this is not very useful. +.Pp +From version 2.50, post content can be filtered out by regular expressions. +These weapons of mass destruction can be written into the +.Ic filter_reject.txt +file in the server base directory, one per line; if this file exists, +all posts' content will be matched against these regexes, one by one, and +any match will make the post to be rejected. If you don't know about regular +expressions, don't use this option (or learn about them in some tutorial, +there are gazillions of them out there), as you and your users may start +missing posts. .Ss ActivityPub Support These are the following activities and objects that .Nm