EdgeWorkers enables concurrent development on Akamai configurations by: - Allowing edge logic to be expressed through JavaScript functions that can control request and response behavior - Providing APIs to access properties of requests, responses, devices and user locations - Supporting the ability for each part of a site to have its own EdgeWorker that is independently updated

1. © AKAMAI - EDGE 2017
Akamai Ideas : EdgeWorkers
Configs as Code: Enabling concurrent development in a developer friendly syntax

2. © AKAMAI - EDGE 2017
Akamai fits into your DevOps pipeline
PAPI
Akamai Configs as Code
AKAMAI CLI
Simplified API wrappers
FASTER
ACTIVATIONS
DATASTREAM
Real time summarized stats and logs
CUSTOM BEHAVIORS
Reusable custom logic
mPULSE
Real Time Business
Insights
TERRAFORM
PROVIDER
CLOUDTEST
Early continuous load testing
FAST PURGE
Invalidate content in seconds
APIs FOR
EVERYTHING
AKAMAI CLI
CLOUDLETS, ESI , Varnish
Plugin
Smart Logic at the Edge
FAST FALLBACK
Iterate rapidly
SIEM INTEGRATION
Security Insights
EARLY VALIDATION

3. © AKAMAI - EDGE 2017
to plugin Akamai
into my other tools
my changes &
purges to take
effect immediately
to automate
making the same
change across
100 configs
to unblock self-
serviceability
currently blocked
by advanced
behaviors
my team’s site
health dashboard
to include Akamai
info
to program Edge
behavior with
JavaScript
to test my
development
stream with
Akamai
to automate every
action I take in the
Akamai portal
to control Edge
behavior for my
part of the site
independently
from others
to automate tests
against Akamai
diagnostic info
As a DevOps user, I want .. 2017 & Beyond
to automate
propagating
changes between
different
environments
Pipeline
Projects
Quick Reactions
& Speed
My Developers
to be
empowered
Automation

4. © AKAMAI - EDGE 2017
to program Edge
behavior such as
redirects with JavaScript
to control Edge behavior
for my part of the site
independently from other
teams
As a DevOps user, I want ..
My Developers
to be
empowered
to test my development
stream with Akamai

5. © AKAMAI - EDGE 2017

6. © AKAMAI - EDGE 2017
One Site,
One config,
Multiple teams

7. © AKAMAI - EDGE 2017
One Site,
One config,
Multiple teams

8. © AKAMAI - EDGE 2017
How Edge
Logic is
expressed
today:
Propery
Manager

9. © AKAMAI - EDGE 2017
How Edge
Logic is
expressed
today:
Propery
Manager

10. © AKAMAI - EDGE 2017
How Edge
Logic is
expressed
today:
Portal API

11. © AKAMAI - EDGE 2017
How Edge
Logic is
expressed
today:
Portal API

12. © AKAMAI - EDGE 2017
<esi:choose>
<esi:when test="$(GEO{'country_code'}) == 'FR'">
$set_redirect('/fr/')
</esi:when>
<esi:when test="$(GEO{'country_code'}) == 'DE'">
$set_redirect('/de/')
</esi:when>
</esi:choose>
How Edge
Logic is
expressed
today:
Edge Side
Includes

13. © AKAMAI - EDGE 2017
<match:request.type value="CLIENT_REQ">
<match:client.edgescape2 value="FR DE" field="COUNTRY_CODE"
result="true" use-headers="all" check-ips="both">
<assign:variable>
<name>PM_4</name>
<value>t</value>
<hidden>on</hidden>
</assign:variable>
</match:client.edgescape2>
</match:request.type>
<match:variable name="PM_4" value="t" result="true">
<comment:note value="Start Feature setVariable"/>
<assign:extract-value>
<location>Edgescape</location>
<location-id>country_code</location-id>
<location-id-prefix-match>off</location-id-prefix-match>
<variable-name>PMUSER_LCASE_COUNTRY</variable-name>
<hidden>off</hidden>
<sensitive>off</sensitive>
</assign:extract-value>
<assign:variable>
<name>PMUSER_LCASE_COUNTRY</name>
<value>%(PMUSER_LCASE_COUNTRY)</value>
<hidden>off</hidden>
<sensitive>off</sensitive>
<transform>
<lower/>
</transform>
</assign:variable>
<comment:note value="End Feature setVariable"/>
<comment:note value="Start Feature redirect"/>
How Edge
Logic is
expressed
today:
Advanced
Metadata
and
Custom
Behaviors

14. © AKAMAI - EDGE 2017
<match:request.type value="CLIENT_REQ">
<match:client.edgescape2 value="FR DE" field="COUNTRY_CODE"
result="true" use-headers="all" check-ips="both">
<assign:variable>
<name>PM_4</name>
<value>t</value>
<hidden>on</hidden>
</assign:variable>
</match:client.edgescape2>
</match:request.type>
<match:variable name="PM_4" value="t" result="true">
<comment:note value="Start Feature setVariable"/>
<assign:extract-value>
<location>Edgescape</location>
<location-id>country_code</location-id>
<location-id-prefix-match>off</location-id-prefix-match>
<variable-name>PMUSER_LCASE_COUNTRY</variable-name>
<hidden>off</hidden>
<sensitive>off</sensitive>
</assign:extract-value>
<assign:variable>
<name>PMUSER_LCASE_COUNTRY</name>
<value>%(PMUSER_LCASE_COUNTRY)</value>
<hidden>off</hidden>
<sensitive>off</sensitive>
<transform>
<lower/>
</transform>
</assign:variable>
<comment:note value="End Feature setVariable"/>
<comment:note value="Start Feature redirect"/>
<edgeservices:redirect.generate.evict-cached-object>off</edgeservices:redirect.generate.evict-cached-object>
<match:variable name="AK_QUERY" result="false">
<edgeservices:redirect.generate.rule name="pm_redirect">
<response-code>302</response-code>
<select-prefix>/</select-prefix>
<status>on</status>
<destination>=%(AK_SCHEME)://%(AK_HOSTHEADER)https://www.example.com/%(PMUSER_LCASE_COUNTRY)</destination>
</edgeservices:redirect.generate.rule>
</match:variable>
<match:variable name="AK_QUERY">
<edgeservices:redirect.generate.rule name="pm_redirect">
<response-code>302</response-code>
<select-prefix>/</select-prefix>
<status>on</status>
<destination>=%(AK_SCHEME)://%(AK_HOSTHEADER)https://www.example.com/%(PMUSER_LCASE_COUNTRY)?%(AK_QUERY)</destination>
</edgeservices:redirect.generate.rule>
</match:variable>
<comment:note value="End Feature redirect"/>
</match:variable>
<comment:note value="end rule: f2a73abf-19b4-4470-bba1-6d7a8cc5715d"/>
<comment:note value="end rule: default"/>
</match:uri.component>
How Edge
Logic is
expressed
today:
Advanced
Metadata
and
Custom
Behaviors

15. © AKAMAI - EDGE 2017
Summary: How Edge Logic is expressed today
Property
Manager
PAPI Advanced
Metadata
ESI EdgeWorkers
Can configure all capabilities of the service ✅ ✅ ✅
Can update using automation ✅ ✅ ✅
Can have multiple per site ✅ ✅ ✅
Offers power of a full programming language ✅ ✅
Offers a syntax and programming model that
developers love
✅

16. © AKAMAI - EDGE 2017
Inspiration
from
Browsers:
Service
Workers

17. © AKAMAI - EDGE 2017
Service Worker Code To Handle Redirect
self.addEventListener('fetch', function(event) {
if (/EN/.test(event.request.url)) {
fetchEvent.respondWith(new Response('', {
status: 302,
headers: {
'Location': 'https://www.example.com/en'
}
}))
}
});

18. © AKAMAI - EDGE 2017
Each part of the site can have its own Service Worker
navigator.serviceWorker.register('/blog/sw.js', {scope: '/blog/'});
navigator.serviceWorker.register('/catalog/sw.js', {scope: '/catalog/'});

19. © AKAMAI - EDGE 2017
Edge
+
Service Workers
=
EdgeWorkers
Edge + Service Workers = EdgeWorkers

20. © AKAMAI - EDGE 2017
function onClientRequest(request, response) {
var country = request.userLocation.country;
if (/EN|FR/.test(country)) {
response.status = 302;
response.headers['Location'] =
'https://www.example.com/'
+ country.toLowerCase());
}
}
EdgeWorker Example:
Redirect based on user location

21. © AKAMAI - EDGE 2017
function onClientRequest(request, response) {
if (request.headers['X-Language']) {
request.originServer.hostname = 'origin.example.com';
} else {
request.originServer.hostname = '3rd-party-service.example.com';
}
}
EdgeWorker Example:
Choose Forward Origin Based on the Presence of a Header

22. © AKAMAI - EDGE 2017
function onClientRequest(request, response) {
if (request.device.isMobile) {
request.originServer.hostname = 'origin-mobile.example.com';
} else if (request.device.isTablet) {
request.originServer.hostname = 'origin-tablet.example.com';
} else {
request.originServer.hostname = 'origin-desktop.example.com';
}
}
EdgeWorker Example:
Access to Edge Device Characteristics

23. © AKAMAI - EDGE 2017
function onClientResponse(request, response) {
if (response.status == 403) {
response.headers['Set-Cookie'] =
'MyCookie=; Expires=Thu, 01 Jan 1970 00:00:00 GMT';
}
}
EdgeWorker Example:
Remove a cookie

24. © AKAMAI - EDGE 2017
function onClientRequest(request, response) {
request.maxAge = 604800; // 1 week in seconds
}
EdgeWorker Example:
Set Edge Cacheability

25. © AKAMAI - EDGE 2017
function getQueryParam(query, paramName) {
var params = query.split('&');
for (var i = 0 ; i < params.length ; i++) {
var nameValue = params[i].split('=');
if (nameValue[0] === paramName) {
return nameValue[1];
}
}
return '';
}
function onClientRequest(request, response) {
var city = getQueryParam(request.query, 'city');
request.cacheKey = request.cacheKey + '/' + city;
}
EdgeWorker Example:
Cache Key Modification Incorporating Request Properties

26. © AKAMAI - EDGE 2017
Request
OriginServer
UserLocation
Device
Response
Metadata Variables
EdgeWorkers API Overview
function onClientRequest(request, response){
// do something as the request is received
}
function onClientResponse(request, response){
// do something just before the client response is
sent
}
function onOriginRequest(request, response){
// do something just before sending the forward
request
}
function onOriginResponse(request, response){
// do something as the forward response is received
}
Events Objects

27. © AKAMAI - EDGE 2017
EdgeWorkers augment your Property Manager configuration,
and are updated independently
For requests matching this
pattern
Invoke this EdgeWorker

28. © AKAMAI - EDGE 2017
Summary: How Edge Logic is expressed
Property
Manager
PAPI Advanced
Metadata
ESI EdgeWorkers
Can configure all capabilities of the service ✅ ✅ ✅
Can update using automation ✅ ✅ ✅
Can have multiple per site ✅ ✅ ✅
Offers power of a full programming language ✅ ✅
Offers a syntax and programming model that
developers love
✅

29. © AKAMAI - EDGE 2017
Akamai Developer
Points of
PresenceEnables Agile Testing of Akamai Configurations in a Pre-Staging Environment

30. © AKAMAI - EDGE 2017
When do you test?

31. Enable rapid and local CDN testing
Origin Address
*in this example the
server is hosted locally
Akamai Config
Name
*for the site you want to
test
N/W & Version Selection
*select any version from staging
or production
● Improve dev team efficiency
● No surprises in production
● Test Caching, WAF rules & IM policies
● Faster feedback via instant logs & quicker
deploy times

32. © AKAMAI - EDGE 2017
We want your feedback in helping us design this!
akamaidev.io/edgeworkers
● DevZone DevOps Demo Booth
● Craig @ Web and Mobile Perf Kiosk Thurs 10-12:30pm
● sid@akamai.com
Provide Input / Stay Updated
Find / Contact Us

33. THANK YOU!