Administering Country Filtering Configurations

This topic provides setup information and step-by-step procedures on how to add, modify, and delete a country filtering configuration.

Key information:

• It may take up to an hour before the creation, modification, or deletion of a country filtering configuration takes effect.
• This feature does not support wildcard characters (e.g., *).

• A country filtering configuration is applied recursively to the specified directory.

  In other words, this configuration is applicable when requesting the specified directory or its contents. A directory's contents includes all subdirectories and their contents.

• Only a single country filter can be explicitly defined per directory.

  In other words, multiple country filter configurations cannot point to the same relative path. However, a country filtering configuration may be applied to a directory that inherits one or more country filtering configurations.

Directory

A country filtering configuration must be associated with a directory.

A country filtering configuration will be applied recursively to the specified directory.

Key information:

• This directory must be identified by its relative path.
• The specified relative path is compared against all CDN and edge CNAME URLs that request content from this platform.
• This relative path must start with a forward slash (/).
• This relative path may include a trailing forward slash (/).

• The starting point for this relative path is defined below:

  URL Type	Relative Path (Starting Point)
  CDN URL	Specify a relative path that starts directly after the content access point (e.g., /000001, /200001, or /800001). Sample URL: http://can.0001.transactcdn.com/800001/customerorigin/videos/fly.html In the above sample URL, the gray text indicates what should be excluded when securing a location. This sample request can be secured by any of the following configurations: / /customerorigin /customerorigin/videos
  Edge CNAME URL (CDN Origin)	Specify a relative path that starts directly after the hostname. Sample URL: http://www.domain.com/presentations/sales/businessplan.ppt In the above sample URL, the gray text indicates what should be excluded when securing a location. This sample request can be secured by any of the following configurations: / /presentations /presentations/sales
  Edge CNAME URL (Customer Origin)	Specify a relative path that starts with the name of the customer origin configuration referenced by the edge CNAME URL. Sample edge CNAME URL: http://www.domain.com/Photos/Store.jpg Our edge servers will re-write the edge CNAME URL requested by the client (above) with the following CDN URL: http://can.0001.transactcdn.com/800001/customerorigin/Photos/Store.jpg The above CDN URL is used to determine the starting point for the relative path that should be secured. The gray text in the above CDN URL indicates what should be excluded when securing a location. This sample request can be secured by any of the following configurations: / /customerorigin /customerorigin/Photos

Action

Once a relative path has been specified, choose whether to allow or block requests.

• Allow: Requests for content stored in a secured path will only be allowed if they originate from one of the countries defined in the country filtering configuration.
• Block: Requests for content stored in a secured path will be denied if they originate from one of the countries defined in the country filtering configuration. If no other country filtering configurations are applicable, then requests that originate from any other country will be allowed access.

Countries

The final step requires selecting one or more countries to which the current country filtering configuration will be applied.

Europe (EU) and Asia/Pacific Region (AP) are not meant to identify all requests from those regions.
Learn more.

Administration

Instructions on how to add, modify, or delete a Country Filtering configuration are provided below.

To add a country filtering configuration

1. Navigate to the Country Filtering page. How?From the main menu, navigate to CAN | Country Filtering.

2. Click Add Country Filter to launch the Country Filter wizard.

3. Specify the relative path to the directory (e.g., /myorigin/myfolder) to which Country Filtering will be applied.

   Country Filtering will be recursively applied to the specified directory across all customer origins and CDN storage.

4. Select whether to Block or Allow requests to the directory specified in the previous step.
5. Click Next.
6. Select each country for which access will be allowed or denied.
7. Click Finish.

To modify a country filtering configuration

1. Navigate to the Country Filtering page.
2. Click the next to the desired country filtering configuration. The Country Filter wizard will display the settings for the selected country filter configuration.
3. Modify the desired settings.
4. Click Finish to save your changes.

To delete a country filtering configuration

1. Navigate to the Country Filtering page.
2. Click the next to the desired country filtering configuration.
3. When prompted, confirm the deletion of the country filtering configuration.

Edgecast CDN