Getting Started

Akamai

Create an Akamai stream, send it to Honeylog, and verify request delivery.

Use this guide when Akamai serves the website. You will create a DataStream 2 stream that sends the website request data needed by Honeylog.

#Before you open Akamai

Sign in to the Akamai account that manages this website. You need access to Property Manager and Common Services > DataStream, with permission to create a stream and activate a property version. If any of these options are unavailable, send this guide and the private Honeylog installation page to your Akamai administrator.

#Step 1: Open the site property

  1. Open Akamai Control Center.
  2. Go to Properties or Property Manager.
  3. Select the active property that serves this website.
  4. Confirm that the website domain appears in the property and that the property is active.

Continue only when you are working on the property that serves the website connected to Honeylog.

#Step 2: Create the DataStream 2 stream

  1. Open Common Services, then DataStream.
  2. Click Create stream and choose Delivery products.
  3. Select the group, contract, and active property for this website.
  4. Use the faster or low-latency delivery profile.
  5. Keep sampling at 100%.
  6. Use DataStream-managed mode when Akamai offers it. Use Property Manager-dependent only if the Akamai team needs rule-level traffic selection.

Before continuing, confirm that the new stream is linked to the correct active property and uses 100% sampling.

#Step 3: Select data fields

Select every field listed below. Copying the complete list prevents missing information that Honeylog needs to recognize visits correctly.

Do not select Cookie. Leave Query string unselected unless your Akamai administrator has specifically asked you to include it.

Data fields:

Log information: CP code, Request ID, Request time, Stream ID
Message exchange: Bytes, Client IP, HTTP status codes, Protocol type, Request host, Request method, Request path, Response Content-Length, Response Content-Type, User-Agent
Network performance: Error code, Request end time, Turnaround time, Transfer time
Request headers: Accept-Language, Referer
Cache: Cache status
Geo: Edge IP, Server country/region

Before continuing, compare the selected fields with this list and confirm that none are missing.

#Step 4: Require request headers in Property Manager

Before activating the stream, make sure the property logs the request details Honeylog needs:

  1. Open the active property in Property Manager.
  2. Edit a new version.
  3. Add or open the Log Request Details behavior.
  4. Enable logging for Referer.
  5. Enable logging for Accept-Language.
  6. Enable logging for Edge Server IP.
  7. Save and activate the new property version.

If the stream is Property Manager-dependent, also add the DataStream behavior to the same rule, select DataStream2, enable it, choose the Honeylog stream, and keep sampling at 100%. Skip this extra DataStream behavior when the stream is DataStream-managed.

Continue only after Akamai shows that the new property version is active.

#Step 5: Configure the Custom HTTPS destination

  1. Choose Custom HTTPS as the destination.
  2. Paste the generated Honeylog values into the matching fields.
  3. Use Akamai native Basic authentication.
  4. Do not create a custom Authorization header.
  5. Select JSON as the log format.
  6. Choose 30 seconds as the push frequency.

Destination values:

Destination: Custom HTTPS
Endpoint URL: https://api.honeylog.io/akamai/events/SITE_DOMAIN
Authentication: Basic
Username: honeylog
Password: SITE_TOKEN
Format: JSON
Content type: application/json
Push frequency: 30 seconds
Compression: Disabled for first activation

Use the personalized endpoint and password from Settings > Installation > Akamai in Honeylog. Do not use SITE_DOMAIN or SITE_TOKEN literally. Save the destination and continue only when Akamai accepts its validation.

#Step 6: Validate and verify

  1. Open a few public pages through the website domain served by Akamai.
  2. Wait for Akamai to deliver the first log batch, then open Honeylog and look for the new visits.
  3. If the visits appear, the installation is complete.
  4. If they do not appear, open the first records in DataStream and confirm they contain User-Agent, Referer, Accept-Language, Request host, Request path, Client IP, and Edge IP.
  5. Send any validation or delivery error to your Akamai administrator or Honeylog support.

DataStream is not available on every Akamai account. A Linode or Akamai Cloud account alone is not enough; the account must include Akamai Control Center access with DataStream 2 enabled.