Updated on 2026-01-09 GMT+08:00

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.
  • Whitelists and blacklists cannot be used simultaneously.
  • A maximum of 1,000 domain names can be added to a blacklist or whitelist.
  • Domain names added to a blacklist or whitelist are matched using regular expressions. For example, if you add ^http://test.*com$ to a blacklist or whitelist, http://test.example.com and http://test.example01.com are matched.

Prerequisites

Procedure

  1. Log in to the Live console.
  2. In the navigation pane, choose Domains.
  3. Click Manage in the Operation column of the desired streaming domain name.
  4. In the navigation pane, choose Basic Settings > Access Control.
  5. Click the edit icon on the right of Referer Validation. The Referer Validation dialog box is displayed on the right.
  6. Toggle on the switch and configure related parameters.

    Figure 1 Configuring referer validation

    Table 1 describes the parameters.

    Table 1 Referer validation parameters

    Parameter

    Description

    Type

    Blacklists and whitelists are supported.
    • Referer blacklist allows requests from all domains except those in the blacklist.
    • Referer whitelist denies requests from all domains except those in the whitelist.

    You can control whether to allow requests with an empty referer field, that is, whether to allow access through the browser address bar.

    Rule

    Domain name in the blacklist or whitelist.

    • You can input 1 to 100 domain names. Use semicolons (;) to separate domain names.
    • Domain names are matched using regular expressions. If you enter ^http://test*.com$, http://test.example.com and http://test.example01.com are matched.

  7. Click OK.