Add or hide response headers

​

Add response headers

1. In the Gcore Customer Portal, navigate to CDN → CDN resources.
2. Click the resource to open its settings.
3. In the left panel, click HTTP headers to expand the section, then click Response headers (add) to jump to the option.
4. Enable the Add response headers toggle.

5. In the Header name field, enter a header name.
6. In the Value field, enter the header value.
7. The Always add the header to response from CDN regardless of response code checkbox is enabled by default, which adds the header to all responses. To add the header only to responses with codes 200, 201, 204, 206, 301, 302, 303, 304, 307, and 308, uncheck the box.
8. Click Add header to add more headers. Fill in the fields for each additional header.
9. Click Save changes.

{
  "options": {
    "static_response_headers": {
      "enabled": true,
      "value": [
        {
          "name": "X-Custom-Header",
          "value": ["example-value"],
          "always": false
        }
      ]
    }
  }
}

​

Add multiple header values

• Separate strings: enter the first value and press Enter, then enter the second value and press Enter. Repeat for each additional value.

Example: one   
Example: two   
Example: three 

• Single string: enter all values in the Value field separated by commas.

Example: one, two   
Example: three 

• 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: ~!@#%^&*()-_=+ /|";:?.><{}[]

• Invalid characters: $'
• Cannot start with a special character
• 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 following cURL command, substituting the file URL:

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 configured header, the setup is complete.

​

Hide response headers

1. In the Customer Portal, navigate to CDN → CDN resources.
2. Click the resource to open its settings.
3. In the left panel, click HTTP headers to expand the section, then click Response headers (hide) to jump to the option.
4. Enable the Hide response headers toggle.

5. Select a mode:

• Hide all except — set the headers to keep in the response; all other headers are hidden. After enabling, the most common headers appear pre-filled. Remove headers by clicking the × icon, or add headers by clicking the HTTP headers row and selecting from the list or entering a name. Header names accept letters (a–z), numbers (0–9), dashes (-), and underscores (_).

• Hide only — set the headers to hide from the response; all other headers are kept. Click the HTTP headers row and select from the list or enter custom header names.

6. Click Save changes.