How to install the Upstash Waiting Room integration through Azion Marketplace

Upstash Waiting Room is an integration that helps you manage traffic surges and prevent overload on your websites and applications. The integration uses a First-In, First-Out (FIFO) approach and leverages on Azion Edge Firewall, creating a waiting room to control and redirect access according to your parameters.

When a request is received by your website, Edge Firewall executes the integration. Then, the integration verifies if there’s available space and moves the request from the waiting queue to the release queue. If there isn’t availability, the request is redirected to the waiting room, receiving a number in the row to access.


To start using this integration, you need to:


To install this integration:

  1. Access Real-Time Manager (RTM) > Marketplace.
  2. On the Marketplace homepage, select the Upstash Waiting Room card.
  3. On the integration page, click the Get It Now button, located at the bottom-right corner of the page.

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


Once you’ve installed the Upstash Waiting Room integration, you’ll need to complete the steps explained below to configure it.

Setting up the Edge Firewall rule

Section titled Setting up the Edge Firewall rule

Follow the steps:

  1. On the upper-left corner, open the Products menu and 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. Enable the Edge Functions switch in the Edge Firewall Modules.
  • This action gives access to edge functions on your edge firewall.
  1. Click the Save button.

Done. Now you’ve instantiated the rule for your function and have access to edge functions on your edge firewall.

Setting up the Edge Firewall function

Section titled Setting up the Edge Firewall function

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 Upstash Waiting Room function.

This action will load the function, showing a form with the function’s source code and 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.

  1. In the Args tab, you’ll pass your Upstash credentials and your variables:
{
"url": "https://region-database.upstash.io",
"token": "YourUpstashToken",
"ttl": 10,
"capacity": 2
}

Where:

VariableMandatoryDescription
urlYesURL string to connect on Upstash Redis. Go to your Upstash Console and copy the UPSTASH_REDIS_REST_URL in your database page
tokenYesToken to access the Upstash Redis database. Go to your Upstash Console and copy the UPSTASH_REDIS_REST_TOKEN in your database page
ttlYesMaximum time, in seconds, a user can stay on your website. Example: 180
capacityYesMaximum number of simultaneous connections allowed on your website. Example: 10

To finish, you must set up a rule in Rules Engine to configure the criteria and the behavior to run the function.

Still in the Edge Firewall page:

  1. Select the Rules Engine tab.
  2. Click the New Rule button.
  3. Give an easy-to-remember name to the rule.
  4. Select a criteria to run and catch the domains that you want to run the integration on.
  • Example: if Request URI starts with ./.
  1. Below, select the Run Function behavior to the criteria.
  2. Select the Upstash Waiting Room function according to the name you gave it before.
  3. Click the Save button.

Done. Now the Upstash Waiting Room integration is running.


Contributors