All Products
Search
Document Center

ApsaraVideo Live:Configure region blocking

Last Updated:Jan 05, 2024

ApsaraVideo Live supports the region blocking feature. After you add regions to a blacklist or whitelist, ApsaraVideo Live identifies the source regions of requests and blocks or allows requests from the specified regions. This way, you can block malicious requests by region and resolve content copyright issues. This topic describes how to configure region blocking.

Usage notes

  • The HTTP Live Streaming (HLS), Real-Time Messaging Protocol (RTMP), Flash Video (FLV), and Real-Time Streaming (RTS) protocols are supported.

  • You can configure region blocking at the domain name level or at the stream level. If you add a region to a domain-level whitelist and a stream-level blacklist, the region is blocked at the stream level. If you add a region to a domain-level blacklist and a stream-level whitelist, the region is blocked at the domain name level.

  • You can configure domain-level region blocking and stream-level region blocking at the same time. If there is a conflict between the configurations of domain-level region blocking and stream-level region blocking, the configuration in which a blacklist is specified shall prevail.

Configure domain-level region blocking

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, click Domains to go to the Domain Management page.
  3. Find the streaming domain that you want to configure and click Domain Settings in the Actions column.

    001

  4. Choose Streaming Management > Access Control.

  5. Click the Region Blocking tab. Turn on Domain-level Region Blocking, and specify Blocking Type and Blocked Regions or Allowed Regions in the dialog box that appears.

  6. Parameter

    Description

    Blocking Type

    • Blacklist: All requests from the regions in the blacklist are blocked from accessing resources in the streaming domain.

    • Whitelist: Only requests from the regions in the whitelist are allowed to access resources in the streaming domain.

    The blacklist and whitelist are mutually exclusive. Only one of them can take effect at a time.

    Blocked Regions or Allowed Regions

    The regions in the blacklist or whitelist.

  7. Click OK.

Stream-level region blocking

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, click Domains to go to the Domain Management page.
  3. Find the streaming domain that you want to configure and click Domain Settings in the Actions column.

    001

  4. Choose Streaming Management > Access Control.

  5. Click the Region Blocking tab. In the Stream-level Region Blocking section, click Add Rule.添加封禁..png

    Parameter

    Description

    AppName

    The name of the application to which the live stream belongs.

    Note

    The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), underscores (_), and equal signs (=). The blocking rule takes effect only if the value of this parameter is the same as the application name specified in the streaming URL.

    StreamName

    The name of the live stream.

    Note

    The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), underscores (_), and equal signs (=). The blocking rule takes effect only if the value of this parameter is the same as the stream name specified in the streaming URL.

    Blocking Type

    • Blacklist: All requests from the regions in the blacklist are blocked from accessing resources in the streaming domain.

    • Whitelist: Only requests from the regions in the whitelist are allowed to access resources in the streaming domain.

    Note

    The blacklist and whitelist are mutually exclusive. Only one of them can take effect at a time.

    Blocked Regions or Allowed Regions

    The regions in the blacklist or whitelist.

    Expiration Time

    The time when the blocking rule expires. By default, the expiration time of the rule is seven days from now. Modify this parameter based on your business requirements.

  6. Click OK.

  7. View the stream-level region blocking rule. After you add a stream-level region blocking rule, you can refresh the rule list to view the rule status. You can query rules based on the blocking type, application name, and stream name.