tencent cloud

Feedback

Modifying HTTP Request Headers

Last updated: 2023-10-13 14:24:24

    Overview

    When Edgeone nodes origin-pull, if the origin needs to obtain some specific information through the HTTP request header for business logic judgment or data analysis, such as: client device type, acceleration service provider. This can be achieved by customizing/adding/deleting HTTP origin-pull request headers (node origin-pull direction), where the header value supports variables, please refer to EdgeOne preset variables for details.
    
    74b09faad77111ed8c12525400c56988.png
    
    
    Note:
    EdgeOne supports carrying X-Forwarded-For and X-Forwarded-Proto by default for origin-pull, and you do not need to configure it again, please see: Default HTTP Headers of Origin-Pull Requests.

    Directions

    Scenario 1: Carry device type information to the origin when origin-pulling

    For example: If you want the current domain name www.example.com to aggregate the User-Agent header value carried by the client request into device type-related headers and pass them to the origin when origin-pulling, you can refer to the following steps for configuration:
    1. Log in to the EdgeOne console, click on the site list in the left menu bar, and click on the site to be configured in the site list.
    2. On the site details page, click on the rule engine.
    3. On the rule engine management page, click Create Rule to enter the new rule editing page.
    3.1 On the rule editing page, select the matching type as Host equals www.example.com.
    3.2 Click on the operation, and in the pop-up operation list, select the operation to modify the HTTP origin-pull request header.
    3.3 Select the type as Add, the preset header with the header name EO-Client-Device, and the configuration result is as follows:
    
    
    
    4. Click Save and Publish to complete the rule configuration.

    Scenario 2: Pass the acceleration domain name to the origin through a custom header when origin-pulling

    For example: If your current domain name www.example.com has been configured to origin-pull Host for other domain names, and you want to pass the acceleration domain name to the origin through a custom header Tencent-Acceleration-Domain, you can refer to the following steps for configuration:
    1. Log in to the EdgeOne console, click on the site list in the left menu bar, and click on the site to be configured in the site list.
    2. On the site details page, click on the rule engine.
    3. On the rule engine management page, click Create Rule to enter the new rule editing page.
    3.1 On the rule editing page, select the matching type as Host equals www.example.com.
    3.2 Click on the operation, and in the pop-up operation list, select the operation to modify the HTTP origin-pull request header.
    3.3 Select the type as Add, the header name as Tencent-Acceleration-Domain, and the header value as ${http.request.host}, and the configuration result is as follows.
    
    
    
    4. Click Save and Publish to complete the rule configuration.

    Related Reference

    The types supported by modifying the HTTP origin-pull request header are described as follows:
    Type
    Description
    Set
    Change the value of the specified header parameter to the set value, and the header is unique. Note: If the specified header does not exist, the header will be added.
    Add
    Add the specified header. Note: If the header already exists, the original header will be overwritten.
    Delete
    Delete the specified header.
    Supported header name description:
    Header Type
    Description
    Custom
    Custom header.
    Name: 1 - 100 characters, consisting of numbers 0 - 9, characters a - z, A - Z, and special symbol -.
    Value: 1 - 1000 characters, Chinese not supported.
    Preset Header
    Headers aggregated based on client User-Agent information:
    Client Device Type: EO-Client-Device
    Value: Mobile, Desktop, SmartTV, Tablet or Others
    Client Operating System: EO-Client-OS
    Value: Android, iOS, Windows, MacOS, Linux or Others
    Client Browser Type: EO-Client-Browser
    Value: Chrome, Safari, Firefox, IE or Others

    Limitations

    In the same Modify HTTP Request Header operation, multiple different types of operations can be added, up to 30, and the execution order is from top to bottom.
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support