Integrar Akamai con Google SecOps
En este documento se explica cómo integrar Akamai con Google Security Operations (Google SecOps).
Versión de la integración: 1.0
Parámetros de integración
La integración de Akamai requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Host |
Obligatorio. Nombre de host de la instancia de Akamai. |
Client Token |
Obligatorio. Tu token de cliente de Akamai. |
Client Secret |
Obligatorio. Tu secreto de cliente de Akamai. |
Access Token |
Obligatorio. Tu token de acceso de Akamai. |
Verify SSL |
Obligatorio. Valida el certificado SSL al conectarse a Akamai. Esta opción está seleccionada de forma predeterminada. |
Acciones
Para obtener más información sobre las acciones, consulta Responder a las acciones pendientes de Mi mesa de trabajo y Realizar una acción manual.
Ping
Usa la acción Ping para probar la conectividad con Akamai.
Esta acción no se ejecuta en entidades de Google SecOps y no tiene parámetros de entrada.
Resultados de la acción
La acción Ping proporciona las siguientes salidas:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | No disponible |
Resultado de la secuencia de comandos | Disponible |
Mensajes de salida
La acción Ping proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
La acción se ha realizado correctamente. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Ping:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Obtener listas de redes
Usa la acción Get Network Lists (Obtener listas de redes) para obtener información sobre las listas de una red en Akamai.
Entradas de acciones
La acción Get Network Lists requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Lista de nombres de listas de redes separada por comas que se va a buscar. |
Network List ID |
Opcional. Lista separada por comas de IDs de listas de cadenas que se van a buscar. |
Include Items |
Opcional. Devuelve información sobre los elementos de las listas de redes. El valor predeterminado es |
Include Activation Status |
Opcional. Devuelve el estado de activación de cada lista de redes. El valor predeterminado es Nota: Esta información solo se devuelve si se proporciona |
Activation Environment |
Opcional. El entorno para el que se devuelve el estado de activación. Los valores posibles son los siguientes:
Nota: Esta información solo se devuelve si se proporciona |
Max Network Lists To Return |
Obligatorio. Número máximo de listas de redes que se devolverán. El valor predeterminado y máximo es |
Max Network List Items To Return |
Obligatorio. Número máximo de elementos que se devolverán por lista de redes. El valor predeterminado y máximo es |
Resultados de la acción
La acción Obtener listas de redes proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe la salida del resultado JSON que se recibe al usar la acción Get Network Lists (Obtener listas de redes):
[
{
"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/"
}
}
}
}
]
Mensajes de salida
La acción Get Network Lists (Obtener listas de redes) proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
|
La acción se ha realizado correctamente. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Obtener listas de redes:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Añadir elementos a la lista de redes
Usa la acción Añadir elementos a la lista de redes para añadir elementos a la lista de redes en Akamai.
Entradas de acciones
La acción Añadir elementos a la lista de la red requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Nombre de la lista de redes que se va a actualizar. Si se proporcionan |
Network List ID |
Opcional. ID de la lista de redes que se va a actualizar. Si se proporcionan |
Items |
Obligatorio. Lista de elementos separados por comas que se van a añadir a la lista de la red. |
Resultados de la acción
La acción Añadir elementos a la lista de la red proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe la salida del resultado JSON que se recibe al usar la acción Añadir elementos a listas de la red:
{
"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"
}
}
}
Mensajes de salida
La acción Añadir elementos a la lista de la red proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
Successfully updated network list in Akamai. |
La acción se ha realizado correctamente. |
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Añadir elementos a la lista de la red:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Quitar elementos de la lista de redes
Usa la acción Remove Items From Network List (Eliminar elementos de la lista de redes) para quitar elementos de la lista de redes de Akamai.
Entradas de acciones
La acción Remove Items From Network List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Nombre de la lista de redes que se va a actualizar. Si se proporcionan |
Network List ID |
Opcional. ID de la lista de redes que se va a actualizar. Si se proporcionan |
Items |
Obligatorio. Lista separada por comas de los elementos que se van a quitar de la lista de la red. |
Resultados de la acción
La acción Quitar elementos de la lista de redes proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe el resultado en JSON que se recibe al usar la acción Remove Items From Network Lists (Quitar elementos de listas de la red):
{
"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"
}
}
}
Mensajes de salida
La acción Remove Items From Network List (Quitar elementos de la lista de la red) proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
|
La acción se ha realizado correctamente. |
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Quitar elementos de la lista de la red:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Activar lista de redes
Usa la acción Activar lista de redes para quitar elementos de la lista de redes en Akamai.
Entradas de acciones
La acción Activar lista de cadenas requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Nombre de la lista de redes que se va a actualizar. Si se proporcionan |
Network List ID |
Opcional. ID de la lista de redes que se va a actualizar. Si se proporcionan |
Environment |
Opcional. El entorno de destino de la activación. Los valores posibles son los siguientes:
|
Comment |
Opcional. Un comentario que describa el propósito de la activación. |
Notification Recipients |
Opcional. Lista de direcciones de correo separadas por comas a las que se debe enviar una notificación sobre la activación de la lista de la red. |
Resultados de la acción
La acción Activar lista de cadenas proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe el resultado en JSON que se recibe al usar la acción Activar listas de redes:
{
"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/"
}
}
}
Mensajes de salida
La acción Activar lista de cadenas proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
Successfully activated the network list in Akamai. |
La acción se ha realizado correctamente. |
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Activar lista de redes:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Get Client Lists
Usa la acción Get Client Lists (Obtener listas de clientes) para obtener información sobre las listas de clientes de Akamai.
Entradas de acciones
La acción Get Client Lists requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Lista de nombres de listas de clientes separados por comas que se van a buscar. |
Client List ID |
Opcional. Lista separada por comas de IDs de listas de clientes que se van a buscar. |
Include Items |
Opcional. Devuelve información sobre los elementos de la lista de clientes. El valor predeterminado es Nota: Esta información solo se devuelve si se proporciona |
Type |
Opcional. El tipo de lista de clientes que se va a buscar. Los valores posibles son los siguientes:
ASN TLS Fingerprint File Hash Nota: Si se proporciona |
Max Client Lists To Return |
Obligatorio. Número máximo de listas de clientes que se devolverán. El valor predeterminado y máximo es |
Max Client List Items To Return |
Obligatorio. Número máximo de elementos que se devolverán por lista de clientes. El valor predeterminado y máximo es |
Resultados de la acción
La acción Obtener listas de clientes proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe la salida del resultado JSON que se recibe al usar la acción Get Client Lists (Obtener listas de clientes):
[
{
"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
}
]
Mensajes de salida
La acción Obtener listas de clientes proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
|
La acción se ha realizado correctamente. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores de la salida del resultado de la secuencia de comandos al usar la acción Obtener listas de clientes:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Añadir elementos a la lista de clientes
Usa la acción Añadir elementos a la lista de clientes para añadir elementos a la lista de clientes en Akamai.
Entradas de acciones
La acción Añadir elementos a la lista de clientes requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Nombre de la lista de clientes que se va a actualizar. Nota: Si se proporcionan |
Client List ID |
Opcional. ID de la lista de clientes que se va a actualizar. Nota: Si se proporcionan |
Item Value |
Obligatorio. Lista de elementos separados por comas que se van a añadir a la lista de clientes. |
Item Description |
Opcional. Una descripción de los elementos añadidos a la lista de clientes. |
Item Expiration Date |
Opcional. Fecha de vencimiento de los elementos añadidos, en formato ISO 8601. |
Item Tags |
Opcional. Lista de etiquetas separadas por comas que se asociarán a los elementos añadidos. |
Resultados de la acción
La acción Añadir elementos a la lista de clientes proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe la salida del resultado JSON que se recibe al usar la acción Add Items To Client List (Añadir elementos a la lista de clientes):
[
{
"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"
}
}
]
Mensajes de salida
La acción Añadir elementos a la lista de clientes proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
Successfully returned client lists from Akamai. |
La acción se ha realizado correctamente. |
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores del resultado de la secuencia de comandos al usar la acción Añadir elementos a la lista de clientes:
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
Quitar elementos de la lista de clientes
Usa la acción Remove Items From Client List (Quitar elementos de la lista de clientes) para quitar elementos de la lista de clientes de Akamai.
Entradas de acciones
La acción Eliminar elementos de la lista de clientes requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Nombre de la lista de clientes que se va a actualizar. Nota: Si se proporcionan |
Client List ID |
Opcional. ID de la lista de clientes que se va a actualizar. Nota: Si se proporcionan |
Item Value |
Obligatorio. Lista de elementos separados por comas que se van a quitar de la lista de clientes. |
Resultados de la acción
La acción Quitar elementos de la lista de clientes proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del panel de casos | No disponible |
Enlace del panel de casos | No disponible |
Tabla del panel de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo se describe la salida del resultado JSON que se recibe al usar la acción Remove Items From Client List (Quitar elementos de la lista de clientes):
[
{
"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"
}
]
Mensajes de salida
La acción Quitar elementos de la lista de clientes proporciona los siguientes mensajes de salida:
Mensaje resultante | Descripción del mensaje |
---|---|
|
La acción se ha realizado correctamente. |
|
Ha fallado la acción. |
Resultado de la secuencia de comandos
En la siguiente tabla se describen los valores de la salida del resultado de la secuencia de comandos al usar la acción Remove Items From Client List (Quitar elementos de la lista de clientes):
Nombre del resultado del script | Valor |
---|---|
is_success |
True o False |
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.