1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

doc

How to install the Process Request Data Into Headers solution from Azion Marketplace

Overview

The Process Request Data Into Header solution is a serverless solution available at Azion Marketplace.

The purpose of this function is to stop a request whenever a request body field is empty. Using regex, the user can validate not only whether the field exists but also patterns. Additionally, they have the option to use any behavior they choose rather than a predetermined Deny Request.

  1. Getting the solution
  2. Using the solution
    2.1 Setting up the Edge Firewall rule
    2.2 Setting up the solution
  3. Setting up the Edge Firewall Rules Engine

1. Getting the solution

To install the solution, follow these steps:

  1. Log in to your Real-Time Manager (RTM) account.
  2. On the upper-left corner of the page, select Products menu > Marketplace.
  3. Select the search box and type “request” or browse through the cards to find the Process Request Data Into Header solution.
  4. Once you’ve found the solution’s card, select it to go to the solution’s page.
  5. On the solution’s page, look for the Subscribe for section on the bottom-right corner.
  6. Click the Get It Now button.

After clicking on the Get it now button, you’ll see a message indicating that your solution was successfully installed and is ready to use.

2. Using the solution

2.1 Setting up the Edge Firewall rule

To instantiate the Process Request Data Into Header solution, follow the steps:

  1. On RTM, on the Products menu, select Edge Firewall in the SECURE section.
  2. Click the Add Rule Set button.
  3. Give an easy to remember name to your new rule.
  4. Select the domains you want to protect with the function.
  5. Turn the Edge Functions switch on.
  6. Click the Save button.

Done. Now you have instantiated the rule for your function.

2.2 Setting up the solution

To instantiate the Process Request Data Into Header solution, while still on the Edge Firewall page, select the Functions tab and follow these steps:

  1. Click the Add Function button.
  2. Give an easy to remember name to your instance.
  3. On the dropdown menu, select the Process Request Data Into Header function.

This action will load the function, showing a form with the function’s source code and, just above it, two tabs: Code and Args. By clicking on the Code tab, you’ll be able to navigate through the source-code, but won’t be able to change it. Also, this function doesn’t address any argument on the Args tab, but you can test it using the curl command.

Curl command examples

Curl Command Request headers added by the function
curl https://mydomain/function X-Body-Error": "CT001
curl -H "Content-Type: application /x-www-form-urlencoded" --request POST --data 'param1=v1&param2=v2&param3=v3' https://mydomain/function X-Body-Param1": "v1"
X-Body-Param2": "v2"
X-Body-Param3": "v3"
curl -H "Content-Type: application /json" --request POST --data '{"my_data": {"abc": {"def": {"g": "xyz","h": false,"e": null}}, "number": 1}}' https://mydomain/function X-Body-My-Data-Abc-Def-G": "xyz"
X-Body-My-Data-Abc-Def-H": "false"
X-Body-My-Data-Number": "1"
curl -H "Content-Type: text /plain" --request POST --data 'plain=text' https://mydomain /function X-Body-Error": "CT002"
curl -H "Content-Type: application /json" --request POST --data '{"my_data": {"abc": {"def": {"g": "xyz","h": false,"e": null}}, "number": 1}' https://mydomain/function X-Body-Error": "FD001"

Important: as long as the request has a valid Content-Type header and a valid request body, the solution converts the body fields into headers. This solution also supports nested object data; in this case, each “level” will be separated by a hyphen.

Possible errors

This solution can trigger errors; in this case, the errors will be appended to a new header called X-Body-Error.

Error Code Description
CT001 The header Content-Type is missing or it’s null.
CT002 The header Content-Type has a value, but it isn’t supported by the function.
FD001 The request body isn’t correctly formatted and couldn’t be decoded.

3. Setting up the Edge Firewall Rules Engine

To finish, you have to set up the Rules Engine to configure the behavior and the criteria to run the solution.

Still in the Edge Firewall page, select the Rules Engine tab and follow these steps:

  1. Click the New Rule button.
  2. Name your rule something easy to remember.
  3. Select a criteria to run and catch the domain you want to run the solution on.
  4. Below, select a behavior to the criteria. In this case, it’ll be Run Function. Then, select the adequate Process Request Data Into Header function, according to the name you gave it in the instantiate step.
  5. Click the Save button.

Done. Now the Process Request Data Into Header solution is running for every request made to the domain you indicated.

Didn’t find what you were looking for? Open a support ticket.