Skip to main content

Cyware Orchestrate

Akamai Network List 2.0.0

App Vendor: Akamai

App Category: Network Security

Connector Version: 2.1.0

API Version: 1.0.0

Note

This app is currently released as a beta version.

About App

The Akamai Network List app allows security teams to manage shared lists of IP addresses, CIDR blocks, and geographic areas for Akamai security products. It supports fast activation, dynamic updates, and integration with custom blocklists to streamline threat response and enhance security configurations.

The Akamai Network List app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Activate Network List

This action activates a network list.

Add an Element

This action adds an element to a network list.

Create a Network List

This action creates a network list.

Delete a Network List

This action deletes a network list.

Delete an Element

This action deletes an element from a network list.

Get Activation Status

This action retrieves the activation status of the specified network list.

Get a Network List

This action retrieves a network list.

List Network Lists

This action retrieves all network lists you can access as an authenticated group member.

Subscribe Network Lists

This action subscribes to network lists.

Update the Network List

This action updates the network list.

Generic Action

This is a generic action used to make requests to any Akamai Network List API endpoint.

Configuration Parameters

The following configuration parameters are required for the Akamai Network List app to communicate with the Akamai Network List enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Base URL

Enter the base URL to access the Akamai Network List app.

Example:

https://akaa-w.luna.akamaiapis.net

Text

Required

EdgeGrid Client Token

Enter the EdgeGrid client token to connect to the Akamai Network List app.

Example:

csxxefd

Password

Required

EdgeGrid Client Secret

Enter the EdgeGrid client secret to authenticate to the Akamai Network List app.

Example:

abcdEdghwsdksxx5CPUxlEfQeTDkfh4QA=I

Password

Required

Edgegrid Access Token

Enter the EdgeGrid access token to access Akamai Network List APIs.

Example:

akaa-xxxxxxxxxxxxxxx

Password

Required

Verify

Choose your preference to verify SSL or TLS while making requests. It is recommended to set this option to yes. Passing no may result in incorrectly establishing the connection.

Boolean

Optional

By default, verification is enabled.

Timeout

Enter the timeout value in seconds. This is the number of seconds that requests will wait to establish a connection with Akamai Network List.

Integer

Optional

Allowed range:

15-120

Default value:

15

Action: Activate Network List

This action activates a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Env ID

Enter the Akamai network on which a network list must be activated.

Example:

STAGING

Text

Required

Allowed values:

STAGING, PRODUCTION

Network List ID

Enter the unique network list ID.

Example:

12345_blackliststag

Text

Required

You can retrieve the network list ID using the action List Network Lists.

Comments

Enter a comment for activating a network list.

Example:

activate users on staging

Text

Optional

Notification Recipients

Enter the list of email addresses of control center users who receive an email when activation of a network list is complete.

Example:

$LIST[securityteam@examplecom, testuser@sampledomain.com]

List

Optional

Siebel Ticket ID

Enter the Siebel ticket ID.

Text

Optional

Action: Add an Element

This action adds an element to a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID

Enter the unique network list ID.

Example:

12345_blackliststag

Text

Required

You can retrieve the Network List ID using the action List Network Lists.

Element

Enter an element (IP address or domain) to add to the network list.

Example:

1.1.1.1

Text

Required

Action: Create a Network List

This action creates a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

List Name

Enter a name for the network list.

Example:

Sample Network List

Text

Required

Description

Enter the description of the list.

Example:

This is a sample description

Text

Optional

Network List Type

Enter the network list type.

Example:

IP

Text

Required

Allowed values:

IP, GEO

List Items

Enter the list of IPs or domains.

Example:

$LIST[sampledomain1.com, sampledomain2.com].

List

Required

Action: Delete a Network List

This action deletes a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID

Enter the network list ID to delete.

Example:

12345_blackliststag

Text

Required

You can retrieve the network list ID using the action List Network Lists.

Action: Delete an Element

This action deletes an element from a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID

Enter the network list ID.

Example:

12345_BlacklistStag

Text

Required

You can retrieve the Network List ID using the action List Network Lists.

Element

Enter an element (IP address or domain) that you need to delete from a network list.

Example:

1.1.1.1

Text

Required

Action: Get Activation Status

This action retrieves the activation status of the specified network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID

Enter the ID of the network list.

Example:

12345_ALLOWEDGEOS

Text

Required

You can retrieve the network list ID using the action List Network Lists.

Environment

Enter the environment on which the network list is activated.

Text

Required

Allowed values:

STAGING, PRODUCTION

Action: Get a Network List

This action retrieves a network list.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID

Enter the network list ID.

Example:

"12345_blackliststag"

Text

Required

You can retrieve the network list ID using the action List Network Lists.

Extended

Choose true to extend the retrieved network list.

Example:

false

Boolean

Optional

Default value:

false

When set to true, additional details of network list such as creation, updation, and deployment status is provided.

Include Elements

Choose true to include all elements in the retrieved response.

Example:

false

Boolean

Optional

Default value:

true

Allowed values:

If set to true, then the response includes all elements.

Action: List Network Lists

This action retrieves all network lists you can access as an authenticated group member.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Search

Enter the query to filter response by list names and items.

Example:

192.168

Text

Optional

List Type

Enter the network list type to filter the response.

Example:

IP

Text

Optional

Allowed values:

IP, GEO

Extended

Choose true to include extended details such as the creator, last updater, timestamps, and deployment status of the network list.

Boolean

Optional

Default value:

false

Include Elements

Choose true to include all the list items in the response.

Boolean

Optional

Default value:

false

Action: Subscribe Network Lists

This action subscribes to network lists.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Recipients

Enter the recipients.

Example:

it-team@example.com

Text

Required

Unique ID

Enter the unique ID of the network list.

Example:

12345_blackliststag

Text

Required

You can retrieve the unique ID using the action List Network Lists.

Action: Update the Network List

This action updates the network list.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Network List ID 

Enter the network list ID.

Example:

12345_blacklist

Text

Required

You can retrieve the network list ID using the action List Network Lists.

Extended 

Choose true to extend the network list.

Example:

false

Boolean

Optional

Default value:

false

If set to true, then the additional details of the network list such as creation, updation, and deployment status are provided.

Include Elements 

Choose true to include all elements in the retrieved response.

Example:

false

Boolean

Optional

Default value:

true

If set to true, then the response includes all elements.

Name 

Enter the updated name for the network list.

Example:

Network List

Text

Required

List Type 

Enter the list type as IP or domain.

Example:

IP

Text

Required

Allowed values:

IP, GEO

Description 

Enter the description.

Example:

This is a description for updating a network list.

Text

Required

Syncpoint 

Enter the sync point value. It identifies the version of the network list that increments each time on modification.

Example:

5

Integer

Optional

You can retrieve a value of syncPoint from the response of the Get a Network List action.

List Items 

Enter the list of items (IP addresses or domains) to add to the network list.

Example:

$LIST["1.1.1.1", "2.2.2.2"].

List

Required

Action: Generic Action

This is a generic action used to make requests to any Akamai Network List API endpoint.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Method

Enter the HTTP method to make the request.

Text

Required

Allowed values:

GET, PUT, POST, DELETE

Endpoint

Enter the endpoint to make the request to.

Example:

notifications/subscribe

Text

Required

Query Params

Enter the query parameters to pass to the API.

Example:

{element: first_element}

Key value

Optional

Payload

Enter the payload to pass to the API.

Example:

$JSON{recipients: recipients,uniqueIds: unique_ids}

Any

Optional

Extra Fields

Enter the extra fields to pass to the API.

Key_value

Optional

Allowed keys:

payload_json, download, files, filename, retry_wait, retry_count, custom_output, response_type