Akamai in Google SecOps einbinden
In diesem Dokument wird beschrieben, wie Sie Akamai in Google Security Operations einbinden.
Anwendungsfälle
Die Akamai-Integration nutzt Google SecOps-Funktionen, um die folgenden Anwendungsfälle zu unterstützen:
Bedrohungsblockierung am Edge automatisieren: Fügen Sie Akamai-Clientlisten oder -Netzwerklisten schädliche IP-Adressen, CIDR-Blöcke, autonome Systemnummern, geografische Standorte, TLS-Fingerabdrücke oder Dateihashes hinzu, die während der Untersuchungen identifiziert wurden, um Bedrohungen am Netzwerk-Edge zu blockieren.
Dynamische Zugriffssteuerung und Zulassungslisten verwalten: Entfernen Sie gutartige Indikatoren oder abgelaufene Einträge aus Akamai-Clientlisten und -Netzwerklisten, wenn falsch-positive Ergebnisse behoben wurden oder temporäre Einschränkungen abgelaufen sind.
Richtlinienaktualisierungen in allen Umgebungen bereitstellen: Aktivieren Sie aktualisierte Kunden- und Netzwerklisten in Akamai-Staging- oder Produktionsumgebungen direkt über automatisierte Playbooks und benachrichtigen Sie Stakeholder über Aktivierungsereignisse.
Edge-Sicherheitslisten prüfen: Rufen Sie Metadaten, Elementinhalte und Aktivierungsstatus der Umgebung für Akamai-Clientlisten und -Netzwerklisten ab, um Sicherheitsuntersuchungen zu ergänzen und aktuelle Erzwingungsstatus zu überprüfen.
Hinweis
Bevor Sie die Akamai-Integration in Google SecOps konfigurieren, müssen Sie die folgenden Voraussetzungen erfüllen:
Erstellen Sie Akamai EdgeGrid API-Anmeldedaten für Ihre Google SecOps-Instanz.
Konfigurieren Sie die erforderlichen API-Berechtigungen in Akamai für die Aktionen, die Sie ausführen möchten.
Akamai EdgeGrid API-Anmeldedaten erstellen
Die Akamai-Integration authentifiziert sich bei der Akamai API mit EdgeGrid-Anmeldedaten. Stellen Sie im Akamai Control Center einen dedizierten API-Client bereit und erfassen Sie die folgenden Anmeldedaten, die für die Integrationsparameter erforderlich sind:
Host(die Basis-Hostname-URL für Ihren Akamai API-Client)Client TokenClient SecretAccess Token
API-Berechtigungen konfigurieren (geringste Berechtigung)
Gewähren Sie dem Akamai API-Client nur die API-Dienstberechtigungen, die für die spezifischen Aktionen erforderlich sind, die Sie ausführen möchten. Prüfen Sie, ob der Zugriffskontrollgruppenbereich des API-Clients die Zielclientlisten und Netzwerklisten enthält.
In der folgenden Tabelle finden Sie die Mindest-API-Berechtigungen für Akamai-Aktionen:
| Aktionsname | Akamai API Service | Erforderliche Zugriffsebene | Endpunktbereich |
|---|---|---|---|
| Kundenliste aktivieren | Client Lists API v1 und v2 | Read-Write |
Löst Clientlistenkennungen mit GET /client-list/v1/lists auf und aktiviert die Zielliste mit POST /client-list/v2/lists/{listId}/activations. |
| Netzwerkliste aktivieren | Network Lists API v2 | Read-Write |
Löst Netzwerklistenkennungen mit GET /network-list/v2/network-lists auf und aktiviert die Zielliste mit POST
/network-list/v2/network-lists/{networkListId}/environments/{environment}/activate. |
| Elemente zur Kundenliste hinzufügen | Client Lists API Version 1 | Read-Write |
Ruft Clientlisten zur Validierung mit GET /client-list/v1/lists ab und hängt Elemente mit POST /client-list/v1/lists/{listId}/items an. |
| Elemente zur Netzwerkliste hinzufügen | Network Lists API v2 | Read-Write |
Löst Netzwerklistenkennungen mit GET /network-list/v2/network-lists auf und hängt Elemente mit POST
/network-list/v2/network-lists/{networkListId}/append an. |
| Kundenlisten abrufen | Client Lists API Version 1 | Read-Only |
Ruft Clientlisten und ihre Elemente mit GET /client-list/v1/lists ab. |
| Netzwerklisten abrufen | Network Lists API v2 | Read-Only |
Ruft Netzwerklisten, Listenelemente und Aktivierungsstatus von Umgebungen mit GET /network-list/v2/network-lists, GET /network-list/v2/network-lists/{networkListId} und GET
/network-list/v2/network-lists/{networkListId}/environments/{environment}/status ab. |
| Ping | Network Lists API v2 | Read-Only |
Validiert die API-Konnektivität und die Anmeldedaten mit GET /network-list/v2/network-lists?limit=1. |
| Elemente aus der Kundenliste entfernen | Client Lists API Version 1 | Read-Write |
Ruft Clientlisten zur Validierung mit GET /client-list/v1/lists ab und löscht Elemente mit POST /client-list/v1/lists/{listId}/items. |
| Elemente aus der Netzwerkliste entfernen | Network Lists API v2 | Read-Write |
Löst Netzwerklistenkennungen mit GET /network-list/v2/network-lists auf und entfernt einzelne Elemente mit DELETE
/network-list/v2/network-lists/{networkListId}/elements. |
Integrationsparameter
Für die Akamai-Integration sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Host |
Erforderlich. Die Basis-URL der Akamai API-Instanz, einschließlich des Der Standardwert ist |
Client Token |
Erforderlich. Das Clienttoken für Ihren Akamai EdgeGrid API-Client. |
Client Secret |
Erforderlich. Der Clientschlüssel für Ihren Akamai EdgeGrid API-Client. |
Access Token |
Erforderlich. Das Zugriffstoken für Ihren Akamai EdgeGrid API-Client. |
Verify SSL |
Erforderlich. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Akamai-Server hergestellt wird. Standardmäßig aktiviert. |
Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.
Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.
Aktionen
Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in Ihrem Fall ausführen.
Kundenliste aktivieren
Verwenden Sie die Aktion Clientliste aktivieren, um eine bestimmte Clientliste in Ihrer Akamai-Staging- oder Produktionsumgebung zu aktivieren.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Activate Client List sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Client List Name |
Optional. Der Name der zu aktivierenden Clientliste. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Sie müssen entweder |
Client List ID |
Optional. Die eindeutige Kennung der zu aktivierenden Clientliste. Sie müssen entweder |
Environment |
Optional. Die Akamai-Zielumgebung für die Aktivierung der Clientliste. Folgende Werte sind möglich:
Der Standardwert ist |
Comment |
Optional. Ein Kommentar, der den Zweck der Aktivierung der Clientliste beschreibt. |
Notification Recipients |
Optional. Eine durch Kommas getrennte Liste von E‑Mail-Adressen, die benachrichtigt werden sollen, wenn die Aktivierung der Clientliste abgeschlossen ist. |
Aktionsausgaben
Die Aktion Activate Client List (Clientliste aktivieren) liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Activate Client List empfangen wird:
{
"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
}
Ausgabenachrichten
Die Aktion Clientliste aktivieren liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully activated the client list in Akamai. |
Die Aktion war erfolgreich. |
Error executing action "Activate Client List". Reason: Provide a
value in "Client List Name" or "Client List ID" parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Activate Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Clientliste in Akamai vorhanden ist und ob der Name bei der Suche nach |
Error executing action "Activate Client List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, ob die Ziel-Clientliste Elemente enthält, die aktiviert werden können, oder Ihre API-Anmeldedaten. |
Scriptergebnis
In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Clientliste aktivieren verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Netzwerkliste aktivieren
Verwenden Sie die Aktion Netzwerkliste aktivieren, um eine bestimmte Netzwerkliste in Ihrer Akamai-Staging- oder Produktionsumgebung zu aktivieren.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Netzwerkliste aktivieren sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Network List Name |
Optional. Der Name der Netzwerkliste, die aktiviert werden soll. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Sie müssen entweder |
Network List ID |
Optional. Die eindeutige Kennung der zu aktivierenden Netzwerkliste. Sie müssen entweder |
Environment |
Optional. Die Akamai-Zielumgebung für die Aktivierung der Netzwerkliste. Folgende Werte sind möglich:
Der Standardwert ist |
Comment |
Optional. Ein Kommentar, der den Zweck der Aktivierung der Netzwerkliste beschreibt. |
Notification Recipients |
Optional. Eine durch Kommas getrennte Liste von E-Mail-Adressen, die benachrichtigt werden sollen, wenn die Aktivierung der Netzwerkliste abgeschlossen ist. |
Aktionsausgaben
Die Aktion Netzwerkliste aktivieren liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Netzwerkliste aktivieren erhalten:
{
"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/"
}
}
}
Ausgabenachrichten
Die Aktion Netzwerkliste aktivieren liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully activated the network list in Akamai. |
Die Aktion war erfolgreich. |
Error executing action "Activate Network List". Reason: Provide
a value in "Network List Name" or "Network List ID"
parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Activate Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Netzwerkliste in Akamai vorhanden ist und ob der Name bei der Suche nach |
Error executing action "Activate Network List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, ob Ihre API-Anmeldedaten Schreibzugriff auf die Network Lists API haben, oder prüfen Sie Ihre Eingabeparameter. |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Netzwerkliste aktivieren verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Elemente zur Kundenliste hinzufügen
Verwenden Sie die Aktion Elemente zur Clientliste hinzufügen, um einer vorhandenen Clientliste in Akamai ein oder mehrere Elemente (z. B. IP-Adressen, geografische Standorte, autonome Systemnummern, TLS-Fingerabdrücke oder Dateihashes) hinzuzufügen.
Die Aktion verarbeitet jedes Element einzeln und meldet im JSON-Ergebnis den status added, duplicated (wenn das Element bereits in der Liste vorhanden ist) oder failed. Durch das Hinzufügen von Elementen wird die Clientliste in Akamai aktualisiert. Die Änderungen werden jedoch erst dann am Akamai-Edge wirksam, wenn Sie die Aktion Clientliste aktivieren für die Zielumgebung ausführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Elemente zur Clientliste hinzufügen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Client List Name |
Optional. Der Name der zu aktualisierenden Kundenliste. Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht berücksichtigt. Sie müssen entweder |
Client List ID |
Optional. Die eindeutige Kennung der zu aktualisierenden Kundenliste. Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht berücksichtigt. Sie müssen entweder |
Item Value |
Erforderlich. Eine durch Kommas getrennte Liste von Elementwerten, die der Clientliste hinzugefügt werden sollen. |
Item Description |
Optional. Eine Beschreibung, die mit den hinzugefügten Elementen verknüpft werden soll. |
Item Expiration Date |
Optional. Ein Ablaufdatum für die hinzugefügten Elemente im ISO 8601-Format. |
Item Tags |
Optional. Eine durch Kommas getrennte Liste von Tags, die den hinzugefügten Elementen zugeordnet werden sollen. |
Aktionsausgaben
Die Aktion Elemente zur Kundenliste hinzufügen liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Elemente zur Clientliste hinzufügen empfangen wird:
[
{
"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"
}
]
Ausgabenachrichten
Die Aktion Elemente zur Clientliste hinzufügen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully updated client list in Akamai. |
Die Aktion war erfolgreich. Alle angegebenen Elemente wurden entweder der Kundenliste hinzugefügt ( |
One or more items were not added. See JSON results for
details. |
Mindestens ein angegebenes Element ( Wenn mindestens ein Element im Batch hinzugefügt wurde oder bereits in der Liste vorhanden war, bleibt |
Error executing action "Add Items To Client List". Reason:
provide a value in "Client List Name" or "Client List ID"
parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Add Items To Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Clientliste in Akamai vorhanden ist und ob Ihre API-Anmeldedaten Zugriff auf Clientlisten haben. |
Error executing action "Add Items To Client List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, ob der Parameter |
Scriptergebnis
In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Elemente zur Clientliste hinzufügen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Elemente zur Netzwerkliste hinzufügen
Verwenden Sie die Aktion Elemente zur Netzwerkliste hinzufügen, um einer vorhandenen Netzwerkliste in Akamai ein oder mehrere Elemente (z. B. IP-Adressen, CIDR-Blöcke oder geografische Standorte) hinzuzufügen.
Durch das Hinzufügen von Elementen wird die Netzwerkliste in Akamai aktualisiert. Die Änderungen werden jedoch erst am Akamai-Edge wirksam, wenn Sie die Aktion Netzwerkliste aktivieren für die Zielumgebung ausführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Elemente zur Netzwerkliste hinzufügen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Network List Name |
Optional. Der Name der zu aktualisierenden Netzwerkliste. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Sie müssen entweder |
Network List ID |
Optional. Die eindeutige Kennung der zu aktualisierenden Netzwerkliste. Sie müssen entweder |
Items |
Erforderlich. Eine durch Kommas getrennte Liste von Elementen, die der Netzwerkliste hinzugefügt werden sollen. |
Aktionsausgaben
Die Aktion Elemente zur Netzwerkliste hinzufügen liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Elemente zur Netzwerkliste hinzufügen zurückgegeben wird:
{
"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"
}
}
}
Ausgabenachrichten
Die Aktion Elemente zur Netzwerkliste hinzufügen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully updated network list
'NETWORK_LIST_IDENTIFIER' in
Akamai. |
Die Aktion war erfolgreich. |
Failed to update network list
'NETWORK_LIST_IDENTIFIER' in
Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob die Werte im Parameter |
Error executing action "Add Items To Network List". Reason:
Provide a value in "Network List Name" or "Network List ID"
parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Add Items To Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Netzwerkliste in Akamai vorhanden ist und ob der Name bei der Suche nach |
Error executing action "Add Items To Network List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, das Format des Parameters |
Scriptergebnis
In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Elemente zur Netzwerkliste hinzufügen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Kundenlisten abrufen
Verwenden Sie die Aktion Clientlisten abrufen, um Metadaten und Elementinhalte für in Akamai konfigurierte Clientlisten abzurufen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Get Client Lists sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Client List Name |
Optional. Eine durch Kommas getrennte Liste der Namen der abzurufenden Kundenlisten. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie |
Client List ID |
Optional. Eine durch Kommas getrennte Liste der abzurufenden Kundenlisten-IDs. Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn Sie weder |
Include Items |
Optional. Wenn diese Option ausgewählt ist, gibt die Aktion Informationen zu den Elementen in jeder übereinstimmenden Clientliste zurück. Die Aktion gibt diese Informationen nur zurück, wenn Sie einen Wert in |
Type |
Optional. Der Typ der Clientliste, nach der gesucht werden soll. Wenn Folgende Werte sind möglich:
Der Standardwert ist |
Max Client Lists To Return |
Erforderlich. Die maximale Anzahl der zurückzugebenden Clientlisten. Der Höchstwert ist Der Standardwert ist |
Max Client List Items To Return |
Erforderlich. Die maximale Anzahl der Elemente, die für jede Clientliste zurückgegeben werden sollen. Der Höchstwert ist Der Standardwert ist |
Aktionsausgaben
Die Aktion Get Client Lists liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Client Lists empfangen wird:
[
{
"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
}
]
Ausgabenachrichten
Die Aktion Clientlisten abrufen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully returned client lists from Akamai. |
Die Aktion war erfolgreich. |
No clients lists were found for the provided criteria in
Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob die angegebenen Namen oder IDs der Clientliste in Akamai vorhanden sind, mit dem ausgewählten Filter |
Error executing action "Get Client Lists". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, ob die maximalen Rückgabeparameter zwischen |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Client Lists verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Netzwerklisten abrufen
Verwenden Sie die Aktion Netzwerklisten abrufen, um Metadaten, Elementinhalte und Aktivierungsstatus für in Akamai konfigurierte Netzwerklisten abzurufen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Netzwerklisten abrufen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Network List Name |
Optional. Eine durch Kommas getrennte Liste der abzurufenden Netzwerklistennamen. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie weder |
Network List ID |
Optional. Eine durch Kommas getrennte Liste der abzurufenden Netzwerklisten-IDs. Bei der Übereinstimmung wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie weder |
Include Items |
Optional. Wenn diese Option ausgewählt ist, gibt die Aktion die Elemente zurück, die in jeder Netzwerkliste enthalten sind. |
Include Activation Status |
Optional. Wenn diese Option ausgewählt ist, gibt die Aktion den Aktivierungsstatus für jede übereinstimmende Netzwerkliste zurück. Die Aktion gibt diese Informationen nur zurück, wenn Sie einen Wert in |
Activation Environment |
Optional. Die Umgebung, für die der Aktivierungsstatus der Netzwerkliste zurückgegeben werden soll, wenn Sie Folgende Werte sind möglich:
Der Standardwert ist |
Max Network Lists To Return |
Erforderlich. Die maximale Anzahl der zurückzugebenden Netzwerklisten. Der Höchstwert ist Der Standardwert ist |
Max Network List Items To Return |
Erforderlich. Die maximale Anzahl von Elementen, die für jede Netzwerkliste zurückgegeben werden sollen. Der Höchstwert ist Der Standardwert ist |
Aktionsausgaben
Die Aktion Netzwerklisten abrufen liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Netzwerklisten abrufen erhalten:
[
{
"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/"
}
}
}
}
]
Ausgabenachrichten
Die Aktion Netzwerklisten abrufen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully returned network lists from Akamai. |
Die Aktion war erfolgreich. |
No network lists were found for the provided criteria in
Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob die angegebenen Namen oder IDs der Netzwerkliste in Akamai vorhanden sind und ob die Namen bei der Suche nach |
Error executing action "Get Network Lists". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, ob die maximalen Rückgabeparameter zwischen |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Netzwerklisten abrufen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Ping
Verwenden Sie die Aktion Ping, um die Verbindung zu testen und Ihre Authentifizierungsdaten mit dem Akamai-Server zu validieren.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Keine.
Aktionsausgaben
Die Aktion Ping liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Nicht verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
Ausgabenachrichten
Die Aktion Ping liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
Die Aktion war erfolgreich. |
Failed to connect to the Akamai server! Error is
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob die |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Ping verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Elemente aus Kundenliste entfernen
Verwenden Sie die Aktion Elemente aus Clientliste entfernen, um ein oder mehrere Elemente aus einer vorhandenen Clientliste in Akamai zu entfernen.
Die Aktion verarbeitet jedes Element einzeln und meldet im JSON-Ergebnis den status-Wert removed, doesn't exist (wenn das Element nicht in der Liste enthalten ist) oder failed. Wenn Sie Elemente entfernen, wird die Clientliste in Akamai aktualisiert. Die Änderungen werden jedoch erst am Akamai-Edge wirksam, wenn Sie die Aktion Clientliste aktivieren für die Zielumgebung ausführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Elemente aus Clientliste entfernen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Client List Name |
Optional. Der Name der zu aktualisierenden Kundenliste. Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht berücksichtigt. Sie müssen entweder |
Client List ID |
Optional. Die eindeutige Kennung der zu aktualisierenden Kundenliste. Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht berücksichtigt. Sie müssen entweder |
Item Value |
Erforderlich. Eine durch Kommas getrennte Liste von Elementwerten, die aus der Clientliste entfernt werden sollen. |
Aktionsausgaben
Die Aktion Elemente aus Clientliste entfernen liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Elemente aus der Clientliste entfernen empfangen wird:
[
{
"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"
}
]
Ausgabenachrichten
Die Aktion Elemente aus Clientliste entfernen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully updated client list in Akamai. |
Die Aktion war erfolgreich. Alle angegebenen Elemente wurden entweder aus der Kundenliste entfernt ( |
One or more items were not removed. See JSON results for
details. |
Mindestens ein angegebenes Element ( Wenn mindestens ein Element im Batch den Status |
Error executing action "Remove Items From Client List". Reason:
provide a value in "Client List Name" or "Client List ID"
parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Remove Items From Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Clientliste in Akamai vorhanden ist und ob Ihre API-Anmeldedaten Zugriff auf Clientlisten haben. |
Error executing action "Remove Items From Client List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, das Format des Parameters |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Elemente aus der Clientliste entfernen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Elemente aus Netzwerkliste entfernen
Verwenden Sie die Aktion Elemente aus Netzwerkliste entfernen, um ein oder mehrere Elemente aus einer vorhandenen Netzwerkliste in Akamai zu entfernen.
Wenn Sie Elemente entfernen, wird die Netzwerkliste in Akamai aktualisiert. Die Änderungen werden jedoch erst am Akamai-Edge wirksam, wenn Sie die Aktion Netzwerkliste aktivieren für die Zielumgebung ausführen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Elemente aus Netzwerkliste entfernen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Network List Name |
Optional. Der Name der zu aktualisierenden Netzwerkliste. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden. Sie müssen entweder |
Network List ID |
Optional. Die eindeutige Kennung der zu aktualisierenden Netzwerkliste. Sie müssen entweder |
Items |
Erforderlich. Eine durch Kommas getrennte Liste von Elementen, die aus der Netzwerkliste entfernt werden sollen. |
Aktionsausgaben
Die Aktion Elemente aus Netzwerkliste entfernen liefert die folgenden Ausgaben:
| Ausgabetyp der Aktion | Verfügbarkeit |
|---|---|
| Anhang im Fall-Repository | Nicht verfügbar |
| Link zum Fall-Repository | Nicht verfügbar |
| Tabelle im Fall-Repository | Nicht verfügbar |
| Anreicherungstabelle | Nicht verfügbar |
| JSON-Ergebnis | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie erhalten, wenn Sie die Aktion Elemente aus Netzwerkliste entfernen verwenden:
[
{
"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"
}
}
}
]
Ausgabenachrichten
Die Aktion Elemente aus Netzwerkliste entfernen liefert die folgenden Ausgabenachrichten:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
Successfully updated network list in Akamai. |
Die Aktion war erfolgreich. Wenn Sie im Parameter |
None of the provided items were found in the network list in
Akamai. |
Die Aktion konnte keines der angegebenen Elemente entfernen. Prüfen Sie, ob die im Parameter |
No valid items provided for removal. Please provide a
comma-separated list of items. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Remove Items From Network List". Reason:
provide a value in "Network List Name" or "Network List ID"
parameter. |
Die Aktion ist fehlgeschlagen. Geben Sie im Parameter |
Error executing action "Remove Items From Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
Die Aktion ist fehlgeschlagen. Prüfen Sie, ob der angegebene Name oder die ID der Netzwerkliste in Akamai vorhanden ist und ob der Name bei der Suche nach |
Error executing action "Remove Items From Network List". Reason:
ERROR_REASON |
Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Akamai-Server, das Format des Parameters |
Scriptergebnis
In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Elemente aus Netzwerkliste entfernen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
true oder false |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten