#Configure Akamai on Zephyr

We now support Akamai as a cloud provider for Bring Your Own Cloud (BYOC) deployments. Akamai is a cloud platform known for its global content delivery network (CDN), edge computing capabilities, and strong focus on performance and security. Their infrastructure is designed to help organizations build and scale applications closer to end users while maintaining high availability and low latency.

With this integration, you can leverage your existing Akamai infrastructure to run and manage services directly within your own cloud environment, giving you more control, flexibility, and compliance alignment.

#Prerequisites

#Configure and enable Akamai

[default]
client_secret = YOUR_CLIENT_SECRET
host = YOUR_AKAMAI_HOST
access_token = YOUR_ACCESS_TOKEN
client_token = YOUR_CLIENT_TOKEN

#What Will Be Created on Your Akamai Account?

When Akamai is added as your provider on Zephyr, these properties will be created on your Akamai account:

#1. EdgeKV Namespace

• ze-yourdomain-com

#2. EdgeKV access token

• ekv-token-ze-yourdomain-com

#3. Workers

• ze.yourdomain.com (for uploading and serving assets)

#4. Property

• ze.yourdomain.com

#Clean Uninstall and Reset

To delete an existing Akamai integration, follow these steps:

#Deleting property

1. Remove CNAME records which have been added here
2. Click on Properties in the menu
3. Click on your property
4. Click on three ... in the Actions column in the active version line
5. Choose Deactivate Production
6. Wait until property become deactivated
7. Go back to properties list
8. Click on three ... in the Actions column in the your property line
9. Choose Delete Property

#Deleting worker

1. Click on EdgeWorkers in the menu
2. Click on your worker
3. Click on three ... in the Actions column in the active version line
4. Choose Deactivate version
5. Wait until version become deactivated
6. Go back to workers list
7. Click on three ... in the Actions column in the your worker line
8. Choose Delete EdgeWorker ID

#Remove edge hostname

1. Click on Edge Hostnames in the menu
2. Click on three ... in the Actions column in the active version line
3. Choose Delete Edge Hostname

#Remove EdgeKV namespace

Can be done only with Akamai API.

const EdgeGrid = require('akamai-edgegrid');

const { homedir } = require('node:os');
const { promisify } = require('node:util');

const edgercPath = homedir() + '/.edgerc';
const edgercSection = 'default';
const eg = new EdgeGrid({
  path: edgercPath,
  section: edgercSection,
});

const namespaceId = process.env.NAMESPACE;
const network = process.env.NETWORK || 'production'; // staging or production

eg.auth({
  path: `/edgekv/v1/networks/${network}/namespaces/${namespaceId}`,
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: {},
});

const send = promisify(eg.send.bind(eg));
send()
  .then(({ data }) => {
    console.log('Namespace deleting result', data);
  })
  .catch((error) => {
    console.error('Namespace deleting error', error);
    process.exit(1);
  });

#Revoke EdgeKV access token

Can be done with Akamai CLI or Akamai API.

const EdgeGrid = require('akamai-edgegrid');

const { homedir } = require('node:os');
const { promisify } = require('node:util');

const edgercPath = homedir() + '/.edgerc';
const edgercSection = 'default';
const eg = new EdgeGrid({
  path: edgercPath,
  section: edgercSection,
});

const tokenName = process.env.TOKEN_NAME;

eg.auth({
  path: `/edgekv/v1/tokens/${tokenName}`,
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: {},
});

const send = promisify(eg.send.bind(eg));
send()
  .then(({ data }) => {
    console.log('Token revoking result', data);
  })
  .catch((error) => {
    console.error('Token revoking error', error);
    process.exit(1);
  });