English (US) 简体中文

Articles in this section

Response headers. Add custom HTTP headers

Add headers
Add multiple header values
Check headers

Add response headers

Our "Response headers (add)" option allows you to set custom HTTP headers that CDN servers will include in a response to an end-user. If the same header is already configured on your server, the CDN servers will override its value.

1. Go to the CDN resource settings.

Do the remaining steps below on the tab that opens.

image_1659-2.png

2. In the "HTTP headers" section, select "Response headers (add)".

3. Switch on the "Response headers (add)" option. 

You can add up to 50 response headers.

4. Enter the header name in the "Header name" field. 

5. Enter the header value in the "Value" field that will be sent in the response. 

6. Check the box if you want to add a header to all responses regardless of their status code. If not, uncheck the box. Then headers will be added only to responses with codes 200, 201, 204, 206, 301, 302, 304, 307 and 308. 

7. Click "Add header" if you want to add extra headers. Fill in the fields according to Steps 4 and 5. 

8. Save the changes. 

Add multiple header values

If you need to add more than one header value, you can do it in two ways. It determines how response headers will look like: 

  • If you need to send header values in different strings, enter value of the first header in the "Value" field and press "Enter", then enter a value of the second header and press "Enter", and so on.
    image_1660.png

    In this case, the response header will be transmitted as follows:

    Example: one 
    Example: two 
    Example: three 

  • If you need to send header values in one string, fill in the "Value" field with header values separated by commas. image_1661.png

    In this case, the response header will be transmitted as follows:

    Example: one, two, three 

    You can also combine both ways: enter the values separated by commas and add other values to them separately.

    image_1662.png

In this case, the response header will be transmitted as follows:

Example: one, two 
Example: three 

Valid characters for fields:

  • "Header name":  Latin letters (A-Z, a-z), numbers (0-9), underscore (_) and hyphen (-),
  • "Value": Latin letters (A-Z, a-z), numbers (0-9), a space and the following special characters: `~!@#%^&*()-_=+ /|";:?.><{}[]

The "Value" field restrictions:

  • Invalid characters: \$'
  • It can't start with a special character
  • It cannot contain only special characters

Check headers

1. Clear the cache of the CDN resource or files for which the header was added.

2. Run the cURL command using the terminal on your PC or online services:

curl -I http://cdn.site.com/images/1.jpg 
HTTP/1.1 200 OK 
Server: nginx/1.11.4 
Date: Wed, 05 Apr 2017 19:27:14 GMT 
Content-Type: image/jpeg 
Content-Length: 62890 
Connection: keep-alive 
Last-Modified: Mon, 03 Oct 2016 22:21:05 GMT 
ETag: "f5aa-53dfd5c25d421" 
FILE: Image 
Example: yourvalue 
Cache: HIT 
X-ID: m9-up-e240 
Accept-Ranges: bytes 

3. If the response contains the required header, it means the configuration succeeded.

Related articles