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

site

doc

blog

success stories

First Steps

Edit on GitHub

Welcome to the Edge

This documentation helps new users get started with Azion’s platform and products. Our mission is to power the hyper-connected economy – creating new technologies that unlock new possibilities.

To explore the features of our platform, start by creating an account if you haven’t done so.

  1. Getting to know us
  2. Creating account
  3. Getting to know Real-Time Manager
  4. Creating Edge Applications
  5. Settings of an Edge Application
  6. Creating a new Domain associated with your Edge Application
  7. Linking your application traffic to the Azion platform
  8. Keeping your account after the trial period/Billing

1. Getting to know us

If you’d like to know more about Azion, start exploring our about us section. If you’re looking for more information on Edge Computing and our solutions, we suggest taking some time to explore our blog to understand more about our digital transformation.

2. Creating account

Start by heading to the sign-up page to create an account – there’s no commitment, and you can use up to US$300 for free over 12 months so that you can experience our products:

  1. From the sign-up page, fill in the following information: Full name, E-mail, and Password. All fields are required.
  2. You automatically agree to the Customer Agreement Terms and Privacy Policy by proceeding with the registration process.
  3. Click Sign up with e-mail. You must verify your e-mail to confirm your account creation.
  4. Check your inbox and look for the verification e-mail.
  5. In the message, you will find instructions to confirm your e-mail address. Click on the URL to activate your account. This link is valid for 14 days.

If you do not receive the e-mail, check your Spam folder. The e-mail contains the following headers:

From: Azion Technologies - noreply@azion.com

Subject: Please Verify Your Azion Account

If you have any questions, contact our sales team.

  1. By clicking on the link sent by email, you will be redirected to the Real-Time Manager page.
  2. Enter your email and click Proceed. Then, enter your password and click Sign in.
  3. Fill in the following fields to update your account: Company name, Company size, Job function, and Country. Click Create my account.

3. Getting to know Real-Time Manager

The Real-Time Manager (RTM) is Azion’s Platform, where you can access all of our products.

From the main page, in the Getting Started section, you will find three shortcuts:

  • Build an Edge Application: this onboarding block will guide you through the initial steps to building your first Edge Application with the setup that best suits your needs;
  • Manage your Domains: click this block to visit the Domains page. There, you will be able to manage and add domains.

    You can create a domain with an SSL certificate granted by Azion. You can also automate domain creation using our API - Azion Domains.

  • View Edge Application Metrics: here, you will find insights based on your applications’ performance, availability and security. This link will take you to Real-Time Metrics.

Below the quick-access options, you will find our product stacks: Build, Secure, Deliver and Observe. Read on to learn how you can explore each section:

On the sidebar, access detailed documentation from all Azion products, changelogs (read our changelog for the latest product updates), visit our API library and contact our support team.

If you’d like to access your account details, head to the top right and click the Account menu. You can manage billing, users, and general information in it.

For questions regarding users and teams, multi-factor authentication, or account deletion, read the specific documentation.


Basic setups to get you started with Azion

Make sure you have an account to sign into RTM to get you started. These next steps will get you started with our platform so that you can build and deliver applications running at the Edge. Read on to create your first application. To learn more about the settings of an application, click here.

4. Creating Edge Applications

Read on to use our onboarding journey: this is the best way to get familiar with our platform and create an Edge Application. This procedure has two steps: (1) build and (2) launch an Edge Application.

From the main page, do as follows

Step 1: Build

  1. Click Build an Edge Application to initiate the onboarding journey.
  2. On the new page, fill out the following information:

Basic information

Edge Application name (mandatory): define a title you want to use for this application.

Choose a setup option to start (mandatory):

Setup Description
Run a function Choose this setup if you’d like to create an Edge Application with an Edge Function instantiated in it. You can choose from a list of previously tailored functions or a preregistered Hello World.
Fetch content from origin This setup allows you to create an Edge Application and configure an Origin, allowing Azion to use it to fetch your content directly from there.
Build an advanced Edge Application This setup creates an Edge Application that can be later customized according to the users’ needs. Use this setup to create an application without origin.

By choosing either of the setups above, an Azion Domain will be created with the application.


If you choose Run a function, complete the setup:

Configure function

Field Description
Choose Edge Function

(mandatory)
Select a function from the list.

If this is your first Edge Application, the Hello World function will appear as the only registration on the list. As you create more Functions, they will appear on the dropdown list.

Read more: Edge Functions - API

Next, click Save and continue.


If you choose Fetch content from origin, complete the setup:

Configure Origin

Field Description
Address
(mandatory)
This field defines the address in which you run your application or origin. Define the origin address of your Application in FQDN (Fully Qualified Domain Name) format. For example: origin.azion.com, or an IP address.
By default, Azion will connect to your origin through port 80, for HTTP, or 443, for HTTPS. Suppose you want to configure a different port to connect to your origin – in that case, you can use the host:port notation in this field, for example, origin.azion.com:8080.

Note: you cannot configure the same delivery domain used for your content delivery as the origin. The origin must have its own address.
Custom host header
(optional)
This information is used to define which application should be accessed, enabling the origin server to distinguish among resources while servicing requests for multiple hostnames on a single IP address.

Your origin uses the Host header to identify the virtual host and locate your content or Application. When setting up an origin in Real-Time Manager, you can customize the value that Azion must send in the Host header.

Read more: Origins - API

Next, click Save and continue.


If you choose Build an advanced Edge Application, click Save and continue to keep configuring your application.

This setup creates an application without origin. You will be redirected to the advanced settings.

Read more: Edge Application - API


Step 2: Launch

This step displays a summary of your newly created application and its link. Next, you can finalize your application settings according to your preferences:

- Customize your Domain;

- Manage the advanced settings of your application and turn on modules;

- View application metrics using Real-Time Metrics;

- View application logs with Real-Time Events.

Screen Shot 2021-11-25 at 17 21 15

The possibility of editing some of the mentioned setups is subject to your account permissions.

Click Back home to go back to the main RTM page and explore other features and products.

5. Settings of an Edge Application

After creating an application, you can customize or edit it anytime you desire.

From the home screen or from the products menu, select Build > Manage your applications and click on any application listed if you want to edit/access it. You can also create an application from this screen by clicking Add application. If you’re creating a new application, type a name for it.

Next, you must fill out the following fields:

Main Settings

In this section, you will define the main fields related to the delivery of your Applications: HTTP or HTTP & HTTPS. And, also, the Minimum TLS version and Ports fields.

Field Description
Delivery Protocol Define your Delivery Protocol and Port HTTP (which has different patterns for different web servers). Choose the protocol supported by your web application.HTTP: if your application only supports the HTTP protocol.
HTTP & HTTPS: if your application supports both HTTP and HTTPS protocols. To use HTTPS, you will need Digital Certificates.
If you choose HTTP/HTTPS as the Delivery protocol, you must enter the HTTPS port and the TLS.
Minimum TLS version Transport Layer Security (TLS) guarantees encrypted communications between a client and a web server via HTTPS.PCI standards recommend the use of TLS 1.2 or higher. Remember, if you use new versions, some older client devices or browsers will not be able to connect.

Origins

Origins is where you define your origin data. Read the product documentation to understand more about how Edge Applications work, origins, or creating advanced origin setups.

Field Description
Origin Type The following fields refer to the Single Origin type. Because you are creating a new Application, Single Origin is the only option.
After creating and saving a new Application, you can turn Load Balancer on.
Address This field defines the address in which you run your application or origin. Define the origin address of your Application in FQDN (Fully Qualified Domain Name) format. For example origin.azion.com, or an IP address.

By default, Azion will connect to your origin through port 80, for HTTP, or 443, for HTTPS. Suppose you want to configure a different port to connect to your origin. In that case, you can use the host:port notation in this field, for example, origin.azion.com:8080. See the field below to understand options for connecting to your origin

Note: you cannot configure as the origin the same delivery domain used for your content delivery. The origin must have its own address.
Origin Protocol Policy The Origin Protocol Policy defines how Azion will connect to the origin. If you choose to preserve protocol, Azion will use the same when connecting to the origin. In the reverse proxy architecture adopted by Azion, users connect to the Edge Nodes via HTTP or HTTPS, and you choose how you want Azion to connect to your origin:
Preserve HTTP/HTTPS protocol: it will keep the same connection protocol (HTTP or HTTPS) and ports used by your user when accessing your content on Azion to connect to your origin.

Enforce HTTP: the connection between Azion’s Edge Nodes and your origin will be through HTTP, regardless of the connection protocol (HTTP or HTTPS) and ports used by your user to access Azion’s content. With this new option, you may customize a port to your origin in the Address field different from the default port (80 for HTTP) if you wish.

Enforce HTTPS: the connection between Azion’s Edge Nodes and your origin will be through HTTPS, regardless of the connection protocol (HTTP or HTTPS) and ports used by your user to access Azion’s content. With this new option, you may customize a port to your origin in the Address field different from the default port (443 for HTTPS) if you wish.
Host Header This information is used to define which application should be accessed, enabling the origin server to distinguish among resources while servicing requests for multiple hostnames on a single IP address.
Your origin uses the Host header to identify the virtualhost and locate your content or Application. When setting up an origin in Real-Time Manager, you can customize the value that Azion must send in the Host header.

Use the value ${host} in the Host Header field if your origin is configured to answer to virtualhost for the same domain that its users use to access the content on Azion. This way, you will be instructing Edge Nodes to forward the same Host header that is received from your visitors to their origin.

If necessary, you can fill in a custom value for Host Header to be sent to your origin.
For example, origin.domain.com. You must customize the Host Header if your origin is configured to respond to a virtualhost at a domain different than the one used by its users.

Cache Settings

In this section, you will define the cache options for your content. There are two types of cache:

Field Description
Browser Cache Settings Browser Cache is the cache of your content that is stored in your users’ browsers. You can define the time-to-live (TTL) for each content. Still, you have little autonomy to force the content to expire before the time defined as TTL, in case there is a need to change the content ahead of time.Here, you can choose between honoring or overriding cache settings. That is, the time that content should be kept in the user’s browser cache.

Choose between Honor Origin Cache Headers or Override Cache Settings.

Use Honor Origin Cache Headers option if you want Azion to send your users the same cache control headers Received from your origin.

If you choose to Override Cache Settings, you must enter the TTL in seconds, which is how long content will stay in cache.
CDN Cache Settings Here, you define how your content is kept in cache on Azion’s Edge Nodes. In addition setting the TTL for each type of content, you will be able to perform the Purge operation of the content in real time, whenever there is a need to delete the data stored in the cache.

Use the Honor Origin Cache Headers option if you want Azion to respect the cache control headers received from your origin, for managing the cache on Azion’s Edge Nodes. You can also customize the CDN Cache control by selecting the Override Cache Settings option. In this case, you must define a Maximum TTL, which is the maximum lifetime (in seconds) that the content can be cached in Azion’s Edge Nodes

After defining the previous information, click Save to finish this step.


6. Creating a new Domain associated with your Edge Application

Next, we are going to set up Domains. After creating your Edge Application, you must associate one or more domains for your users to access.

You can access Domains from the homepage or by clicking the left menu indicator. Click Add Domain. Remember to name this configuration.

Enter the following information:

Field Description
Digital Certificate The usual setup is to use Azion’s certificate. If you’d like to add another certificate, head to the menu and look for the Digital Certificates section.

If you selected HTTP & HTTPS during the creation of your Edge Application, you must select the SSL certificate that will be used to encrypt your HTTPS traffic. Azion provides the certificate Azion (SAN) that can be used for the domains below azioncdn.net.

You can also upload your Custom Certificate at any time. Consult the Digital Certificates documents and learn how to do it.
CNAMEs Configure the list of delivery domains (CNAMEs) for your content or application. If necessary, you can use Wildcard Domain (* .yourdomain.com). Example: www.azion.com

List the domains you want to use as a URL for your files by hitting enter.
Thus, you replace the address provided by Azion (for example, 10001.map.azionedge.net) with the listed domains.
In this case, you should register the CNAMEs in your DNS service to redirect any routes of your CNAME to those indicated by Azion.
For example, replace www.example.com with 10001.map.azionedge.net.
CNAME Access Only By default, all Domain configurations are automatically assigned a domain name below azioncdn.net.

By checking this option, you will be configuring the Edge Application to deliver your content or applications only through the domains listed in the CNAME field.
Edge Application Select the Edge Application you want to associate with this delivery domain.

Once you finish the setup, click Save.


7. Linking your application traffic to the Azion Platform

After associating a Domain to your Edge Application, you will see a list of existing settings in your account. For each configuration created, a Domain Name is automatically assigned as *.map.azionedge.net.

You will need this domain to approve the operation of your new configuration. To make your configuration run, you will have to point the domain of your content to the Domain Name assigned to your configuration, through a CNAME type record in your DNS server.

Every Azion Domain has a self-generated Azion CNAME associated with it that will be used as the address for DNS records.

If you’re using a Digital Certificate for your real DNS name, the HTTPS requests to Azion CNAME will return as ‘insecure connection’ due to DNS mismatch.

To get your application running through Azion, follow these steps:

  • Go to your current DNS Server or Service.
  • Set the DNS record value of the application to the Azion CNAME address (this is found in your Domain). It is mandatory to have a CNAME (not A or AAAA) entry so that the Azion network can start delivering dynamic self-balanced IP addresses to the users.
  • Check on Edge Analytics > Real-Time Metrics to confirm the incoming traffic.

If you use a naked domain (http:// mydomain.com) for your application, you also must check for ANAME entry support in your DNS server. Otherwise, you may consider migrating your entire DNS zone to our Intelligent DNS product or talking to our Support.

8. Keeping your account after the trial period/Billing

To avoid interruption of your services after the trial period, follow the steps below:

  1. Access RTM and go to the Billing section of the account menu.
  2. Enter valid credit card information.
  3. Click the Save button to save your billing details.

Every month you will receive an e-mail containing your usage levels and charges to your account during that period. The e-mail contains a PDF with the invoice detailing charges, period, and invoice ID.

You can change the billing contact in the Account Info section of the account menu.


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