How to install the Massive Redirect integration through Azion Marketplace

Massive Redirect is a serverless integration available at Azion Marketplace. This type of integration is mainly used for handling a massive quantity of domain redirects, such as domain migrations.

This integration permits you to control this domain redirection directly at the network’s edge, centralizing the management of several settings in one location. It also enables you to operate a variety of situations, such as CMS or e-commerce platform migration, website upgrades, and many others. No matter how many pages you have, you can configure all your redirects with the Massive Redirect integration.

Getting the integration

To use the Massive Redirect integration provided by Azion Marketplace, you have to:

Access Azion Console > Marketplace.
On the Marketplace homepage, select the integration’s card.
Once the integration’s page opens, click the Install button, at the bottom-right corner of the page.

You’ll see a message indicating that your integration was successfully installed.

Configuring the integration

Once you’ve gotten your integration on Marketplace, it’ll be available at your edge functions list. To use the integration, you’ll have to create a new edge application.

Configuring Edge Firewall

To configure your integration, proceed as follows:

On the upper-left corner, select Products menu > Edge Application on the BUILD section.
On the listing page of your edge applications, select the one you want to use with the integration.
On the application page, on the Main Settings tab, locate the Edge Functions switch and turn it on.
Click the Save button.

You’ll receive a success message indicating that your edge application has been updated.

Instantiating the integration

To enable this function:

Select the Functions tab on the top list.
Click the Add Function button.
Choose an easy to remember name for your function.
On the function dropdown menu, select the Massive Redirect [Global] function.

This action will load the function, showing a form with the function 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 code, but won’t be able to change it. The configuration of your Massive Redirect function will be made on the Args tab.

Click on the Args tab to open the form with the JSON Args where you’ll add the parameters to execute your application.

The Args tab will show a JSON file like the one below:

[
  {
    "from": "http://www.azion.com.br",
    "found": "http://www.azion.com"
  }, {
    "from_regex": "http://www\\.(azion)\\.com$",
    "moved": "https://www.%s.com"
  },{
    "from_regex":"http://www\\.azion\\.com/t/other/([\\w_]+)/([\\w_]+)/([\\w_]+)/$",
    "moved":"http://www.azion.com.br/doc/%3$/%1$/%2$/"
  }
]

Where:

from: this is where you’ll pass the previous URL, the one you want to redirect to a new one.
moved: this is where you’ll pass the new URL, the one you want to be the target of your redirect rule. This URL will be used as a permanent redirect to the previous URL.
from_regex: this option permits you to pass multiple redirections in one command, passing more than one address in one line.
found: this is the same as moved, but in this case you have a temporary redirect to a URL.

Select the Functions Instances tab.
Click the + Function Instance button.
Choose an easy to remember name for your function.
On the function dropdown menu, select the Massive Redirect [Global] function.

This action will load the Arguments tab, where you can add the parameters to execute your application.

The Arguments tab will show a JSON file like the one below:

[
  {
    "from": "http://www.azion.com.br",
    "found": "http://www.azion.com"
  }, {
    "from_regex": "http://www\\.(azion)\\.com$",
    "moved": "https://www.%s.com"
  },{
    "from_regex":"http://www\\.azion\\.com/t/other/([\\w_]+)/([\\w_]+)/([\\w_]+)/$",
    "moved":"http://www.azion.com.br/doc/%3$/%1$/%2$/"
  }
]

Where:

from: this is where you’ll pass the previous URL, the one you want to redirect to a new one.
moved: this is where you’ll pass the new URL, the one you want to be the target of your redirect rule. This URL will be used as a permanent redirect to the previous URL.
from_regex: this option permits you to pass multiple redirections in one command, passing more than one address in one line.
found: this is the same as moved, but in this case you have a temporary redirect to a URL.

Configuring a rule on Rules Engine

Still in the Edge Application page, in the Rules Engine tab, you have to configure the rules you want (criteria and behavior) to apply to run your function.

To do this, select the Rules Engine tab and proceed as follow:

Add a new rule by clicking on the + Rule button.
Give an easy-to-remember name and, optionally, a description to your rule.
Select the Request Phase.
Set a criteria for checking your domain. You’ll have something like if: ${domain} is equal xpto.com.
On the behavior section, on Then, select Run a Function from the dropdown menu and then select the Massive Redirect option according to the name you gave it.
Click the Save button.

Add a new rule by clicking on the New Rule button and then selecting the Request Phase.
Give an easy-to-remember name and, optionally, a description to your rule.
Set a criteria for checking your domain. You’ll have something like if: ${domain} is equal xpto.com.
On the behavior section, on Then, select Run a Function from the dropdown menu and then select the Massive Redirect option according to the name you gave it.
Click the Save button on the lower-right corner.