How to install the Secure Token integration through Azion Marketplace

Azion Secure Token is a serverless integration available at Azion Marketplace.

With the help of the Azion Secure Token integration, you can make token-based, time-limited URLs. The creation and validation of signatures for cookies, authentication headers, and other security measures can be done using these tokens, which can be altered in a variety of ways. Utilizing both HLS and Progressive Download, the solution is frequently used to secure video assets, including those used for live streaming and on-demand content.

Getting the integration

To use the Secure Token integration provided by Azion Marketplace, you have to:

Access Azion Console > Marketplace.
On the Marketplace homepage, select Secure Token card.
Once the integration’s page opens, click the Install button.

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

Generating the token

In order to use this integration, you’ll have to generate a token. To do so, follow these steps:

Go to the Azion’s Secure Token GitHub repository.
- In this repository, you’ll find a brief explanation about how the Secure Token is generated and how to use it.
In the repository, you’ll find two example scripts to generate the tokens, a Python and a PHP script. You can run them locally and generate the token or you can generate these tokens on your own platform with your own code.
Save the generated token, whatever may be the way you generated it through.

Using the Python script as an example, you’ll have the following source code:

#!/usr/bin/env python

import base64
import hashlib

secret = 'mysecret'
uri = '/my/uri'
expire = '1470055000'

md5 = hashlib.md5()
md5.update(secret + uri + expire)
token = base64.b64encode(md5.digest()).replace('=','').replace('+','-').replace('/','_')

print 'http://www.example.org%s?st=%s&e=%s' % (uri, token, expire)

Where:

secret: a string of your choice that will be used to generate the token.
uri: the URI to use with the token.
expire: the expiration time of the token.

Configuring the integration

Setting up an edge firewall

To instantiate the Secure Token integration, follow the steps:

In the Products menu, select Edge Firewall in the Secure section.
Click the + Edge Firewall button.
Give an easy-to-remember name to your edge firewall.
Select the domains you want to protect with the function.
Turn the Edge Functions switch on.
Click the Save button.

Done. Now you’ve instantiated the edge firewall for your function.

Setting up the integration

To instantiate the Secure Token integration, while still on the Edge Firewall page:

Select the Functions Instances tab.
Click the + Function Instance button.
Give an easy-to-remember name to your instance.
On the dropdown menu, select the Secure Token function.

This action will load the Arguments tab.

The Arguments tab will load a JSON file that looks like this:

{ "secure_token_secret": "thatisthesecret"
}

Where the secure_token_secret will be the secret string you’ve passed on the code when generating the token on the previous step.

Click the Save button and you’re done. Your Edge Firewall Secure Token integration is now instantiated.

Select the Functions tab.
Click the Add Function button.
Give an easy-to-remember name to your instance.
On the dropdown menu, select the Secure Token function.

This action will load the function, showing a form with the function code and, just above it, two tabs: Code and Args. By clicking the Code tab, you’ll be able to navigate through the code but not change it. In the same box, you have another tab: the Args tab. On the Args tab, you’ll pass the secret that you used to generate the token previously.

The Args tab will load a JSON file that looks like this:

{ "secure_token_secret": "thatisthesecret"
}

Where the secure_token_secret will be the secret string you’ve passed on the code when generating the token on the previous step.

Click the Save button and you’re done. Your Edge Firewall Secure Token integration is now instantiated.

Setting up the Rules Engine

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

Still in the Edge Firewall page:

Select the Rules Engine tab and follow these steps:
Click the + Rule Engine button.
Give a name to the rule.
Select a criteria to run and catch the domain you want to run the integration on. For example: if Hostname is equal xxxxxxxxxxxx.map.azionedge.net/classes.
Below, select the Run Function behavior to the criteria.

Select the adequate Secure Token function according to the name you gave it in the instantiate step.

Click the Save button.

Done. Now the Secure Token integration is running for every request made to the domain you indicated.

Select the Rules Engine tab and follow these steps:
Click the New Rule button.
Give a name to the rule.
Select a criteria to run and catch the domain you want to run the integration on. For example: if Hostname is equal xxxxxxxxxxxx.map.azionedge.net/classes.
Below, select the Run Function behavior to the criteria.

Select the adequate Secure Token function according to the name you gave it in the instantiate step.

Click the Save button.

Done. Now the Secure Token integration is running for every request made to the domain you indicated.