Skip to main content
Table of contents

Geographic Access Control (GEOACL)

The Geographic Access Control List (GEOACL) script can be configured to either ALLOW or DENY access to your services based on the geographical location of the end user which is connecting to the CacheFly content distribution network (CDN).

To add an Geographic Access Control List (GEOACL) script config to the list of script configs created for your CacheFly services in general, or to associate an Geographic Access Control List (GEOACL) script config with a specific CacheFly service, see Adding and Using Script Configs.

Using the GEOACL Script Config

You may specify a default behavior which applies if none of the rules match.

You may also specify two lists, one called allow and one called deny. Each list may contain an object with the fields of country and region. Both fields are optional. A match is made only if a request matches against all the fields which have been specified.

Example:

default: deny

allow:

# Allow Connecticut

- country: US

region: CT

# Allow Germany (whole country)

- country: DE

A denied request receives a HTTP 403 response.

Please note that geolocation is on a best efforts basis. Although it can not be 100% accurate, we always use the most accurate data available to us.

Editing the GEOACL Script Config

When you add the Geographic Access Control List script config to your list of script configs in CacheFly, it will initially display a default configuration as a model for you to adapt to your own requirements.

To edit this default configuration:

  • Click the blue Edit button to enter edit mode

  • Modify the script config as you require

  • Remember to click the blue ✔ Save Changes button to save your changes.

As you edit:

  • The CacheFly system shows on-screen prompts to help you select acceptable parameters and values.

  • The blue ✔ Save Changes button will be partially grayed out and will be inactive, until the system confirms that your edits are acceptable.

  • You can cancel your current edits by clicking the gray Cancel button.

Scroll the graphics in this step horizontally to see all the screens.

Additional Help Topics

As an alternative to creating and managing script configs via the CacheFly user interface as described in this guide, you can also create and manage script configs via API calls.

Click the gray API docs button to access the Script Configs section in CacheFly's online API documentation for further information.