Skip to main content

Cyware Orchestrate

Akamai Web Application Firewall (WAF)

App Vendor: Akamai

App Category: Firewall

Connector Version: 1.0.0

API Version: 1.0.0

About App

The Akamai Web Application Firewall (WAF) helps secure your web applications and websites from online threats. Leveraging Akamai’s globally distributed content delivery network (CDN), it delivers reliable, scalable protection while maintaining the performance and availability of your applications.

The Akamai Web Application Firewall (WAF) app is configured with Cyware Orchestrate to perform the following actions:

Action Name

Description

Activate Configuration Version

This action activates the activation configuration for a specific action.

Activate or Deactivate Property

This action activates or deactivates a property.

Add Hostnames

This action adds hostnames to a property's hostname bucket on a specified network.

Cancel Change

This action cancels a pending change.

Clone Configuration Version

This action clones and creates a new version of the specified security configuration.

Clone Property

This action clones an existing property under the specified contract and group.

Create CP Code

This action creates a new CP code and assigns it to a product.

Create Data Center

This action creates a data center within a specific GTM domain.

Create Domain

This action creates a Global Traffic Management (GTM) domain.

Create Edge Hostname

This action creates a new edge hostname.

Create Enrollment

This action creates a new certificate enrollment.

Create Group

This action creates a new group within the specified parent group.

Create Match Target

This action creates a new match target in the specified configuration version.

Create Property Version

This action creates a new version of a specific property.

Get Activation Status

This action retrieves the status of a specific activation.

Get Certificate History

This action retrieves the enrollment certificate history.

Get Change Status

This action retrieves the details of a pending change.

Get Domain Details

This action retrieves the details of a specific GTM domain.

Get Edge Hostname

This action retrieves details of a specific edge hostname.

Get Enrollment

This action retrieves the details of a specific enrollment.

Get Enrollment by Common Name

This action retrieves the enrollment ID using the certificate enrollment common name.

Get Enrollment Deployment

This action retrieves the enrollment deployment details.

Get Group

This action retrieves the details of the specified group.

Get GTM Property

This action gets details of a Global Traffic Management (GTM) property.

Get PAPI Property by Name

This action retrieves a papi property within a group by its name.

Get Pending Change

This action retrieves the detailed information of a pending change.

Get Property Activation

This action retrieves details of a specific property activation.

Get Property Details

This action retrieves the details of a specific property.

Get Property Rule Tree

This action retrieves rules for a specific property version.

Get Zone Record Sets

This action retrieves the DNS record sets for the specified zone.

List Activation History

This action retrieves the activations for a specific configuration.

List CIDR Blocks

This action retrieves the firewall CIDR blocks based on the provided filters.

List Configurations

This action retrieves the list of configurations.

List Domains

This action retrieves the list of GTM domains.

List Enrollments

This action lists the names of each enrollment.

List Groups

This action lists all the groups.

List Hostnames for an Account

This action retrieves the list of active property hostnames for all properties available in an account.

List Match Targets

This action lists match targets for a specific security configuration version.

List Properties

This action lists the properties.

List Property Activations

This action retrieves the activations of a specific property.

List Security Policies

This action retrieves security policies for a specific configuration version.

List Site Shield Maps

This action lists all site shield maps.

List Zones

This action lists all the edge DNS zones.

Modify Match Target

This action updates a match target for a specific configuration version.

Modify Selected Hostnames

This action updates the selected hostnames for a given security policy in a configuration.

Modify Version Notes

This action updates the version notes for a given configuration version.

Patch Property Rule Tree

This action modifies the rule tree for a specific property version.

Update Deployment Schedule

This action updates the deployment schedule for a specific enrollment change.

Update Enrollment

This action updates an enrollment.

Update Pending Change

This action updates a pending change.

Update Property

This action updates a Global Traffic Management (GTM) property.

Generic Action

This is a generic action used to make requests to any Akamai WAF endpoint.

Configuration Parameters

The following configuration parameters are required for the Akamai Web Application Firewall (WAF) app to communicate with the Akamai Web Application Firewall (WAF) 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 Akamai WAF.

Example:

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

Text

Required

EdgeGrid Client Token

Enter the EdgeGrid client token for authentication.

Password

Required

To generate authentication credentials, see Akamai Web Application Firewall documentation.

EdgeGrid Client Secret

Enter the EdgeGrid client secret for authentication.

Password

Required

EdgeGrid Access Token

Enter the EdgeGrid client token for authentication.

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 WAF.

Integer

Optional

Allowed range:

15-120

Default value:

15

Action: Activate Configuration Version

This action activates the activation configuration for a specific action.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Action 

Enter the action to take.

Text

Required

Allowed values:

ACTIVATE, DEACTIVATE

Activation Configs 

Enter the security configuration and version information.

Example:

[{'configId': 1, 'configVersion': 4}]

Any

Required

Allowed keys:

configId, configVersion

Network 

Enter the Akamai activation environment.

Text

Required

Allowed values:

STAGING, PRODUCTION

Note 

Enter a note for the activation.

Example:

Sample activation note

Text

Required

Notification Emails 

Enter the list of email addresses to send notifications on activation.

List

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Additional Fields 

Enter any additional fields to pass to the API.

Key Value

Optional

Allowed keys:

acknowledgedInvalidHosts, acknowledgedInvalidHostsByConfig

Action: Activate or Deactivate Property

This action activates or deactivates a property.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the unique identifier for the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Property Version 

Enter the version of the property to activate.

Example:

1

Integer

Required

Network 

Enter the network to activate the property.

Example:

STAGING

Text

Required

Allowed values:

STAGING, PRODUCTION

Notify Emails 

Enter the list of email addresses to notify when the activation status changes.

Example:

["johndoe@orgname.com", "janedoe@orgname.com"]

List

Required

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Note 

Enter a descriptive log comment.

Example:

sample activation

Text

Optional

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

contractId, groupId, accountSwitchKey

Additional Fields 

Enter the additional fields to make the request.

Key Value

Optional

Allowed keys:

acknowledgeAllWarnings, acknowledgeWarnings, activationType, delayValidations, fastPush, ignoreHttpErrors, useFastFallback

Action: Add Hostnames

This action adds hostnames to a property's hostname bucket on a specified network.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the unique identifier of the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Network 

Enter the network to activate the hostnames on.

Text

Required

Allowed values:

STAGING, PRODUCTION

Contract ID 

Enter the unique identifier of the contract. This parameter is optional if the property belongs to a single contract.

Example:

ctr_K-0N7RAK71

Text

Optional

Group ID 

Enter the unique identifier of the group. This parameter is optional if the property belongs to a single group.

Example:

grp_54321

Text

Optional

You can retrieve the group ID using the action List Groups.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Add 

Enter the list of objects representing the hostnames to add. Each object should include certProvisioningType, cnameFrom, cnameType, and edgeHostnameId.

Example:

[{"certProvisioningType": "default", "cnameFrom": "example.com", "cnameType": "edge_hostname", "edgeHostnameId": "ehn_12345"}]

List

Optional

Note 

Enter a note to add hostnames.

Example:

sample hostname activation

Text

Optional

Notify Emails 

Enter the list of email addresses to notify about activation status.

List

Optional

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Additional Fields 

Enter the additional fields to make the request.

Key Value

Optional

Allowed key:

remove

Action: Cancel Change

This action cancels a pending change.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment on which you want to perform this action.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Change ID 

Enter the ID of the change to cancel.

Example:

10000

Text

Required

You can retrieve the change ID using the action List Enrollments.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Clone Configuration Version

This action clones and creates a new version of the specified security configuration.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Rule Update 

Choose true to update the rules to the latest version.

Boolean

Required

Create from Version 

Enter the version of the configuration to clone from.

Example:

1

Integer

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Clone Property

This action clones an existing property under the specified contract and group.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the unique identifier of the contract.

Example:

ctr_K-0N7RAK71

Text

Required

Group ID 

Enter the unique identifier of the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

Product ID 

Enter the product ID of the property to clone.

Example:

prd_Alta

Text

Required

Property Name 

Enter a unique and descriptive name for the cloned property.

Example:

my.new.property1.com

Text

Required

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Rule Format 

Enter the rule format to assign to the property.

Example:

v2018-09-12

Text

Optional

Default value:

None

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Additional Fields 

Enter the additional fields to make the request.

Key Value

Optional

Allowed keys:

cloneFrom, useHostnameBucket

Action: Create CP Code

This action creates a new CP code and assigns it to a product.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_K-0N7RAK71

Text

Required

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

CP Code Name 

Enter the descriptive label for the CP code.

Example:

SME WAA

Text

Required

Note

You cannot include commas, underscores, quotes, or special characters (^, #, %) in the name.

Product ID 

Enter the product ID.

Example:

prd_Web_App_Accel

Text

Required

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Create Data Center

This action creates a data center within a specific GTM domain.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Domain Name 

Enter the name of the domain where the data center will be created.

Example:

example.akadns.net

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

City 

Enter the city where the data center is located.

Example:

Doune

Text

Optional

Clone of 

Enter the ID of the source data center from which this data center is cloned. This data center inherits geographic attributes from its source, including continent, country, state, city, latitude, and longitude.

Integer

Optional

Default value is 0, indicating no cloning.

Country 

Enter the two-letter ISO 3166 country code for the country associated with the data center.

Example:

GB

Text

Optional

Default Load Object 

Enter the load reporting interface information.

Any

Optional

Allowed keys:

loadObject, loadObjectPort, loadServers

Additional Fields 

Enter the additional fields to make the request.

Key Value

Optional

Allowed keys:

latitude, longitude, links, cloudServerTargeting, continent, nickname, stateOrProvince

Action: Create Domain

This action creates a Global Traffic Management (GTM) domain.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

CIDR Maps 

Enter the CIDR map information to be assigned to the domain.

Any

Required

Allowed keys:

assignments, defaultDatacenter, links, name

Data Centers 

Enter the information about the set of data centers assigned to this domain.

Any

Required

Allowed keys:

city, country, continent, cloneOf, cloudServerTargeting, defaultLoadObject, latitude, links, longitude, nickname, stateOrProvince

Default Error Penalty 

Enter the download penalty score.

Integer

Required

Default SSL Client Certificate 

Enter the Base64-encoded certificate for TLS-based liveness tests.

Text

Required

Default SSL Client Private Key 

Enter the Base64-encoded private key for TLS-based liveness tests.

Password

Required

Default Timeout Penalty 

Enter the timeout penalty score (in seconds) used to determine the impact of a timed-out download.

Integer

Required

Default value:

25

Email Notification List 

Enter the list of email addresses to notify when a change is made to the domain.

List

Required

Geographic Maps 

Enter details about the geographic map set assigned to this domain.

Any

Required

Allowed keys:

assignments, defaultDatacenter, links, name

Load Feedback 

Choose true to indicate that load feedback is being used to manage load balancing, which controls the traffic load based on the data center's capacity.

Boolean

Required

Load Imbalance Percentage 

Enter the percentage of the Load Imbalance Factor (LIF) for the domain.

Float

Required

Allowed range:

0 - 1000000

Default value:

10

Modification Comments 

Enter a descriptive note about the changes to the domain within 4000 characters.

Text

Required

Name 

Enter the full GTM domain name, ending in .akadns.net within 100 characters.

Example:

example.akadns.net

Text

Required

Properties 

Enter the properties for the GTM domain.

Any

Required

Allowed keys:

backupCname, backuIp, cname, balanceByDownloadScore, comments, dynamicTTL, failbackDelay, failoverDelay, handoutMode, healthMax, healthMultiplier, healthThreshold, ipv6, lastModified, links, livenessTests, loadImbalancePercentage, mapName, maxUnreachablePenalty, mxRecords, name, scoreAggregationType, staticTTL, stickinessBonusConstant, stickinessBonusPercentage, trafficTargets, type, unreachableThreshold, useComputedTargets

Type 

Enter the type of domain based on your contract.

Text

Required

Allowed values:

failover-only, static, weighted, basic, full

Resources 

Enter the resources for the GTM domain.

Any

Optional

Allowed keys:

aggregationType, comments, constrainedProperty, decayRate, description, hostHeader, leaderString, leastSquaresDecay, links, loadImbalancePercentage, maxUMultiplicativeIncrement, name, resourceInstances, type, upperBound

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

contractId, gid, accountSwitchKey

Additional Fields 

Enter the additional fields to make the request.

Key Value

Optional

Allowed keys:

link, status

Action: Create Edge Hostname

This action creates a new edge hostname.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Required

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

Domain Prefix 

Enter the origin domain portion of the edge hostname.

Example:

www.example.com

Text

Required

Domain Suffix 

Enter the Akamai-specific portion of the edge hostname.

Example:

edgesuite.net

Text

Required

IP Version Behavior 

Enter the version of the IP protocol to use.

Text

Optional

Allowed values:

IPV4, IPV6_COMPLIANCE

Default value:

IPV4

Product ID 

Enter the ID of the product to create the edge hostname.

Example:

prd_dynamic_site_del

Text

Optional

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Use Cases 

Enter a list of use case objects.

Example:

[{'option': 'background', 'type': 'global', 'usecase': 'download_mode'}]

Any

Optional

Allowed keys:

option, type, useCase

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

options, accountSwitchKey

Action: Create Enrollment

This action creates a new certificate enrollment.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Certificate Type 

Enter the type of the certificate. for example, san

Text

Required

Allowed values:

san, single, wildcard, wildcard-san, third-party

Change Management 

Choose true to prevent the Certificate Provisioning System (CPS) from deploying the certificate to the network until you confirm that you are ready for deployment.

Boolean

Required

CSR 

Enter the Certificate Signing Request (CSR) to create the enrollment.

Any

Required

Allowed keys:

c, cn, l, o, ou, preferredTrustChain, sans, st

Enable Multi Stacked Certificates 

Choose true to enable dual-stacked certificate deployment for this enrollment.

Boolean

Required

Network Configuration 

Enter the network configuration settings for the certificate.

Any

Required

Allowed keys:

clientMutualAuthentication, disallowedTlsVersions, dnsNameSettings, fipsMode, geography, mustHaveCiphers, ocspStapling, preferredCiphers, quicEnabled, secureNetwork, sniOnly

RA 

Enter the registration authority or certificate authority (CA) for the certificate enrollment.

Text

Required

Allowed values:

symantec, lets-encrypt, third-party

Validation Type 

Enter the type of the validation.

Text

Required

Allowed values:

dv, ev, ov, third-party

Contract ID 

Enter the contract ID you want to operate on or view.

Example:

K-0N7RAK7

Text

Required

Query Params 

Enter the query parameters to create enrollment.

Key Value

Optional

Allowed keys:

deploy-not-after, deploy-not-before, accountSwitchKey

Additional Fields 

Enter the additional fields to create enrollment.

Key Value

Optional

Allowed keys:

adminContact, assigneslots, autoRenewalStartTime, certificateChainType, id, location, maxAllowedSanNames, maxAllowedWildcardSanNames, org, orgId, pendingChanges, productionSlots, signatureAlgorithm, stagingSlots, techContact, thirdParty

Action: Create Group

This action creates a new group within the specified parent group.

Note

To use this action, you must have ADMIN access in the Identity Management: User Administration API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Group ID 

Enter the ID of the parent group where you want to create the new group.

Example:

54321

Text

Required

You can retrieve the group ID using the action List Groups.

Group Name 

Enter the name of the new group.

Example:

digital company

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Create Match Target

This action creates a new match target in the specified configuration version.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Security Policy ID 

Enter the security policy ID associated with the match target.

Example:

fwsf_32432

Text

Required

You can retrieve the security policy ID using the action List Security Policies.

Target Type 

Enter the type of the match target.

Example:

website

Text

Required

Allowed values:

website, api

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Additional Fields 

Enter any additional fields to pass to the API.

Key Value

Optional

Allowed keys:

apis, bypassNetworkLists, defaultFile, fileExtensions, filePaths, hostnames, isNegativeFileExtensionMatch, isNegativePathMatch, sequence, targetId, type

Action: Create Property Version

This action creates a new version of a specific property.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the ID of the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Create from Version 

Enter the version number to create the new version from.

Example:

1

Integer

Required

Contract ID 

Enter the contract ID for the property.

Text

Optional

Group ID 

Enter the group ID for the property.

Text

Optional

You can retrieve the group ID using the action List Groups.

Create from Version Etag 

Enter the etag for the version to create the new version from.

Example:

2641910c585cf67b

Text

Optional

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Activation Status

This action retrieves the status of a specific activation.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Activation ID 

Enter the ID of the activation.

Example:

1234

Text

Required

You can retrieve the activation ID using the action List Activation History.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Certificate History

This action retrieves the enrollment certificate history.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment for which you want to retrieve the history details.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Include All 

Choose true to include all changes or certificates in the response.

Boolean

Optional

Default value:

false

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Change Status

This action retrieves the details of a pending change.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment associated with the change.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Change ID 

Enter the ID of the change associated with the enrollment.

Example:

10000

Text

Required

You can retrieve the change ID using the action List Enrollments.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Domain Details

This action retrieves the details of a specific GTM domain.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Domain Name 

Enter the name of the domain to retrieve details for.

Example:

example.akadns.net

Text

Required

You can retrieve the domain name using the action List Domains.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Edge Hostname

This action retrieves details of a specific edge hostname.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Edge Hostname ID 

Enter the unique identifier for the edge hostname.

Example:

ehn_887436

Text

Required

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Required

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

Options 

Enter any additional options for the request.

Text

Optional

Allowed value:

mapDetails

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Action: Get Enrollment

This action retrieves the details of a specific enrollment.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment to retrieve its details.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Enrollment by Common Name

This action retrieves the enrollment ID using the certificate enrollment common name.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the ID of the contract on which you want to view enrollment.

Example:

K-0N7RAK7

Text

Required

Common Name 

Enter the common name of the certificate enrollment.

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Enrollment Deployment

This action retrieves the enrollment deployment details.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment for which you want to retrieve deployment details.

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Environment 

Enter the environment where the certificate is deployed.

Text

Required

Allowed values:

PRODUCTION, STAGING

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Group

This action retrieves the details of the specified group.

Note

To use this action, you must have ADMIN access in the Identity Management: User Administration API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Group ID 

Enter the ID of the user group.

Example:

54321

Text

Required

You can retrieve the group ID using the action List Groups.

Actions 

Choose true to include information about actions in the response.

Boolean

Optional

Default value:

false

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get GTM Property

This action gets details of a global traffic management (GTM) property.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Domain Name 

Enter the GTM domain name.

Example:

example.akadns.net

Text

Required

You can retrieve the domain name using the action List Domains.

Property Name 

Enter the unique name of the property. This forms a valid RFC 1123 hostname when joined with the domain name.

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get PAPI Property by Name

This action retrieves a PAPI property within a group by its name.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Required

Default value:

None

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

Default value:

None

Property Name 

Enter the name of the property to retrieve.

Example:

property_abc

Text

Required

You can retrieve the property name using the action List Properties.

Default value:

None

Action: Get Pending Change

This action retrieves the detailed information of a pending change.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment on which to retrieve the information.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Change ID 

Enter the ID of the change associated with the enrollment.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Allowed Input Type 

Enter the value for the allowed input type.

Text

Required

Allowed values:

change-management-info, lets-encrypt-challenges, post-verification-warnings, pre-verification-warnings, third-party-csr

Action: Get Property Activation

This action retrieves details of a specific property activation.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the unique identifier for the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Activation ID 

Enter the unique identifier for the activation.

Example:

act_67890

Text

Required

You can retrieve the activation ID using the action List Activation History.

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Optional

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Optional

You can retrieve the group ID using the action List Groups.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Action: Get Property Details

This action retrieves the details of a specific property.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the ID of the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Contract ID 

Enter the contract ID for the property.

Example:

ctr_k-0n7rak71

Text

Optional

Group ID 

Enter the group ID for the property.

Example:

grp_54321

Text

Optional

You can retrieve the group ID using the action List Groups.

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Get Property Rule Tree

This action retrieves rules for a specific property version.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the unique identifier for the property.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Property Version 

Enter the version number of the property.

Example:

1

Integer

Required

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Optional

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5c0ylb:1-8byux

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

groupId, validateRules, validateMode, originalInput

Action: Get Zone Record Sets

This action retrieves the DNS record sets for the specified zone.

Note

To use this action, you must have READ-WRITE access in the DNS—Zone Record Management API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Zone 

Enter the name of the zone.

Example:

example.com

Text

Required

Page 

Enter the page number to retrieve results from.

Example:

20

Integer

Optional

Default value:

1

Page Size 

Enter the number of results to retrieve on each page.

Example:

25

Integer

Optional

Default value:

25

Show All 

Choose true to retrieve the entire list, disabling paging and sorting.

Boolean

Optional

Default value:

false

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Query Params 

Enter the extra parameters to make the request.

Key Value

Optional

Allowed keys:

sortby, types, search

Action: List Activation History

This action retrieves the activations for a specific configuration.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List CIDR Blocks

This action retrieves the firewall CIDR blocks based on the provided filters.

Note

To use this action, you must have READ-WRITE access in the Firewall Rules Notification API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Last Action 

Enter the last action taken on the CIDR block to filter the response.

Text

Optional

Allowed values:

all, add, update, delete

Default value:

all

Effective After Date 

Enter the ISO 8601 date to filter the list for CIDR blocks with an effective date after this value.

Example:

2021-02-21

Text

Optional

Action: List Configurations

This action retrieves the list of configurations.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Domains

This action retrieves the list of GTM domains.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Enrollments

This action lists the names of each enrollment.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the ID of the contract on which to operate or view enrollments.

Example:

K-0N7RAK7

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Groups

This action lists all the groups.

Note

To use this action, you must have ADMIN access in the Identity Management: User Administration API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Actions 

Choose true to include information about actions in the response.

Boolean

Optional

Default value:

false

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Hostnames for an Account

This action retrieves the list of active property hostnames for all properties available in an account.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the contract ID for the request.

Text

Optional

Group ID 

Enter the group ID for the request.

Text

Optional

You can retrieve the group ID using the action List Groups.

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

offset, limit, sort, hostname, cnameTo, network

Action: List Match Targets

This action lists match targets for a specific security configuration version.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Policy ID 

Enter the policy ID to filter match targets.

Example:

abc_123456

Text

Optional

You can retrieve the policy ID using the action List Security Policies.

Include Child Object Name 

Choose true to retrieve the child object name in the response.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Properties

This action lists the properties.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract ID 

Enter the unique identifier for the contract.

Example:

ctr_12345

Text

Required

Default value:

None

Group ID 

Enter the unique identifier for the group.

Example:

grp_67890

Text

Required

You can retrieve the group ID using the action List Groups.

Default value:

None

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

modifiedSince, modifiedNetwork

Action: List Property Activations

This action retrieves the activations of a specific property.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the ID of the property.

Text

Required

You can retrieve the property ID using the action List Properties.

Contract ID 

Enter the contract ID for the property.

Text

Optional

Group ID 

Enter the group ID for the property.

Text

Optional

You can retrieve the group ID using the action List Groups.

Use Prefixes 

Choose true to include prefixes in the response. choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

True

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Security Policies

This action retrieves security policies for a specific configuration version.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Not Matched 

Choose true to list security policies without a match target in the configuration version. Choose false to list all security policies.

Boolean

Optional

Default value:

False

Detail 

Choose true to retrieve detailed information on the version in the response. If you choose false, this action returns the summary.

Boolean

Optional

Default value:

False

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Site Shield Maps

This action lists all site shield maps.

Note

To use this action, you must have READ-WRITE access in the Site Shield API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: List Zones

This action lists all the edge DNS zones.

Note

To use this action, you must have READ-WRITE access in the DNS—Zone Record Management API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Contract IDs 

Enter one or more contract IDs to filter the response.

Example:

K-0N7RAK7

Text

Optional

Search 

Enter the query to filter the response.

Example:

org

Text

Optional

Page 

Enter the page number to retrieve results from.

Example:

20

Integer

Optional

Default value:

1

Page Size 

Enter the number of results to retrieve on each page.

Example:

25

Integer

Optional

Default value:

25

Show All 

Choose true to retrieve the entire list, disabling paging and sorting.

Boolean

Optional

Default value:

false

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

sortBy, subzoneGrants, types

Action: Modify Match Target

This action updates a match target for a specific configuration version.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Target ID 

Enter the ID of the match target.

Example:

112231

Text

Required

You can retrieve the target ID using the action List Match Targets.

Security Policy ID 

Enter the security policy associated with the match target.

Example:

fwsf_32432

Key Value

Required

You can retrieve the security policy ID using the action List Security Policies.

Target Type 

Enter the type of the match target.

Example:

website

Text

Required

Allowed values:

website, api

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Additional Fields 

Enter any additional fields to pass to the API.

Key Value

Optional

Allowed keys:

apis, bypassNetworkLists, configversion, defaultFile, fileExtensions, filePaths, hostnames, isNegativeFileExtensionMatch, isNegativePathMatch, sequence

Action: Modify Selected Hostnames

This action updates the selected hostnames for a given security policy in a configuration.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Policy ID 

Enter the ID of the security policy.

Example:

bobf_19288

Text

Required

You can retrieve the policy ID using the action List Security Policies.

Mode 

Enter the type of the update.

Example:

append

Text

Required

Allowed values:

append, remove, replace

Hostname List 

Enter the list of hostnames to be updated.

Example:

["*.example.net", "api.example.com"].

List

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Modify Version Notes

This action updates the version notes for a given configuration version.

Note

To use this action, you must have READ-WRITE access in the Application Security API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Config ID 

Enter the configuration ID.

Example:

77653

Text

Required

You can retrieve the config ID using the action List Configurations.

Version Number 

Enter the version number of the configuration.

Example:

25

Text

Required

Notes 

Enter the version notes to be added.

Example:

This is a version note

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Patch Property Rule Tree

This action modifies the rule tree for a specific property version.

Note

To use this action, you must have READ-WRITE access in the Property Manager API.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Property ID 

Enter the ID of the property to be patched.

Example:

prp_12345

Text

Required

You can retrieve the property ID using the action List Properties.

Property Version 

Enter the incremental version number of the property.

Example:

3

Integer

Required

Updates 

Enter the list of updates to apply to the property rules. Each update must include the operation ('op'), target path ('path'), and updated value ('value').

Example:

[{ "op": "replace", "path": "/rules/options/is_secure", "value": true }]

Any

Required

Use Prefixes 

Choose true to include prefixes in the response. Choose false when exchanging PAPI data with other APIs.

Boolean

Optional

Default value:

true

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Query Params 

Enter the query parameters to make the request.

Key Value

Optional

Allowed keys:

contractId, groupId, validateRules, validateMode, dryRun, originalInput, upgradeRules

Action: Update Deployment Schedule

This action updates the deployment schedule for a specific enrollment change.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment for which you want to update the deployment schedule.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Change ID 

Enter the id of the change associated with the enrollment.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Not Before 

Enter the earliest time (in ISO 8601 format) to schedule the deployment. If not specified, the change will take effect immediately.

Example:

2017-05-19T16:00:00Z

Text

Optional

Not After 

Enter the latest time (in ISO 8601 format) after which the deployment cannot be scheduled.

Example:

2017-05-19T16:00:00

Text

Optional

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Update Enrollment

This action updates an enrollment.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment to update.

Example:

10000

Text

Required

You can retrieve the enrollment ID using the action List Enrollments.

Certificate Type 

Enter the type of the certificate.

Example:

san

Text

Required

Allowed values:

san, single, wildcard, wildcard-san, third-party

Change Management 

Choose true to prevent the certificate provisioning system (CPS) from deploying the certificate to the network until you confirm that you are ready for deployment.

Boolean

Required

CSR 

Enter the certificate signing request (CSR) to update the enrollment.

Any

Required

Allowed keys:

c, cn, l, o, ou, preferredTrustChain, sans, st

Enable Multi Stacked Certificates 

Choose true to enable dual-stacked certificate deployment for this enrollment.

Boolean

Required

Network Configuration 

Enter the network configuration settings for the certificate.

Any

Required

Allowed keys:

clientMutualAuthentication, disallowedTlsVersions, dnsNameSettings, fipsMode, geography, mustHaveCiphers, ocspStapling, preferredCiphers, quicEnabled, secureNetwork, sniOnly

RA 

Enter the registration authority or certificate authority (CA) for the certificate enrollment.

Text

Required

Allowed values:

symantec, lets-encrypt, third-party

Validation Type 

Enter the type of the validation.

Text

Required

Allowed values:

dv, ev, ov, third-party

Query Params 

Enter the extra parameters to update enrollment.

Key Value

Optional

Allowed keys:

deploy-not-after, deploy-not-before, accountSwitchKey

Additional Fields 

Enter the additional fields to update enrollment.

Key Value

Optional

Allowed keys:

adminContact, assigneslots, autoRenewalStartTime, certificateChainType, id, location, maxAllowedSanNames, maxAllowedWildcardSanNames, org, orgId, pendingChanges, productionSlots, signatureAlgorithm, stagingSlots, techContact, thirdParty

Action: Update Pending Change

This action updates a pending change.

Note

To use this action, you must have READ-WRITE access in the Certificate Provisioning System API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Enrollment ID 

Enter the ID of the enrollment on which you want to update the change.

Example:

10000

Integer

Required

You can retrieve the enrollment ID using the action List Enrollments.

Change ID 

Enter the ID of the change associated with the enrollment.

Example:

10000

Integer

Required

You can retrieve the change ID using the action List Enrollments.

Allowed Input Type 

Enter the value for the allowed input type.

Text

Required

Allowed values:

change-management-ack, lets-encrypt-challenges-completed, post-verification-warnings-ack, pre-verification-warnings-ack, third-party-cert-and-trust-chain

Acknowledgment 

Enter the state for which this acknowledgment is submitted.

Text

Required

Allowed values:

acknowledge, deny

Hash 

Enter the hash value of the state you want to acknowledge.

Example:

24fb6fb91d290370c13a39e76afc1b26

Text

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Update Property

This action updates a global traffic management (GTM) property.

Note

To use this action, you must have READ-WRITE access in the Traffic Management Configurations API service.

Action Input Parameters 

Parameter

Description

Field Type

Required/Optional

Comments

Domain Name 

Enter the GTM domain name.

Example:

example.akadns.net

Text

Required

You can retrieve the domain name using the action List Domains.

Property Name 

Enter the unique name of the property. This forms a valid RFC 1123 hostname when joined with the domain name.

Text

Required

Updates 

Enter a dictionary with the fields to update.

Example:

{"dynamicttl": 300, "backupcname": "backup.example.com"}.

Key Value

Required

Account Switch Key 

Enter the account switch key to perform this action from a different account.

Example:

1-5C0YLB:1-8BYUX

Text

Optional

For more information, see Akamai Web Application Firewall documentation.

Action: Generic Action

This is a generic action used to make requests to any Akamai WAF 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:

appsec/v1/configs

Text

Required

Query Params

Enter the query parameters to pass to the API.

Key Value

Optional

Payload

Enter the payload to pass to the API.

Any

Optional

Additional Fields

Enter the additional fields to pass to the API.

Key Value

Optional

Allowed keys:

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