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:
Crea le credenziali API Akamai EdgeGrid per la tua istanza di Google SecOps.
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 TokenClient SecretAccess 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 Il valore predefinito è |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di clienti da attivare. Devi fornire |
Environment |
Facoltativo. L'ambiente Akamai di destinazione per l'attivazione dell'elenco di client. I valori possibili sono:
Il valore predefinito è |
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 |
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 |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di reti da attivare. Devi fornire |
Environment |
Facoltativo. L'ambiente Akamai di destinazione per l'attivazione della lista di rete. I valori possibili sono:
Il valore predefinito è |
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 |
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 |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole. Devi fornire |
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 ( |
One or more items were not added. See JSON results for
details. |
L'azione non è riuscita ad aggiungere uno o più elementi specificati
( Se almeno un elemento del batch è stato aggiunto o esisteva già nell'elenco, |
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 |
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 |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di reti da aggiornare. Devi fornire |
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 |
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 |
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 |
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 |
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 ID |
Facoltativo. Un elenco separato da virgole di ID elenco clienti da recuperare. La corrispondenza non distingue tra maiuscole e minuscole. Se non fornisci |
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 |
Type |
Facoltativo. Il tipo di elenco di clienti da cercare. Se impostata su I valori possibili sono:
Il valore predefinito è |
Max Client Lists To Return |
Obbligatorio. Il numero massimo di elenchi di clienti da restituire. Il valore massimo è Il valore predefinito è |
Max Client List Items To Return |
Obbligatorio. Il numero massimo di elementi da restituire per ogni elenco di clienti. Il valore massimo è Il valore predefinito è |
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 |
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 |
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 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 |
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 |
Activation Environment |
Facoltativo. L'ambiente per cui restituire lo stato di attivazione dell'elenco di reti quando selezioni I valori possibili sono:
Il valore predefinito è |
Max Network Lists To Return |
Obbligatorio. Il numero massimo di elenchi di reti da restituire. Il valore massimo è Il valore predefinito è |
Max Network List Items To Return |
Obbligatorio. Il numero massimo di elementi da restituire per ogni elenco di reti. Il valore massimo è Il valore predefinito è |
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 |
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 |
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 |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di clienti da aggiornare. La corrispondenza non distingue tra maiuscole e minuscole. Devi fornire |
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 ( |
One or more items were not removed. See JSON results for
details. |
L'azione non è riuscita a rimuovere uno o più elementi specificati ( Se almeno un elemento del batch aveva lo stato |
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 |
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 |
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 ID |
Facoltativo. L'identificatore univoco dell'elenco di reti da aggiornare. Devi fornire |
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 |
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 |
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 |
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 |
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 |
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 |
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.