4 * Description: Blocking bots based on detecting bots/crawlers/spiders via the user agent and http_from header.
6 * Author: Philipp Holzer <admin@philipp.info>
7 * Author: Michael Vogel <https://pirati.ca/profile/heluecht>
11 use Friendica\Core\Hook;
13 use Jaybizzle\CrawlerDetect\CrawlerDetect;
14 use Friendica\Core\Logger;
15 use Friendica\Core\Renderer;
16 use Friendica\Network\HTTPException\ForbiddenException;
18 require_once __DIR__ . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php';
20 function blockbot_install()
22 Hook::register('init_1', __FILE__, 'blockbot_init_1');
25 function blockbot_addon_admin(string &$o)
27 $t = Renderer::getMarkupTemplate('admin.tpl', 'addon/blockbot/');
29 $o = Renderer::replaceMacros($t, [
30 '$submit' => DI::l10n()->t('Save Settings'),
31 '$good_crawlers' => ['good_crawlers', DI::l10n()->t('Allow "good" crawlers'), DI::config()->get('blockbot', 'good_crawlers'), DI::l10n()->t("Don't block fediverse crawlers, relay servers and other bots with good purposes.")],
32 '$block_gab' => ['block_gab', DI::l10n()->t('Block GabSocial'), DI::config()->get('blockbot', 'block_gab'), DI::l10n()->t('Block the software GabSocial. This will block every access for that software. You can block dedicated gab instances in the blocklist settings in the admin section.')],
33 '$training' => ['training', DI::l10n()->t('Training mode'), DI::config()->get('blockbot', 'training'), DI::l10n()->t("Activates the training mode. This is only meant for developing purposes. Don't activate this on a production machine. This can cut communication with some systems.")],
37 function blockbot_addon_admin_post()
39 DI::config()->set('blockbot', 'good_crawlers', $_POST['good_crawlers'] ?? false);
40 DI::config()->set('blockbot', 'block_gab', $_POST['block_gab'] ?? false);
41 DI::config()->set('blockbot', 'training', $_POST['training'] ?? false);
44 function blockbot_init_1()
46 if (empty($_SERVER['HTTP_USER_AGENT'])) {
50 $logdata = ['agent' => $_SERVER['HTTP_USER_AGENT'], 'uri' => $_SERVER['REQUEST_URI']];
52 // List of "good" crawlers
54 'fediverse.space crawler', 'fediverse.network crawler', 'Active_Pods_CheckBot_3.0',
55 'Social-Relay/', 'Test Certificate Info', 'Uptimebot/', 'GNUSocialBot', 'UptimeRobot/',
56 'PTST/', 'Zabbix', 'Poduptime/'
59 // List of known crawlers.
61 'SemrushBot', 's~feedly-nikon3', 'Qwantify/Bleriot/', 'ltx71', 'Sogou web spider/',
62 'Diffbot/', 'Twitterbot/', 'YisouSpider', 'evc-batch/', 'LivelapBot/', 'TrendsmapResolver/',
63 'PaperLiBot/', 'Nuzzel', 'um-LN/', 'Google Favicon', 'Datanyze', 'BLEXBot/', '360Spider',
64 'adscanner/', 'HeadlessChrome', 'wpif', 'startmebot/', 'Googlebot/', 'Applebot/',
65 'facebookexternalhit/', 'GoogleImageProxy', 'bingbot/', 'heritrix/', 'ldspider',
66 'AwarioRssBot/', 'TweetmemeBot/', 'dcrawl/', 'PhantomJS/', 'Googlebot-Image/',
67 'CrowdTanglebot/', 'Mediapartners-Google', 'Baiduspider/', 'datagnionbot',
68 'MegaIndex.ru/', 'SMUrlExpander', 'Hatena-Favicon/', 'Wappalyzer', 'FlipboardProxy/',
69 'NetcraftSurveyAgent/', 'Dataprovider.com', 'SMTBot/', 'Nimbostratus-Bot/',
70 'DuckDuckGo-Favicons-Bot/', 'IndieWebCards/', 'proximic', 'netEstate NE Crawler',
71 'AhrefsBot/', 'YandexBot/', 'Exabot/', 'Mediumbot-MetaTagFetcher/', 'WhatsApp/',
72 'TelegramBot', 'SurdotlyBot/', 'BingPreview/', 'SabsimBot/', 'CCBot/', 'WbSrch/',
73 'DuckDuckBot-Https/', 'HTTP Banner Detection', 'YandexImages/', 'archive.org_bot',
74 'ArchiveTeam ArchiveBot/', 'yacybot', 'https://developers.google.com/+/web/snippet/',
75 'Scrapy/', 'github-camo', 'MJ12bot/', 'DotBot/', 'Pinterestbot/', 'Jooblebot/',
76 'Cliqzbot/', 'YaK/', 'Mediatoolkitbot', 'Snacktory', 'FunWebProducts', 'oBot/',
77 '7Siters/', 'KOCMOHABT', 'Google-SearchByImage', 'FemtosearchBot/',
78 'HubSpot Crawler', 'DomainStatsBot/', 'Re-re Studio', 'AwarioSmartBot/',
79 'SummalyBot/', 'DNSResearchBot/', 'PetalBot;', 'Nmap Scripting Engine;',
80 'Google-Apps-Script; beanserver;', 'woorankreview/', 'Seekport Crawler;', 'AHC/',
81 'SkypeUriPreview Preview/', 'Semanticbot/', 'Embed PHP library', 'XoviOnpageCrawler;',
82 'GetHPinfo.com-Bot/', 'BoardReader Favicon Fetcher', 'Google-Adwords-Instant', 'newspaper/',
83 'YurichevBot/', 'Crawling at Home Project', 'InfoTigerBot/'
86 if (!DI::config()->get('blockbot', 'good_crawlers')) {
87 $agents = array_merge($agents, $good_agents);
89 foreach ($good_agents as $good_agent) {
90 if (stristr($_SERVER['HTTP_USER_AGENT'], $good_agent)) {
96 if (DI::config()->get('blockbot', 'block_gab')) {
97 $agents[] = 'GabSocial/';
100 foreach ($agents as $agent) {
101 if (stristr($_SERVER['HTTP_USER_AGENT'], $agent)) {
102 throw new ForbiddenException('Bots are not allowed');
106 // This switch here is only meant for developers who want to add more bots to the list above, it is not safe for production.
107 if (!DI::config()->get('blockbot', 'training')) {
111 $crawlerDetect = new CrawlerDetect();
113 if (!$crawlerDetect->isCrawler()) {
114 logger::debug('Good user agent detected', $logdata);
118 // List of false positives' strings of known "good" agents.
120 'curl', 'zgrab', 'Go-http-client', 'curb', 'github.com', 'reqwest', 'Feedly/',
121 'Python-urllib/', 'Liferea/', 'aiohttp/', 'WordPress.com Reader', 'hackney/',
122 'Faraday v', 'okhttp', 'UniversalFeedParser', 'PixelFedBot', 'python-requests',
123 'WordPress/', 'http.rb/', 'Apache-HttpClient/', 'WordPress.com;', 'Pleroma',
124 'Dispatch/', 'Ruby', 'Java/', 'libwww-perl/', 'Mastodon/', 'FeedlyApp/',
125 'lua-resty-http/', 'Tiny Tiny RSS/', 'Wget/', 'PostmanRuntime/',
126 'W3C_Validator/', 'NetNewsWire', 'FeedValidator/', 'theoldreader.com', 'axios/',
127 'Paw/', 'PeerTube/', 'fedi.inex.dev', 'FediDB/', 'index.community crawler',
128 'Slackbot-LinkExpanding'
131 if (DI::config()->get('blockbot', 'good_crawlers')) {
132 $agents = array_merge($agents, $good_agents);
135 foreach ($agents as $agent) {
136 if (stristr($_SERVER['HTTP_USER_AGENT'], $agent)) {
137 logger::info('False positive', $logdata);
142 logger::notice('Blocked bot', $logdata);
143 throw new ForbiddenException('Bots are not allowed');