Intégrer Akamai à Google SecOps
Ce document explique comment intégrer Akamai à Google Security Operations (Google SecOps).
Version de l'intégration : 1.0
Paramètres d'intégration
L'intégration Akamai nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Host |
Obligatoire. Nom d'hôte de l'instance Akamai. |
Client Token |
Obligatoire. Votre jeton client Akamai. |
Client Secret |
Obligatoire. Votre code secret client Akamai. |
Access Token |
Obligatoire. Votre jeton d'accès Akamai. |
Verify SSL |
Obligatoire. Valide le certificat SSL lors de la connexion à Akamai. Cette option est sélectionnée par défaut. |
Actions
Pour en savoir plus sur les actions, consultez Répondre aux actions en attente dans Votre espace de travail et Effectuer une action manuelle.
Ping
Utilisez l'action Ping pour tester la connectivité à Akamai.
Cette action ne s'exécute pas sur les entités Google SecOps et ne comporte pas de paramètres d'entrée.
Sorties d'action
L'action Ping fournit les résultats suivants :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Non disponible |
Résultat du script | Disponible |
Messages de sortie
L'action Ping fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
Action effectuée. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Ping :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Obtenir des listes de réseaux
Utilisez l'action Get Network Lists pour obtenir des informations sur les listes d'un réseau dans Akamai.
Entrées d'action
L'action Get Network Lists (Obtenir les listes de réseaux) nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Network List Name |
Facultatif. Liste de noms de listes de réseaux à rechercher, séparés par une virgule. |
Network List ID |
Facultatif. Liste d'ID de listes de réseaux à rechercher, séparés par une virgule. |
Include Items |
Facultatif. Renvoie des informations sur les éléments des listes de réseaux. La valeur par défaut est |
Include Activation Status |
Facultatif. Renvoie l'état d'activation de chaque liste de réseaux. La valeur par défaut est Remarque : Ces informations ne sont renvoyées que si |
Activation Environment |
Facultatif. Environnement pour lequel l'état d'activation est renvoyé. Les valeurs possibles sont les suivantes :
Remarque : Ces informations ne sont renvoyées que si |
Max Network Lists To Return |
Obligatoire. Nombre maximal de listes de réseaux à renvoyer. La valeur par défaut et maximale est |
Max Network List Items To Return |
Obligatoire. Nombre maximal d'éléments à renvoyer par liste de réseaux. La valeur par défaut et maximale est |
Sorties d'action
L'action Obtenir les listes de réseaux fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Get Network Lists (Obtenir les listes de réseaux) :
[
{
"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/"
}
}
}
}
]
Messages de sortie
L'action Obtenir les listes de réseaux fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
|
Action effectuée. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Obtenir les listes de réseaux :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Ajouter des éléments à la liste des réseaux
Utilisez l'action Add Items To Network List (Ajouter des éléments à la liste du réseau) pour ajouter des éléments à la liste du réseau dans Akamai.
Entrées d'action
L'action Ajouter des éléments à la liste du réseau nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Network List Name |
Facultatif. Nom de la liste de réseaux à mettre à jour. Si |
Network List ID |
Facultatif. ID de la liste de réseaux à mettre à jour. Si |
Items |
Obligatoire. Liste d'éléments à ajouter à la liste du réseau, séparés par une virgule. |
Sorties d'action
L'action Ajouter des éléments à la liste du réseau fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Ajouter des éléments aux listes de réseaux :
{
"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"
}
}
}
Messages de sortie
L'action Ajouter des éléments à la liste des réseaux fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
Successfully updated network list in Akamai. |
Action effectuée. |
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Ajouter des éléments à la liste du réseau :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Supprimer des éléments de la liste des réseaux
Utilisez l'action Remove Items From Network List (Supprimer des éléments de la liste du réseau) pour supprimer des éléments de la liste du réseau dans Akamai.
Entrées d'action
L'action Supprimer des éléments de la liste des réseaux nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Network List Name |
Facultatif. Nom de la liste de réseaux à mettre à jour. Si |
Network List ID |
Facultatif. ID de la liste de réseaux à mettre à jour. Si |
Items |
Obligatoire. Liste d'éléments à supprimer de la liste des réseaux, séparés par une virgule. |
Sorties d'action
L'action Supprimer des éléments de la liste des réseaux fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Supprimer des éléments des listes de réseaux :
{
"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"
}
}
}
Messages de sortie
L'action Remove Items From Network List (Supprimer des éléments de la liste des réseaux) fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
|
Action effectuée. |
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Remove Items From Network List (Supprimer des éléments de la liste du réseau) :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Activer la liste des réseaux
Utilisez l'action Activate Network List (Activer la liste de réseaux) pour supprimer des éléments de la liste de réseaux dans Akamai.
Entrées d'action
L'action Activer la liste de réseaux nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Network List Name |
Facultatif. Nom de la liste de réseaux à mettre à jour. Si |
Network List ID |
Facultatif. ID de la liste de réseaux à mettre à jour. Si |
Environment |
Facultatif. Environnement cible pour l'activation. Les valeurs possibles sont les suivantes :
|
Comment |
Facultatif. Commentaire décrivant l'objectif de l'activation. |
Notification Recipients |
Facultatif. Liste d'adresses e-mail séparées par une virgule auxquelles envoyer une notification concernant l'activation de la liste de réseaux. |
Sorties d'action
L'action Activer la liste des réseaux fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Activer les listes de réseaux :
{
"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/"
}
}
}
Messages de sortie
L'action Activate Network List (Activer la liste des réseaux) fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
Successfully activated the network list in Akamai. |
Action effectuée. |
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Activate Network List (Activer la liste des réseaux) :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Obtenir des listes de clients
Utilisez l'action Get Client Lists pour obtenir des informations sur les listes de clients dans Akamai.
Entrées d'action
L'action Get Client Lists (Obtenir les listes de clients) nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Client List Name |
Facultatif. Liste de noms de listes de clients à rechercher, séparés par une virgule. |
Client List ID |
Facultatif. Liste d'ID de listes de clients à rechercher, séparés par une virgule. |
Include Items |
Facultatif. Renvoie des informations sur les éléments de la liste de clients. La valeur par défaut est Remarque : Ces informations ne sont renvoyées que si |
Type |
Facultatif. Type de liste de clients à rechercher. Les valeurs possibles sont les suivantes :
ASN TLS Fingerprint File Hash Remarque : Si |
Max Client Lists To Return |
Obligatoire. Nombre maximal de listes de clients à renvoyer. La valeur par défaut et maximale est |
Max Client List Items To Return |
Obligatoire. Nombre maximal d'éléments à renvoyer par liste de clients. La valeur par défaut et maximale est |
Sorties d'action
L'action Obtenir les listes de clients fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON obtenu lors de l'utilisation de l'action Obtenir les listes de clients :
[
{
"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
}
]
Messages de sortie
L'action Obtenir les listes de clients fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
|
Action effectuée. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Obtenir les listes de clients :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Ajouter des éléments à la liste de clients
Utilisez l'action Add Items To Client List (Ajouter des éléments à la liste de clients) pour ajouter des éléments à la liste de clients dans Akamai.
Entrées d'action
L'action Ajouter des éléments à la liste de clients nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Client List Name |
Facultatif. Nom de la liste de clients à mettre à jour. Remarque : Si |
Client List ID |
Facultatif. ID de la liste de clients à mettre à jour. Remarque : Si |
Item Value |
Obligatoire. Liste d'éléments à ajouter à la liste des clients, séparés par une virgule. |
Item Description |
Facultatif. Description des éléments ajoutés à la liste de clients. |
Item Expiration Date |
Facultatif. Date d'expiration des articles ajoutés, au format ISO 8601. |
Item Tags |
Facultatif. Liste de tags séparés par une virgule à associer aux éléments ajoutés. |
Sorties d'action
L'action Ajouter des éléments à la liste de clients fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Ajouter des éléments à la liste des clients :
[
{
"createDate": "2023-04-05T19:29:02.320+00:00",
"createdBy": "jkowalski",
"description": "Jamaica - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T19:29:02.320+00:00",
"updatedBy": "jdupont",
"value": "JM"
}
}
]
Messages de sortie
L'action Ajouter des éléments à la liste de clients fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
Successfully returned client lists from Akamai. |
Action effectuée. |
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Ajouter des éléments à la liste des clients :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Supprimer des éléments de la liste des clients
Utilisez l'action Remove Items From Client List (Supprimer des éléments de la liste des clients) pour supprimer des éléments de la liste des clients dans Akamai.
Entrées d'action
L'action Supprimer des éléments de la liste de clients nécessite les paramètres suivants :
Paramètre | Description |
---|---|
Client List Name |
Facultatif. Nom de la liste de clients à mettre à jour. Remarque : Si |
Client List ID |
Facultatif. ID de la liste de clients à mettre à jour. Remarque : Si |
Item Value |
Obligatoire. Liste d'éléments à supprimer de la liste des clients, séparés par une virgule. |
Sorties d'action
L'action Supprimer des éléments de la liste de clients fournit les sorties suivantes :
Type de sortie de l'action | Disponibilité |
---|---|
Pièce jointe au mur des cas | Non disponible |
Lien vers le mur des cas | Non disponible |
Table du mur des cas | Non disponible |
Table d'enrichissement | Non disponible |
Résultat JSON | Disponible |
Résultat du script | Disponible |
Résultat JSON
L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Remove Items From Client List (Supprimer des éléments de la liste des clients) :
[
{
"createDate": "2023-04-05T19:29:02.320+00:00",
"createdBy": "jkowalski",
"description": "Jamaica - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T19:29:02.320+00:00",
"updatedBy": "jdupont",
"value": "JM"
}
]
Messages de sortie
L'action Remove Items From Client List (Supprimer des éléments de la liste de clients) fournit les messages de sortie suivants :
Message affiché | Description du message |
---|---|
|
Action effectuée. |
|
Échec de l'action. |
Résultat du script
Le tableau suivant décrit les valeurs du résultat du script lorsque vous utilisez l'action Remove Items From Client List (Supprimer des éléments de la liste des clients) :
Nom du résultat du script | Valeur |
---|---|
is_success |
True ou False |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.