Integra 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. Es el nombre de host de la instancia de Akamai. |
Client Token |
Obligatorio. Es tu token de cliente de Akamai. |
Client Secret |
Obligatorio. Es tu secreto del cliente de Akamai. |
Access Token |
Obligatorio. Es tu token de acceso de Akamai. |
Verify SSL |
Obligatorio. Valida el certificado SSL cuando se conecta a Akamai. Esta opción se selecciona de forma predeterminada. |
Acciones
Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes de Tu Workdesk y Cómo realizar una acción manual.
Ping
Usa la acción Ping para probar la conectividad a 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 los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | No disponible |
Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Ping proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
La acción se completó correctamente. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Ping:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Obtén listas de redes
Usa la acción Get Network Lists para obtener información sobre las listas de una red en Akamai.
Entradas de acción
La acción Get Network Lists requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Es una lista separada por comas de los nombres de las listas de redes que se buscarán. |
Network List ID |
Opcional. Es una lista separada por comas de los IDs de la lista de redes que se deben buscar. |
Include Items |
Opcional. Devuelve información sobre los elementos dentro 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. Es 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. Es la cantidad máxima de listas de redes que se devolverán. El valor predeterminado y máximo es |
Max Network List Items To Return |
Obligatorio. Es la cantidad máxima 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 Get Network Lists proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Get Network Lists:
[
{
"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 proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
|
La acción se completó correctamente. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Get Network Lists:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Agregar elementos a la lista de la red
Usa la acción Add Items To Network List para agregar elementos a la lista de redes en Akamai.
Entradas de acción
La acción Add Items To Network List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Es el nombre de la lista de redes que se actualizará. Si se proporcionan |
Network List ID |
Opcional. Es el ID de la lista de redes que se actualizará. Si se proporcionan |
Items |
Obligatorio. Es una lista de elementos separados por comas que se agregarán a la lista de redes. |
Resultados de la acción
La acción Add Items To Network List proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Add Items To Network Lists:
{
"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 Add Items To Network List proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
Successfully updated network list in Akamai. |
La acción se completó correctamente. |
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Add Items To Network List:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Cómo quitar elementos de la lista de redes
Usa la acción Remove Items From Network List para quitar elementos de la lista de redes en Akamai.
Entradas de acción
La acción Remove Items From Network List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Es el nombre de la lista de redes que se actualizará. Si se proporcionan |
Network List ID |
Opcional. Es el ID de la lista de redes que se actualizará. Si se proporcionan |
Items |
Obligatorio. Es una lista de elementos separados por comas que se quitarán de la lista de redes. |
Resultados de la acción
La acción Remove Items From Network List proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado en JSON que se recibe cuando se usa la acción Remove Items From Network Lists:
{
"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 proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
|
La acción se completó correctamente. |
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado del script cuando se usa la acción Remove Items From Network List:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Activar lista de redes
Usa la acción Activate Network List para quitar elementos de la lista de redes en Akamai.
Entradas de acción
La acción Activate Network List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Network List Name |
Opcional. Es el nombre de la lista de redes que se actualizará. Si se proporcionan |
Network List ID |
Opcional. Es el ID de la lista de redes que se actualizará. Si se proporcionan |
Environment |
Opcional. Es el entorno de destino para la activación. Los valores posibles son los siguientes:
|
Comment |
Opcional. Es un comentario que describe el propósito de la activación. |
Notification Recipients |
Opcional. Lista separada por comas de las direcciones de correo electrónico a las que se enviará una notificación sobre la activación de la lista de redes. |
Resultados de la acción
La acción Activate Network List proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado en formato JSON que se recibe cuando se usa la acción Activate Network Lists:
{
"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 Activate Network List proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
Successfully activated the network list in Akamai. |
La acción se completó correctamente. |
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Activate Network List:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Obtén listas de clientes
Usa la acción Get Client Lists para obtener información sobre las listas de clientes en Akamai.
Entradas de acción
La acción Get Client Lists requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Es una lista separada por comas de los nombres de las listas de clientes que se buscarán. |
Client List ID |
Opcional. Es una lista separada por comas de los IDs de la lista de clientes que se deben 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. Es el tipo de lista de clientes que se buscará. Los valores posibles son los siguientes:
ASN TLS Fingerprint File Hash Nota: Si se proporciona |
Max Client Lists To Return |
Obligatorio. Es la cantidad máxima de listas de clientes que se devolverán. El valor predeterminado y máximo es |
Max Client List Items To Return |
Obligatorio. Es la cantidad máxima 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 Get Client Lists proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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
}
]
Mensajes de salida
La acción Get Client Lists proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
|
La acción se completó correctamente. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Get Client Lists:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Agregar elementos a la lista de clientes
Usa la acción Add Items To Client List para agregar elementos a la lista de clientes en Akamai.
Entradas de acción
La acción Add Items To Client List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Es el nombre de la lista de clientes que se actualizará. Nota: Si se proporcionan |
Client List ID |
Opcional. Es el ID de la lista de clientes que se actualizará. Nota: Si se proporcionan |
Item Value |
Obligatorio. Es una lista de elementos separados por comas que se agregarán a la lista de clientes. |
Item Description |
Opcional. Es una descripción de los elementos agregados a la lista de clientes. |
Item Expiration Date |
Opcional. Es la fecha de vencimiento de los elementos agregados, en formato ISO 8601. |
Item Tags |
Opcional. Es una lista de etiquetas separadas por comas para asociar con los elementos agregados. |
Resultados de la acción
La acción Add Items To Client List proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Add Items To Client List:
[
{
"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 Add Items To Client List proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
Successfully returned client lists from Akamai. |
La acción se completó correctamente. |
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado del script cuando se usa la acción Add Items To Client List:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
Cómo quitar elementos de la lista de clientes
Usa la acción Remove Items From Client List para quitar elementos de la lista de clientes en Akamai.
Entradas de acción
La acción Remove Items From Client List requiere los siguientes parámetros:
Parámetro | Descripción |
---|---|
Client List Name |
Opcional. Es el nombre de la lista de clientes que se actualizará. Nota: Si se proporcionan |
Client List ID |
Opcional. Es el ID de la lista de clientes que se actualizará. Nota: Si se proporcionan |
Item Value |
Obligatorio. Es una lista de elementos separados por comas que se quitarán de la lista del cliente. |
Resultados de la acción
La acción Remove Items From Client List proporciona los siguientes resultados:
Tipo de salida de la acción | Disponibilidad |
---|---|
Adjunto del muro de casos | No disponible |
Vínculo al muro de casos | No disponible |
Tabla del muro de casos | No disponible |
Tabla de enriquecimiento | No disponible |
Resultado de JSON | Disponible |
Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Remove Items From Client List:
[
{
"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 Remove Items From Client List proporciona los siguientes mensajes de salida:
Mensaje de salida | Descripción del mensaje |
---|---|
|
La acción se completó correctamente. |
|
No se pudo realizar la acción. |
Resultado de secuencia de comandos
En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Remove Items From Client List:
Nombre del resultado de la secuencia de comandos | Valor |
---|---|
is_success |
True o False |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.