NGB Whitelist File

This appendix describes the National Geo Blocking (NGB) whitelist file and provides an example of this file.

The NGB whitelist file is a JSON file that identifies a list of CIDR addresses that should be allowed even if NGB would block them. The NGB whitelist is assigned to a Traffic Router profile. Because only one Traffic Router profile can be applied to the Traffic Routers in a CDN, the NGB whitelist acts as a global list that will apply to all of the Delivery Services of the CDN.

The "NGB Whitelist File Format" table provides information on the format of the ingest manifest file. An example NGB whitelist file is shown after the table.

Table 1. NGB Whitelist File Format

Key

Description

date

Enter the date the file was created. This field is required but is currently not used.

name

Enter a descriptive name for the NGB whitelist file. This field is required but is currently not used.

version

This string can be used to track the version of the file. This field is required but is currently not used.

customer

Enter a string that describes the customers associated with this NGB whitelist file. This field is required but is currently not used.

ipWhiteList

Enter a JSON array of comma separated CIDR addresses that should be exempt from NGB blocking. This array can include a mix of IPv4 and IPv6 addresses in valid CIDR notation.

The following is an example of an NGB whitelist file:

{ 
    "date": "2018-08-10 22:59:03", 
    "name": "National Geoblocking Whitelist Policy", 
    "version": "1", 
    "customer": "CU", 
    "ipWhiteList": [ 
      "192.0.2.14/32", 
      "192.0.2.158/32", 
      "198.51.100.0/24", 
      "203.0.113.0/24",
      "2001:DB8::1/64 
      "2001:DB8::2/64 
    ] 
}

For information on uploading the NGB whitelist file to the Traffic Router profile, see NGB Whitelist.