funkwhale/docs/moderator/listing.rst

95 wiersze
3.2 KiB
ReStructuredText

Allow-Listing
=============
The Allow-Listing feature grants pod moderators
and administrators greater control over federation
by allowing you to create a pod-wide allow-list.
When allow-listing is enabled, your pod's users will only
be able to interact with pods included in the allow-list.
Any messages, activity, uploads, or modifications to
libraries and playlists will only be shared with pods
on the allow-list. Pods which are not included in the
allow-list will not have access to your pod's content
or messages and will not be able to send anything to
your pod.
Enabling Allow-Listing
----------------------
.. warning::
If your pod is already federating proceed with caution.
Enabling the Allow-Listing feature will initially block
all activity from external domains as the list will be
empty
To enable allow-listing:
- Navigate to the "Settings" menu
- Go to the "Moderation" section
- Toggle the "Enable allow-listing" radio button
- Click "Save" to commit the change
Once enabled, you can start adding domains to your
allow-list.
Adding/Removing Domains
-----------------------
Add a New Domain
^^^^^^^^^^^^^^^^
- Navigate to the "Moderation" menu. Any domains currently
in the allow-list will be visible here with a green check
mark next to their name. Other pods with which you have previously
interacted will also be visible here
- Type the domain name of the pod you wish to allow into
the "Add a Domain" input box in the top-right of the screen
- Tick the "Add to allow-list" tickbox
- Click "Add" to add the domain
Add a Known Domain
^^^^^^^^^^^^^^^^^^
- Navigate to the "Moderation" menu. Any domains currently
in the allow-list will be visible here with a green check
mark next to their name. Other pods with which you have previously
interacted will also be visible here
- Click on the tickbox next to the domain(s) you wish to add to
the allow-list
- Select "Add to allow-list" from the drop-down menu titled "Actions"
and click "Go" to add the domain(s)
Remove a Domain
^^^^^^^^^^^^^^^
To remove a domain from the allow-list:
- Navigate to the "Moderation" menu. Any domains currently
in the allow-list will be visible here with a green check
mark next to their name. Other pods with which you have previously
interacted will also be visible here
- Click on the tickbox next to the domain(s) you wish to remove
from the allow-list
- Select "Remove from allow-list" from the drop-down menu titled
"Actions" and click "Go" to remove the domain(s)
Purging Existing Content
------------------------
Moderators can add and remove domains at any time, and removing
a domain from the allow-list will effectively block all future
content from being received on your pod. Previously received
messages and content from pods not on the allow-list will remain
until you purge it from your pod. To do this:
- Navigate to the "Moderation" menu. Any domains currently
in the allow-list will be visible here with a green check
mark next to their name. Other pods with which you have
previously interacted will also be visible here
- Click on the tickbox next to the domain(s) you wish to purge
received messages from
- Select "Purge" from the drop-down menu titled "Actions"
and click "Go" to purge the messages