Akamai Client List - Append, Delete, and Update entries in a list

Akamai Client List - Append, Delete, and Update entries in a list appends, deletes, and updates client list entries in Akamai for:

• Assets returned by the selected query or assets selected on the relevant asset page.

Required Fields

These fields must be configured to run the Enforcement Action.

• Host Name or IP Address - The hostname or IP address of the Akamai client list API server that Axonius can communicate with via the Required Ports.

• Client Token, Client Secret, and Access Token - The credentials for a user account that has the Required Permissions to edit client list entries. To create a Client Token, Client Secret, and Access Token, refer to Create an API client with custom permissions (EdgeGrid).

• Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

Asset Main Configuration

These fields must be configured to run the Enforcement Action. (Entry Type is only required for the append action.)

• List ID - The ID of the Akamai client list whose entries are to be managed.

• Action to Perform - The action to be performed on the Akamai client list entries:

  • append - Append entries to the client list.
  • delete - Delete entries from the client list.
  • update - Update entries in the client list.

• Map Axonius fields to Akamai client list entry fields - Use the Field Mapping Wizard to map Axonius fields to fields in the Akamai client list platform. In this way you can transfer data found in Axonius into the Akamai client list platform. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily. For details, see Axonius to External Field Mapping. The following Akamai client list entry fields can be mapped to Axonius fields:

  • value - Required for all action types. This is the identifier of the client list entry. It can be one of the following: IP address, Autonomous System Number (ASN), Geo location, TLS fingerprint, or file hash. It has a string length between 1 and 255 characters.
  • description - An additional description of the client list entry, up to 255 characters.
  • expirationDate - An ISO 8601 timestamp indicating when the entry expires.
  • tags - Any defined tags for a specified client list.

• Entry Type - Required for the append action. Specifies the entry type in the Akamai client list. Available entry types: IP, GEO, ASN, TLS_FINGERPRINT, FILE_HASH, USER.

Additional Fields

These fields are optional.

• Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

• HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

• HTTPS Proxy User Name (optional) - The user name to use when connecting to the server using the HTTPS Proxy.

• HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

• Gateway Name - Select the Gateway through which to connect to perform the action.

APIs

Axonius uses the Akamai Client Lists API, specifically the section on:

• Update client list entries - Append, delete, and update entries in a single batch.

Required Ports

Axonius must be able to communicate with the Akamai client list API server via the following ports:

• 80/443

Required Permissions

• READ-WRITE access to the 'Client Lists' (also known as 'Network Lists') service. Configure these permissions as follows:

  1. In the Akamai Control Center, navigate to Identity & Access > API Clients.
  2. Select your client.
  3. Select APIs.
  4. Find Network Lists (sometimes labeled Client Lists).
  5. Set to READ‑WRITE.