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