Integra Akamai con Google SecOps

Questo documento spiega come integrare Akamai con Google Security Operations.

Casi d'uso

L'integrazione di Akamai utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Automatizza il blocco delle minacce all'edge: aggiungi indirizzi IP dannosi, blocchi CIDR, numeri di sistemi autonomi, posizioni geografiche, fingerprint TLS o hash di file identificati durante le indagini agli elenchi di client o di rete di Akamai per bloccare le minacce all'edge della rete.

  • Gestisci controllo dell'accesso dinamico e le liste consentite: rimuovi gli indicatori benigni o le voci scadute dagli elenchi di client e di rete Akamai quando i falsi positivi vengono risolti o le restrizioni temporanee scadono.

  • Esegui il deployment degli aggiornamenti delle policy in tutti gli ambienti: attiva gli elenchi di client e di reti aggiornati negli ambienti di gestione temporanea o di produzione di Akamai direttamente dai playbook automatizzati e comunica gli eventi di attivazione agli stakeholder.

  • Controlla gli elenchi di sicurezza perimetrale: recupera i metadati, i contenuti degli elementi e gli stati di attivazione dell'ambiente per gli elenchi di client e di rete Akamai per arricchire le indagini sulla sicurezza e verificare gli stati di applicazione attuali.

Prima di iniziare

Prima di configurare l'integrazione di Akamai in Google SecOps, completa i seguenti passaggi preliminari:

  1. Crea le credenziali API Akamai EdgeGrid per la tua istanza di Google SecOps.

  2. Configura le autorizzazioni API richieste in Akamai per le azioni che prevedi di eseguire.

Crea credenziali API Akamai EdgeGrid

L'integrazione di Akamai esegue l'autenticazione con l'API Akamai utilizzando le credenziali EdgeGrid. Esegui il provisioning di un client API dedicato in Akamai Control Center e raccogli i seguenti valori delle credenziali richiesti per i parametri di integrazione:

  • Host (l'URL del nome host di base per il tuo client API Akamai)
  • Client Token
  • Client Secret
  • Access Token

Configura le autorizzazioni API (privilegio minimo)

Concedi al client API Akamai solo le autorizzazioni del servizio API necessarie per le azioni specifiche che prevedi di eseguire e verifica che l'ambito del gruppo di controllo degli accessi del client API includa gli elenchi di client e di reti di destinazione.

Consulta le autorizzazioni API minime per le azioni Akamai nella tabella seguente:

Nome azione Servizio API Akamai Livello di accesso richiesto Ambito degli endpoint
Attiva l'elenco di clienti API Client Lists v1 e v2 Read-Write Risolve gli identificatori degli elenchi di clienti utilizzando GET /client-list/v1/lists e attiva l'elenco di destinazione utilizzando POST /client-list/v2/lists/{listId}/activations.
Attiva l'elenco delle reti API Network Lists v2 Read-Write Risolve gli identificatori degli elenchi di rete utilizzando GET /network-list/v2/network-lists e attiva l'elenco di destinazione utilizzando POST /network-list/v2/network-lists/{networkListId}/environments/{environment}/activate.
Aggiungi elementi all'elenco clienti API Client Lists v1 Read-Write Recupera gli elenchi di clienti per la convalida utilizzando GET /client-list/v1/lists e aggiunge elementi utilizzando POST /client-list/v1/lists/{listId}/items.
Aggiungi elementi all'elenco di reti API Network Lists v2 Read-Write Risolve gli identificatori degli elenchi di rete utilizzando GET /network-list/v2/network-lists e aggiunge elementi utilizzando POST /network-list/v2/network-lists/{networkListId}/append.
Recupera gli elenchi di clienti API Client Lists v1 Read-Only Recupera gli elenchi di clienti e i relativi elementi utilizzando GET /client-list/v1/lists.
Ottieni elenchi di reti API Network Lists v2 Read-Only Recupera gli elenchi di rete, le voci di elenco e gli stati di attivazione dell'ambiente utilizzando GET /network-list/v2/network-lists, GET /network-list/v2/network-lists/{networkListId} e GET /network-list/v2/network-lists/{networkListId}/environments/{environment}/status.
Ping API Network Lists v2 Read-Only Convalida la connettività e le credenziali dell'API utilizzando GET /network-list/v2/network-lists?limit=1.
Rimuovi elementi dall'elenco dei clienti API Client Lists v1 Read-Write Recupera gli elenchi di clienti per la convalida utilizzando GET /client-list/v1/lists ed elimina gli elementi utilizzando POST /client-list/v1/lists/{listId}/items.
Rimuovi elementi dall'elenco delle reti API Network Lists v2 Read-Write Risolve gli identificatori degli elenchi di rete utilizzando GET /network-list/v2/network-lists e rimuove i singoli elementi utilizzando DELETE /network-list/v2/network-lists/{networkListId}/elements.

Parametri di integrazione

L'integrazione di Akamai richiede i seguenti parametri:

Parametro Descrizione
Host

Obbligatorio.

L'URL di base dell'istanza dell'API Akamai, incluso lo schema https://, ad esempio https://akab-example.luna.akamaiapis.net.

Il valore predefinito è https://{host}.

Client Token

Obbligatorio.

Il token client per il tuo client API Akamai EdgeGrid.

Client Secret

Obbligatorio.

Il client secret per il tuo client API Akamai EdgeGrid.

Access Token

Obbligatorio.

Il token di accesso per il client API Akamai EdgeGrid.

Verify SSL

Obbligatorio.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Akamai.

Abilitato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Attiva l'elenco clienti

Utilizza l'azione Attiva elenco client per attivare un elenco client specifico nel tuo ambiente di gestione temporanea o di produzione Akamai.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attiva elenco clienti richiede i seguenti parametri:

Parametro Descrizione
Client List Name

Facoltativo.

Il nome dell'elenco di clienti da attivare. La corrispondenza è sensibile alle maiuscole.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Client List ID

Facoltativo.

L'identificatore univoco dell'elenco di clienti da attivare.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Environment

Facoltativo.

L'ambiente Akamai di destinazione per l'attivazione dell'elenco di client.

I valori possibili sono:

  • Production
  • Staging

Il valore predefinito è Production.

Comment

Facoltativo.

Un commento che descrive lo scopo dell'attivazione dell'elenco di clienti.

Notification Recipients

Facoltativo.

Un elenco separato da virgole di indirizzi email a cui inviare una notifica al termine dell'attivazione dell'elenco di clienti.

Output azione

L'azione Attiva elenco clienti fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Attiva elenco clienti:

{
  "action": "ACTIVATE",
  "activations": {
    "STAGING": {
      "activationId": 3797405,
      "activationStatus": "PENDING_ACTIVATION"
    }
  },
  "comments": "Activating 235466",
  "createDate": "2026-02-12T15:12:07.952+00:00",
  "createdBy": "4wksaj3wyt23jt2i",
  "listId": "235466_GOOGLESECOPSCLIENTLIST1",
  "notificationRecipients": [
    "12345@email.com"
  ],
  "version": 14
}
Messaggi di output

L'azione Attiva elenco clienti fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully activated the client list in Akamai. L'azione è riuscita.
Error executing action "Activate Client List". Reason: Provide a value in "Client List Name" or "Client List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Client List Name o Client List ID.

Error executing action "Activate Client List". Reason: "CLIENT_LIST_IDENTIFIER" client list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di client specificato esista in Akamai e che il nome corrisponda esattamente alle maiuscole e minuscole se la ricerca viene eseguita per Client List Name.

Error executing action "Activate Client List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica che l'elenco di clienti target contenga elementi pronti per l'attivazione o controlla le tue credenziali API.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attiva elenco clienti:

Nome del risultato dello script Valore
is_success true o false

Attiva l'elenco delle reti

Utilizza l'azione Attiva elenco di reti per attivare un elenco di reti specifico nel tuo ambiente di gestione temporanea o di produzione Akamai.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attiva elenco di reti richiede i seguenti parametri:

Parametro Descrizione
Network List Name

Facoltativo.

Il nome dell'elenco di reti da attivare. La corrispondenza è sensibile alle maiuscole.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Network List ID

Facoltativo.

L'identificatore univoco dell'elenco di reti da attivare.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Environment

Facoltativo.

L'ambiente Akamai di destinazione per l'attivazione della lista di rete.

I valori possibili sono:

  • Production
  • Staging

Il valore predefinito è Production.

Comment

Facoltativo.

Un commento che descrive lo scopo dell'attivazione dell'elenco di reti.

Notification Recipients

Facoltativo.

Un elenco separato da virgole di indirizzi email a cui inviare una notifica al termine dell'attivazione dell'elenco di reti.

Output azione

L'azione Attiva elenco di rete fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Attiva elenco di rete:

{
  "activationId": 12345,
  "activationComments": "Allow IPs of new employees who joined this week",
  "activationStatus": "PENDING_ACTIVATION",
  "syncPoint": 5,
  "uniqueId": "25614_GENERALLIST",
  "fast": false,
  "dispatchCount": 1,
  "links": {
    "appendItems": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
      "method": "POST"
    },
    "retrieve": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
    },
    "statusInProduction": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
    },
    "statusInStaging": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
    },
    "syncPointHistory": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
    },
    "update": {
      "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
      "method": "PUT"
    },
    "activationDetails": {
      "href": "/network-list/v2/network-lists/activations/12345/"
    }
  }
}
Messaggi di output

L'azione Attiva elenco di rete fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully activated the network list in Akamai. L'azione è riuscita.
Error executing action "Activate Network List". Reason: Provide a value in "Network List Name" or "Network List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Network List Name o Network List ID.

Error executing action "Activate Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di reti specificato esista in Akamai e che il nome corrisponda esattamente alle maiuscole e minuscole se la ricerca viene eseguita per Network List Name.

Error executing action "Activate Network List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica che le tue credenziali API abbiano l'accesso in scrittura all'API Network Lists o esamina i parametri di input.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attiva elenco di reti:

Nome del risultato dello script Valore
is_success true o false

Aggiungi elementi all'elenco dei clienti

Utilizza l'azione Aggiungi elementi all'elenco client per aggiungere uno o più elementi (ad esempio indirizzi IP, posizioni geografiche, numeri di sistemi autonomi, fingerprint TLS o hash dei file) a un elenco client esistente in Akamai.

L'azione elabora ogni elemento singolarmente e segnala un status di added, duplicated (se l'elemento è già presente nell'elenco) o failed nel risultato JSON. L'aggiunta di elementi aggiorna l'elenco dei client in Akamai, ma le modifiche non diventano effettive nell'edge di Akamai finché non esegui l'azione Attiva elenco client per l'ambiente di destinazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi elementi all'elenco clienti richiede i seguenti parametri:

Parametro Descrizione
Client List Name

Facoltativo.

Il nome dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Client List ID

Facoltativo.

L'identificatore univoco dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Item Value

Obbligatorio.

Un elenco separato da virgole di valori degli elementi da aggiungere all'elenco di clienti.

Item Description

Facoltativo.

Una descrizione da associare agli elementi aggiunti.

Item Expiration Date

Facoltativo.

Una data di scadenza per gli elementi aggiunti, nel formato ISO 8601.

Item Tags

Facoltativo.

Un elenco separato da virgole di tag da associare agli elementi aggiunti.

Output azione

L'azione Aggiungi elementi all'elenco clienti fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi elementi all'elenco clienti:

[
  {
    "createDate": "2026-03-20T09:54:11.410+00:00",
    "createdBy": "4wksaj3wyt23jt2i",
    "description": "Blocked IP indicator",
    "expirationDate": "2026-04-05T19:29:02.320+00:00",
    "tags": [],
    "type": "IP",
    "updateDate": "2026-03-20T09:54:11.410+00:00",
    "updatedBy": "4wksaj3wyt23jt2i",
    "value": "192.0.2.1",
    "status": "added"
  },
  {
    "value": "192.0.2.3",
    "status": "duplicated"
  },
  {
    "value": "192.0.2.TT",
    "status": "failed",
    "error": "Validation failed: append[0].value: Item of type IP has an invalid value 192.0.2.TT"
  }
]
Messaggi di output

L'azione Aggiungi elementi all'elenco clienti fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully updated client list in Akamai.

L'azione è riuscita.

Tutti gli elementi specificati sono stati aggiunti all'elenco dei clienti ("status": "added") o erano già presenti nell'elenco ("status": "duplicated").

One or more items were not added. See JSON results for details.

L'azione non è riuscita ad aggiungere uno o più elementi specificati ("status": "failed").

Se almeno un elemento del batch è stato aggiunto o esisteva già nell'elenco, is_success rimane true. Se tutti gli elementi non sono riusciti, is_success è false. Esamina l'output del risultato JSON per controllare i dettagli di error per ogni elemento non riuscito e verifica che ogni valore nel parametro Item Value corrisponda al tipo di dati dell'elenco di clienti target.

Error executing action "Add Items To Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Client List Name o Client List ID.

Error executing action "Add Items To Client List". Reason: "CLIENT_LIST_IDENTIFIER" client list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di client specificato esista in Akamai e che le tue credenziali API dispongano dell'autorizzazione per accedere agli elenchi di client.

Error executing action "Add Items To Client List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica che il parametro Item Expiration Date utilizzi un formato ISO 8601 valido o esamina le tue credenziali API.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi elementi all'elenco clienti:

Nome del risultato dello script Valore
is_success true o false

Aggiungi elementi all'elenco di reti

Utilizza l'azione Aggiungi elementi all'elenco di rete per aggiungere uno o più elementi (ad esempio indirizzi IP, blocchi CIDR o posizioni geografiche) a un elenco di rete esistente in Akamai.

L'aggiunta di elementi aggiorna l'elenco di reti in Akamai, ma le modifiche non diventano effettive nell'edge di Akamai finché non esegui l'azione Attiva elenco di reti per l'ambiente di destinazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi elementi all'elenco di rete richiede i seguenti parametri:

Parametro Descrizione
Network List Name

Facoltativo.

Il nome dell'elenco di reti da aggiornare. La corrispondenza è sensibile alle maiuscole.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Network List ID

Facoltativo.

L'identificatore univoco dell'elenco di reti da aggiornare.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Items

Obbligatorio.

Un elenco separato da virgole di elementi da aggiungere all'elenco di reti.

Output azione

L'azione Aggiungi elementi all'elenco di rete fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi elementi all'elenco di rete:

{
  "networkListType": "networkListResponse",
  "accessControlGroup": "KSD\nwith ION 3-13H1234",
  "name": "General List",
  "elementCount": 3011,
  "readOnly": false,
  "shared": false,
  "syncPoint": 22,
  "type": "IP",
  "uniqueId": "25614_GENERALLIST",
  "links": {
    "activateInProduction": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
      "method": "POST"
    },
    "activateInStaging": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
      "method": "POST"
    },
    "appendItems": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST",
      "method": "POST"
    },
    "retrieve": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST"
    },
    "statusInProduction": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
    },
    "statusInStaging": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
    },
    "update": {
      "href": "/network-list/v2/network-lists/25614_GENERALLIST",
      "method": "PUT"
    }
  }
}
Messaggi di output

L'azione Aggiungi elementi all'elenco di rete fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully updated network list 'NETWORK_LIST_IDENTIFIER' in Akamai. L'azione è riuscita.
Failed to update network list 'NETWORK_LIST_IDENTIFIER' in Akamai.

L'azione non è riuscita.

Verifica che i valori nel parametro Items siano validi per il tipo di elenco di reti target e che l'elenco non sia di sola lettura.

Error executing action "Add Items To Network List". Reason: Provide a value in "Network List Name" or "Network List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Network List Name o Network List ID.

Error executing action "Add Items To Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di reti specificato esista in Akamai e che il nome corrisponda esattamente alle maiuscole e minuscole se la ricerca viene eseguita per Network List Name.

Error executing action "Add Items To Network List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica il formato del parametro Items o controlla le credenziali API.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Aggiungi elementi all'elenco di rete:

Nome del risultato dello script Valore
is_success true o false

Ottieni elenchi di clienti

Utilizza l'azione Get Client Lists per recuperare i metadati e i contenuti degli elementi per gli elenchi di client configurati in Akamai.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Client Lists richiede i seguenti parametri:

Parametro Descrizione
Client List Name

Facoltativo.

Un elenco separato da virgole di nomi di elenchi di clienti da recuperare. La corrispondenza è sensibile alle maiuscole.

Se non fornisci Client List Name o Client List ID, l'azione restituisce tutti gli elenchi di clienti disponibili fino al limite specificato.

Client List ID

Facoltativo.

Un elenco separato da virgole di ID elenco clienti da recuperare. La corrispondenza non distingue tra maiuscole e minuscole.

Se non fornisci Client List Name o Client List ID, l'azione restituisce tutti gli elenchi di clienti disponibili fino al limite specificato.

Include Items

Facoltativo.

Se selezionata, l'azione restituisce informazioni sugli elementi all'interno di ogni elenco di clienti corrispondente.

L'azione restituisce queste informazioni solo quando fornisci un valore in Client List Name o Client List ID.

Type

Facoltativo.

Il tipo di elenco di clienti da cercare. Se impostata su Select One, l'azione esegue la ricerca in tutti i tipi di elenchi di clienti.

I valori possibili sono:

  • Select One
  • IP
  • GEO
  • ASN
  • TLS Fingerprint
  • File Hash

Il valore predefinito è Select One.

Max Client Lists To Return

Obbligatorio.

Il numero massimo di elenchi di clienti da restituire.

Il valore massimo è 100.

Il valore predefinito è 100.

Max Client List Items To Return

Obbligatorio.

Il numero massimo di elementi da restituire per ogni elenco di clienti.

Il valore massimo è 100.

Il valore predefinito è 100.

Output azione

L'azione Get Client Lists (Ottieni elenchi di clienti) fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Client Lists:

[
  {
    "contractId": "K-0N7RAK71",
    "createDate": "2023-04-05T18:20:42.090+00:00",
    "createdBy": "jsmith",
    "deprecated": false,
    "groupId": 32145,
    "groupName": "Acme IT Group",
    "items": [
      {
        "createDate": "2023-04-05T18:20:42.892+00:00",
        "createdBy": "jkowalski",
        "description": "Canada - North America",
        "expirationDate": "2023-12-31T23:59:19.700+00:00",
        "productionStatus": "INACTIVE",
        "stagingStatus": "INACTIVE",
        "tags": [
          "allowlist1"
        ],
        "type": "GEO",
        "updateDate": "2023-04-05T18:20:42.892+00:00",
        "updatedBy": "mrossi",
        "value": "CA"
      }
    ],
    "itemsCount": 3,
    "listId": "1234_NORTHAMERICAGEOALLOWLIST",
    "listType": "CL",
    "name": "NorthAmericaGeoAllowlist",
    "notes": "GEO code allowlist",
    "productionActivationStatus": "INACTIVE",
    "readOnly": false,
    "shared": false,
    "stagingActivationStatus": "INACTIVE",
    "tags": [
      "allowlist2"
    ],
    "type": "GEO",
    "updateDate": "2023-04-05T18:20:42.090+00:00",
    "updatedBy": "jdupont",
    "version": 1
  }
]
Messaggi di output

L'azione Get Client Lists (Ottieni elenchi di clienti) fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully returned client lists from Akamai. L'azione è riuscita.
No clients lists were found for the provided criteria in Akamai.

L'azione non è riuscita.

Verifica che i nomi o gli ID degli elenchi di client specificati esistano in Akamai, corrispondano al filtro Type selezionato e utilizzino le lettere maiuscole e minuscole esatte durante la ricerca per Client List Name.

Error executing action "Get Client Lists". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica che i parametri di ritorno massimi siano compresi tra 1 e 100 o controlla le credenziali API.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera elenchi di clienti:

Nome del risultato dello script Valore
is_success true o false

Ottieni elenchi di reti

Utilizza l'azione Recupera elenchi di rete per recuperare i metadati, i contenuti degli elementi e gli stati di attivazione degli elenchi di rete configurati in Akamai.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Network Lists richiede i seguenti parametri:

Parametro Descrizione
Network List Name

Facoltativo.

Un elenco separato da virgole di nomi di elenchi di reti da recuperare. La corrispondenza è sensibile alle maiuscole.

Se non fornisci Network List Name o Network List ID, l'azione restituisce tutti gli elenchi di reti disponibili fino al limite specificato.

Network List ID

Facoltativo.

Un elenco separato da virgole di ID di elenchi di reti da recuperare. La corrispondenza non distingue tra maiuscole e minuscole.

Se non fornisci Network List Name o Network List ID, l'azione restituisce tutti gli elenchi di reti disponibili fino al limite specificato.

Include Items

Facoltativo.

Se selezionata, l'azione restituisce gli elementi contenuti in ogni elenco di reti.

Include Activation Status

Facoltativo.

Se selezionata, l'azione restituisce lo stato di attivazione per ogni elenco di rete corrispondente.

L'azione restituisce queste informazioni solo se fornisci un valore in Network List Name o Network List ID.

Activation Environment

Facoltativo.

L'ambiente per cui restituire lo stato di attivazione dell'elenco di reti quando selezioni Include Activation Status e fornisci un Network List Name o Network List ID specifico.

I valori possibili sono:

  • Both
  • Production
  • Staging

Il valore predefinito è Both.

Max Network Lists To Return

Obbligatorio.

Il numero massimo di elenchi di reti da restituire.

Il valore massimo è 100.

Il valore predefinito è 100.

Max Network List Items To Return

Obbligatorio.

Il numero massimo di elementi da restituire per ogni elenco di reti.

Il valore massimo è 100.

Il valore predefinito è 100.

Output azione

L'azione Get Network Lists (Ottieni elenchi di reti) fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera elenchi di reti:

[
  {
    "networkListType": "networkListResponse",
    "accessControlGroup": "KSD\nwith ION 3-13H1234",
    "name": "General List",
    "elementCount": 3011,
    "readOnly": false,
    "shared": false,
    "syncPoint": 22,
    "type": "IP",
    "uniqueId": "25614_GENERALLIST",
    "links": {
      "activateInProduction": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
        "method": "POST"
      },
      "activateInStaging": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
        "method": "POST"
      },
      "appendItems": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST",
        "method": "POST"
      },
      "retrieve": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST"
      },
      "statusInProduction": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
      },
      "statusInStaging": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
      },
      "update": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST",
        "method": "PUT"
      }
    },
    "Activation_STAGING": {
      "activationId": 12345,
      "activationComments": "Allow IPs of new employees who joined this week",
      "activationStatus": "PENDING_ACTIVATION",
      "syncPoint": 5,
      "uniqueId": "25614_GENERALLIST",
      "fast": false,
      "dispatchCount": 1,
      "links": {
        "appendItems": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
          "method": "POST"
        },
        "retrieve": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
        },
        "statusInProduction": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
        },
        "statusInStaging": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
        },
        "syncPointHistory": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
        },
        "update": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
          "method": "PUT"
        },
        "activationDetails": {
          "href": "/network-list/v2/network-lists/activations/12345/"
        }
      }
    },
    "Activation_PRODUCTION": {
      "activationId": 12345,
      "activationComments": "Allow IPs of new employees who joined this week",
      "activationStatus": "PENDING_ACTIVATION",
      "syncPoint": 5,
      "uniqueId": "25614_GENERALLIST",
      "fast": false,
      "dispatchCount": 1,
      "links": {
        "appendItems": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
          "method": "POST"
        },
        "retrieve": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
        },
        "statusInProduction": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
        },
        "statusInStaging": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
        },
        "syncPointHistory": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
        },
        "update": {
          "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
          "method": "PUT"
        },
        "activationDetails": {
          "href": "/network-list/v2/network-lists/activations/12345/"
        }
      }
    }
  }
]
Messaggi di output

L'azione Get Network Lists (Ottieni elenchi di reti) fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully returned network lists from Akamai. L'azione è riuscita.
No network lists were found for the provided criteria in Akamai.

L'azione non è riuscita.

Verifica che i nomi o gli ID degli elenchi di reti specificati esistano in Akamai e che i nomi corrispondano esattamente alle maiuscole e minuscole quando esegui la ricerca per Network List Name.

Error executing action "Get Network Lists". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica che i parametri di ritorno massimi siano compresi tra 1 e 100 o controlla le credenziali API.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Get Network Lists:

Nome del risultato dello script Valore
is_success true o false

Dindin

Utilizza l'azione Ping per testare la connettività e convalidare le credenziali di autenticazione con il server Akamai.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Messaggi di output

L'azione Ping fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully connected to the Akamai server with the provided connection parameters! L'azione è riuscita.
Failed to connect to the Akamai server! Error is ERROR_REASON

L'azione non è riuscita.

Verifica che l'URL Host sia raggiungibile, controlla che i token e il secret di Akamai EdgeGrid siano validi e verifica che il client API abbia accesso all'API Network Lists.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
is_success true o false

Rimuovi elementi dall'elenco clienti

Utilizza l'azione Rimuovi elementi dall'elenco clienti per rimuovere uno o più elementi da un elenco clienti esistente in Akamai.

L'azione elabora ogni elemento singolarmente e segnala status di removed, doesn't exist (se l'elemento non è presente nell'elenco) o failed nel risultato JSON. La rimozione degli elementi aggiorna l'elenco dei client in Akamai, ma le modifiche non diventano effettive nell'edge di Akamai finché non esegui l'azione Attiva elenco client per l'ambiente di destinazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi elementi dall'elenco clienti richiede i seguenti parametri:

Parametro Descrizione
Client List Name

Facoltativo.

Il nome dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Client List ID

Facoltativo.

L'identificatore univoco dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole.

Devi fornire Client List Name o Client List ID. Se li fornisci entrambi, l'azione utilizza Client List ID.

Item Value

Obbligatorio.

Un elenco separato da virgole di valori degli elementi da rimuovere dall'elenco dei client.

Output azione

L'azione Rimuovi elementi dall'elenco clienti fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi elementi dall'elenco clienti:

[
  {
    "value": "192.0.2.1",
    "status": "doesn't exist"
  },
  {
    "value": "192.0.2.4",
    "status": "removed"
  },
  {
    "value": "192.0.2.4E",
    "status": "failed",
    "error": "Validation failed: delete[0].value: Item of type IP has an invalid value 192.0.2.4E"
  }
]
Messaggi di output

L'azione Rimuovi elementi dall'elenco clienti fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully updated client list in Akamai.

L'azione è riuscita.

Tutti gli elementi specificati sono stati rimossi dall'elenco di clienti ("status": "removed") o erano già assenti dall'elenco ("status": "doesn't exist").

One or more items were not removed. See JSON results for details.

L'azione non è riuscita a rimuovere uno o più elementi specificati ("status": "failed").

Se almeno un elemento del batch aveva lo stato removed o doesn't exist, is_success rimane true. Se tutti gli elementi non sono riusciti, is_success è false. Esamina l'output del risultato JSON per controllare i dettagli di error per ogni elemento non riuscito e verifica che ogni valore nel parametro Item Value sia valido per l'elenco di clienti target.

Error executing action "Remove Items From Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Client List Name o Client List ID.

Error executing action "Remove Items From Client List". Reason: "CLIENT_LIST_IDENTIFIER" client list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di client specificato esista in Akamai e che le tue credenziali API dispongano dell'autorizzazione per accedere agli elenchi di client.

Error executing action "Remove Items From Client List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica il formato del parametro Item Value o controlla le credenziali API.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Rimuovi elementi dall'elenco clienti:

Nome del risultato dello script Valore
is_success true o false

Rimuovi elementi dall'elenco delle reti

Utilizza l'azione Rimuovi elementi dall'elenco di reti per rimuovere uno o più elementi da un elenco di reti esistente in Akamai.

La rimozione degli elementi aggiorna l'elenco di reti in Akamai, ma le modifiche non diventano effettive nell'edge Akamai finché non esegui l'azione Attiva elenco di reti per l'ambiente di destinazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi elementi dall'elenco di rete richiede i seguenti parametri:

Parametro Descrizione
Network List Name

Facoltativo.

Il nome dell'elenco di reti da aggiornare. La corrispondenza è sensibile alle maiuscole.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Network List ID

Facoltativo.

L'identificatore univoco dell'elenco di reti da aggiornare.

Devi fornire Network List Name o Network List ID. Se li fornisci entrambi, l'azione utilizza Network List ID.

Items

Obbligatorio.

Un elenco separato da virgole di elementi da rimuovere dall'elenco delle reti.

Output azione

L'azione Rimuovi elementi dall'elenco di reti fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi elementi dall'elenco di reti:

[
  {
    "networkListType": "networkListResponse",
    "accessControlGroup": "KSD\nwith ION 3-13H1234",
    "name": "General List",
    "elementCount": 3010,
    "readOnly": false,
    "shared": false,
    "syncPoint": 23,
    "type": "IP",
    "uniqueId": "25614_GENERALLIST",
    "links": {
      "activateInProduction": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
        "method": "POST"
      },
      "activateInStaging": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
        "method": "POST"
      },
      "appendItems": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST",
        "method": "POST"
      },
      "retrieve": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST"
      },
      "statusInProduction": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
      },
      "statusInStaging": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
      },
      "update": {
        "href": "/network-list/v2/network-lists/25614_GENERALLIST",
        "method": "PUT"
      }
    }
  }
]
Messaggi di output

L'azione Rimuovi elementi dall'elenco di reti fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully updated network list in Akamai.

L'azione è riuscita.

Quando specifichi più elementi nel parametro Items, l'azione ha esito positivo se rimuove almeno un elemento dall'elenco di reti.

None of the provided items were found in the network list in Akamai.

L'azione non è riuscita a rimuovere nessuno degli elementi specificati.

Verifica che i valori specificati nel parametro Items esistano nell'elenco delle reti di destinazione.

No valid items provided for removal. Please provide a comma-separated list of items.

L'azione non è riuscita.

Fornisci uno o più valori validi separati da virgole nel parametro Items.

Error executing action "Remove Items From Network List". Reason: provide a value in "Network List Name" or "Network List ID" parameter.

L'azione non è riuscita.

Fornisci un identificatore valido nel parametro Network List Name o Network List ID.

Error executing action "Remove Items From Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

L'azione non è riuscita.

Verifica che il nome o l'ID dell'elenco di reti specificato esista in Akamai e che il nome corrisponda esattamente alle maiuscole e minuscole se la ricerca viene eseguita per Network List Name.

Error executing action "Remove Items From Network List". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server Akamai, verifica il formato del parametro Items o controlla le credenziali API.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Rimuovi elementi dall'elenco di reti:

Nome del risultato dello script Valore
is_success true o false

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.