Configuring Interceptors

Interceptors perform actions on incoming requests that seek to post content. You can configure interceptors on the Interceptors page of the Admin Console.

Fastpath: Admin Console: Spaces > Settings > Interceptors (change space)

Some of the interceptors have functionality related to features exposed for configuration elsewhere in the Admin Console. For example, the Ban User interceptor is designed to prevent the specified users from posting content. In contrast, the ban settings you can make elsewhere (see Banning People for more information) are designed to ban users from logging in at all.

Note: Filters and interceptors can be applied to discussions, document comments, and blog comments. You can't apply interceptors to the body text of documents, and to a blog post only when it's first created. In other words, keep in mind that people authoring documents and blog posts can create content that's less "filtered."

When you don't want any part of a post or comment with an offending word to enter the space before an action is taken, use an interceptor instead of a filter.

For more about filters, see Filtering and Formatting Content.

Installing Interceptors

Interceptors are included, but not installed/active by default. To set up an interceptor:

Verify that you have selected the correct space to enable interceptors. If you need to change the space, click change space at the top of the page.
From the interceptor list, select the type of interceptor that you want to install (Message Governor, Keyword, and so on).
Click the Install button.
After you've installed the interceptor, it will appear in a list of current interceptors. In that list, click the Edit button next to the interceptor to edit its properties.
Use the list of interceptor properties below to refine how the interceptor will work.
For the search queries, make sure to use the search conventions described in the Search Tips in the end user documentation. Note that you cannot enter a comma-separated list of words in the search query string boxes.

Some things to keep in mind when you are setting up interceptors:

Interceptors are executed in the order they appear in the list of interceptors. So, if you install more than one, use the move arrows to make sure the interceptors are listed in an order that makes sense. For example, do not add a message to a moderation queue by a person whose IP is banned from posting.
You can install an interceptor multiple times, setting it up differently each time.
For the query strings, use the search conventions described in the Search Tips in the end user documentation. Note that you cannot enter a comma-separated list of words in the search query string boxes.

The following is a list of included interceptors, along with more about their properties:

Ban User
In the Ban List box, enter a comma-separated list of application user names for people you want to ban from posting. You can also select to have email sent to these users when they try to post. You can edit the "User Interceptor" message template for the email (see Managing Email Templates for more).
IP Address
This interceptor provides ways to keep an eye on content coming in from certain people (or to simply ban them) based on their IP addresses. In the Banned IP List, enter a comma-separated listed of the IP addresses you want to ban from posting. Use the Email Notification boxes to send email to people you specify (such as administrators in your community) when posts come from certain IP addresses (see Managing Email Templates for more on the "IP Interceptor" template). In the Moderation IP List, enter the addresses of content sources whose posts should automatically be added to the moderation queue. (For more about moderation, see click here).
Gateway Privacy Manager
This interceptor gives you slightly finer control over how gateway-imported messages are handled. You can hide the name or email address of the poster in the incoming message. If you do, you can store the hidden values in extended properties to you can take a look at them later. (For more on extended properties, see Fine-Tuning with Extended Properties.)
Moderation Controller
Use this interceptor for finer control over which users' content is moderated. The interceptor uses the user and group lists that are viewable on the People pages of the Admin Console (for more information, see Managing User and Groups.) Enter comma-separated lists of user names or groups to specify who should always or never be moderated.
Message Governor
Use this interceptor to control how quickly a single user can post messages. For example, you might want to limit frequency if you're having trouble with auto-posting of spam messages. The message template is provided for you in the interceptor properties.
Keyword
Use a keyword interceptor to search strings for keywords in incoming posts. You can choose to have incoming posts:
CAUTION:
Make sure that you are enabling this feature in the correct place. If you need to change the space, click change space at the top of the page.
- Reviewed by a moderator -- Enter your keyword(s) in the Moderation Query String box using the search conventions described in the Search Tips in the end user documentation. Whenever this word(s) is found in a post, it will be sent to the moderator for approval (or rejection) before it is published in the community. Make sure you understand how moderation inheritance works. Finally, click Save Properties to save your changes.
- Blocked from being published -- Enter your keyword(s) in the Blocked Content Query String box using the search conventions described in the Search Tips in the end user documentation. Whenever this word(s) is found in a post, it will be blocked and not published in the community. In the Blocked Content Error Message box, you can create a message for the user to see when a post is blocked, for example, "We're sorry, but this post contains potentially inappropriate content and has been blocked from being posted in the community." Finally, click Save Properties to save your changes.
- Alerted via email to specific users after the posts are published -- Enter your keyword(s) in the Email Query String box using the search conventions described in the Search Tips in the end user documentation. In the Email Notification List box, add the email address(es) of the user(s) you want notified via email whenever this query returns something. Finally, click Save Properties to save your changes.