Help Center> Live> User Guide> Playback Configurations> Access Control (Old Version)> Referer Validation
View PDF

Referer Validation

Referer validation allows you to control access sources based on the referer field carried in an HTTP request. CDN allows or rejects playback requests based on the configured blacklist or whitelist.

Notes

  • This function is optional and is disabled by default.
  • Whitelisting and blacklisting cannot be used simultaneously.
  • A maximum of 100 domain names can be added to a blacklist or whitelist.
  • The domain name configured in a blacklist or whitelist cannot contain a protocol name. The domain name is matched by prefix. For example, if you enter example.example01.com, example.example01.com/123 and example.example01.com.cn are also matched.

Prerequisites

  • The ingest domain name and streaming domain name have been added and associated.
  • CNMAE records have been added to your domains' DNS records.

Procedure

  1. Log in to the Live console.
  2. In the navigation pane, choose Domains.
  3. Click Settings in the row containing the target streaming domain name.
  4. In the navigation pane, choose Basic Settings > Access Control.
  5. Choose Referer Validation. The Referer Validation dialog box is displayed.
  6. Turn on the switch and configure related parameters.

    Figure 1 Configuring referer validation

    Table 1 describes the parameters.

    Table 1 Parameter description

    Parameter

    Description

    Type
    The blacklist and whitelist are supported.
    • Referer blacklist allows all domains access to CDN except for the domains added to the blacklist.
    • Referer whitelist denies all domains access to CDN except for the domains added to the whitelist.

    You can set whether to allow requests with empty referer fields, that is, whether to allow access through the browser address bar.

    Rule

    Domain name in the blacklist or whitelist.

    • Up to 100 rules (at least one rule) are supported. Enter a domain name per line or separate domain names by semicolons (;).
    • The domain name cannot start with a protocol name (http:// or https://).
    • The domain name is matched by prefix. If example.example01.com is entered, example.example01.com/123 and example.example01.com.cn are also matched.

    Examples:

    example.example01.com
example.example02.com

  7. Click OK.
  8. Submit a service ticket for the settings to take effect. The submitted information must contain the configured domain name and information in Table 1.

    Referer validation settings take effect once your request is approved. If you changed referer validation settings, you also need to submit a service ticket for approval.