Extend CDN functionality with FastEdge

Currently, you can use a predefined template to enable authentication in your application. The template is configured to verify the JSON Web Token (JWT) in the request header.

To deploy an application from the template:

1. In the Gcore Customer Portal, navigate to FastEdge.
2. Open the CDN Applications page and click Create new application.

3. In the Create from a template section, choose Validate JWT in Authorization header.

4. Enter a name for your application and, optionally, update its description.
5. Add required environment variables, such as a token signing key that will be used for authentication checks.

6. Click Save and deploy.

Your application has been successfully deployed and can now be accessed through the CDN.

If you need to adjust the configuration, click Actions > Edit application.

If you want to deploy a FastEdge application from your own binary, check the examples of custom implementation in our repository: FastEdge application examples.

To deploy a FastEdge application from your own binary:

1. In the Gcore Customer Portal, navigate to FastEdge.
2. Open the CDN Applications page and click Create new application.

3. Click Upload binary.

4. Choose your custom binary file. If you add multiple files, click Save binary to confirm and upload the selected files.
5. Enter a name for your application and, optionally, add a description.
6. Add required environment variables that will be used for authentication checks. Enter the data as key-value pairs.

If you’re adding sensitive information or want to ensure that any data in the app’s configuration remains secure, encrypt the variables. Click Encrypt next to the value you want to secure:

The provided value will be replaced with the Encrypted Value text, and the Revert button will appear next to encrypted value. This button allows you to restore the original version if needed.

We store all encrypted variables in a separate table in the database to protect your information from potential security breaches or unauthorized access.

Note that you won’t be able to view the original unencrypted value once you save the configuration.

7. Click Save and deploy.

Your application has been successfully deployed and can now be referenced from CDN resource settings. To adjust the configuration, click Actions > Edit application.

1. In the Gcore Customer Portal, navigate to CDN.
2. Find the resource you want to integrate with FastEdge and open the resource settings.

3. Scroll the page down to the FastEdge apps section and enable the toggle for the event you need.

   Currently, we support four events: On request headers, on request body, on response headers, and on response body.

4. Choose your application from the dropdown.

5. (Optional) Select the Interrupt request processing in case of error checkbox.

6. Click Save.

You can set up a function within your uploaded FastEdge application to manage incoming request headers only for specific URLs. For example, protect some parts of your content with a JWT token, and keep the other URLs unaffected.

To enable the function for specific URLs:

1. In the Gcore Customer Portal, navigate to CDN.
2. Find the resource you want to integrate with FastEdge and open the resource settings.
3. Click Rules > Create rule.

4. Click Create blank rule.

5. Give your rule a name.

6. In the Match criteria section, specify the content affected by the function configured in your FastEdge application.

7. In the Options section, click Add option.

8. Scroll the page down to the FastEdge apps section and enable the toggle for the event you need.

   Currently, we support four events: On request headers, on request body, on response headers, and on response body.

9. Choose your application from the dropdown.

10. (Optional) Select the Interrupt request processing in case of error checkbox.

12. Click Create rule.