Blocking

cattle_grid supports domain based blocking. The domain blocks are stored in the domain_blocks variable of cattle_grid.toml. One can add a list of domains to this list by using the following tool.

Note

cattle_grid answers with 403 Forbidden in case of the request being blocked due to the blocklist, and 401 Unauthorized when authorization is lacking.

Blocklist management tool

python -m cattle_grid.block

Usage:

python -m cattle_grid.block [OPTIONS]

Options:

  --source TEXT  URL or file to import blocklist from
  --clean        Sets the blocklist to test empty list
  --add TEXT     Adds domain to blocklist
  --remove TEXT  Removes domain from blocklist
  --help         Show this message and exit.

If no argument is passed the FediNuke.txt block list from Seirdy will be imported.

File format

The format of a blocklist file is a list of new line separated domains, i.e.

blocklist.txt

one.example
two.example
three.example
four.example