Cloudlets Quick Reference
Edge Redirector Cloudlet
Edge Redirector is an Akamai Cloudlet, a value-added application which complements Akamai’s core delivery solutions to solve specific business challenges. Cloudlets bring a site's business logic
closer to the end user by placing it on the “edge” of the content delivery platform.
Edge Redirector is designed to help IT and marketing users more efficiently manage large numbers of redirects. By executing redirects at the Akamai Edge, a customer can reduce round trips to the
origin and offload hits from their origin infrastructure. Also, an easy-to-use user interface and an OPEN API provide self-service capabilities for both your marketing and technical staff.
Edge Redirector provides:
• Quick Time To Market: Marketing users can add or change redirects, which can get the campaign up and running faster.
• Additional Origin Offload: Redirects are executed at Akamai edge servers, which are closer to the end user. Doing this reduces hits to the origin, and provides scalability for the campaign.
• Advanced Rule Setting: You can configure redirect rules with custom start and end dates as well as geographical criteria to ensure the right content gets to the right audience.
• Multiple User Roles: You can define roles for specific hostnames, which ensures that your employees can add/change rules for their own content without impacting the campaign.
How Edge Redirector Works
The diagram on the right shows how Edge Redirector works.
Traditionally, a redirect request would have to travel to your origin in order to retrieve Without
the new URL. Edge
For web properties delivered using Akamai, Edge Redirector eliminates the need to send Redirector
a redirect request to the origin: the redirect is handled completely at the Akamai edge,
saving a round-trip to the origin and any resulting hits against your infrastructure.
Edge Redirector Configuration Overview With
Once Edge Redirector is added to your contract, you have to complete these tasks:
Edge
1. In the Cloudlets Policy Manager, configure an Edge Redirector policy and rules, Redirector
then activate the policy version. (See the Cloudlets Quick Reference for activation
information.)
Note: For Edge Redirector, you can also upload rules contained in a CSV file.
2. In Property Manager, select the appropriate property, set up the Edge Redirector
behavior, and then activate the property.
Creating a Policy for Edge Redirector
1. From the Luna Control Center, select ConfigureCloudletsCloudlets Policy Manager.
2. On the Cloudlet Policies page, select Create New Policy.
3. On the Create Policy page, complete the following fields:
Field Entry
Cloudlet Type Select Edge Redirector.
Policy Name Enter the name of the policy.
Notes Enter a meaningful description for this policy.
4. Click Create Policy. The Policy Details page displays for new policy.
© Copyright 2016 Akamai Technologies, Inc. All Rights Reserved. Akamai Confidential. For Use Under NDA Only. Luna Control Center™ for customers and resellers: [Link]
Configuring Rules for Edge Redirector
1. From the Luna Control Center, select ConfigureCloudletsCloudlets Policy Manager.
2. On the Cloudlet Policies page, click the name of the policy you want to add a rule to.
3. On the Policy Details page, click the number of the policy version you are adding rules to.
4. On the Version Details page, select Add Rule.
5. If you have administrator privileges and want to add match criteria for this rule, click Show Advanced View.
6. On the Create a Rule page, complete the fields you have access to based on your permission level:
Field Name/Type Entry
Basic Criteria
Rule Name Enter a name for this rule. Rules are enabled by default.
Always On Select if the rule is always applied. If deselected, start and end date fields display.
Start Date/Time If the rule is for a fixed time, enter the start date and time.
End Date/Time If the rule is for a fixed time, enter the end date and time.
Source URL Enter the URL that you are redirecting.
Redirect URL Enter the URL you are redirecting the source URL to.
Redirect Type Select the type of redirect to use, either permanent or temporary.
Copy Query String Select to include all query parameters from the source URL to the redirect URL.
Relative Redirect If using relative redirects, you can create either an absolute or a relative path.
Options To create an absolute path, select the Copy Protocol And Hostname option. To
create a relative path, select the Use Relative Redirects option.
Advanced Criteria
Match Type Select the type of match to use for this redirect rule.
Operator Select whether to use positive match criteria or negative match criteria.
Match Criteria Enter the match criteria for this redirect rule.
Case Sensitive Select if the match criteria is case sensitive.
7. Click Save Rule when all your changes are complete, then click Save Changes on the Version Details page.
Enabling Edge Redirector in Property Manager
1. From the Luna Control Center, select ConfigureManage Properties (under Property Manager).
2. Navigate to the property you will be adding Edge Redirector to.
3. Open the version of the property configuration, then select the rule you want to add Edge Redirector to.
4. Click Add Behavior, then select Edge Redirector.
5. Set Enable to On and select the appropriate policy in the Policy Name field.
6. Save your changes to the rule, then activate the newly-updated property.
Using Regular Expressions with Edge Redirector
If you are using Advanced Criteria, you can use regular expressions (regex) to match on the fully qualified incoming request URL, and use regex capture groups to form the redirect URL.
The regex can be up to 256 characters to match on the inbound URL, excluding the port. Substitution patterns use the back slash character (“\”) followed by a number to refer to the capture groups.
For example, \1 is the first capture group, \2 is the second, etc.
Note: Cloudlets supports the RE2 regex library. See [Link] or a similar site, for more information.
If you want to set up a regex that appends the incoming path and query string to the domain [Link] you might set the Regular Expression field to [Link] and the
Redirect URL field to [Link] When this rule is activated, if the incoming URL is [Link] it will be redirected to [Link]
[Link]. However, [Link] is not redirected: HTTPS and the number in the host name do not match.
© 2016 Akamai Technologies, Inc. All Rights Reserved. Reproduction in whole or in part in any form or medium without express written permission is prohibited. Akamai and the Akamai wave logo are registered trademarks or
service marks in the United States (Reg. U.S. Pat. & Tm. Off). Akamai Intelligent Platform is a trademark in the United States. All other trademarks contained herein are the property of their respective owners. Akamai believes
that the information in this publication is accurate as of its publication date; such information is subject to change without notice. Published 01/16