Integre a Akamai com o Google SecOps
Este documento explica como integrar o Akamai com o Google Security Operations (Google SecOps).
Versão da integração: 1.0
Parâmetros de integração
A integração do Akamai requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Host |
Obrigatório. O nome do anfitrião da instância da Akamai. |
Client Token |
Obrigatório. O seu token de cliente da Akamai. |
Client Secret |
Obrigatório. O segredo do cliente da Akamai. |
Access Token |
Obrigatório. A sua chave de acesso da Akamai. |
Verify SSL |
Obrigatório. Valida o certificado SSL quando se liga à Akamai. Selecionado por predefinição. |
Ações
Para mais informações sobre ações, consulte os artigos Responda a ações pendentes a partir de O seu espaço de trabalho e Realize uma ação manual.
Tchim-tchim
Use a ação Ping para testar a conetividade com a Akamai.
Esta ação não é executada em entidades do Google SecOps e não tem parâmetros de entrada.
Resultados da ação
A ação Ping fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Não disponível |
Resultado do script | Disponível |
Mensagens de saída
A ação Ping apresenta as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
Ação efetuada com êxito. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores para o resultado do script quando usa a ação Ping:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Obtenha listas de redes
Use a ação Get Network Lists para obter informações sobre as listas de uma rede no Akamai.
Dados de ações
A ação Get Network Lists requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. Uma lista separada por vírgulas de nomes de listas de redes a pesquisar. |
Network List ID |
Opcional. Uma lista de IDs de listas de redes separados por vírgulas a pesquisar. |
Include Items |
Opcional. Devolve informações sobre os itens nas listas de redes. O valor predefinido é |
Include Activation Status |
Opcional. Devolve o estado de ativação de cada lista de redes. O valor predefinido é Nota: estas informações só são devolvidas se forem fornecidas |
Activation Environment |
Opcional. O ambiente para o qual é devolvido o estado de ativação. Os valores possíveis são os seguintes:
Nota: estas informações só são devolvidas se forem fornecidas |
Max Network Lists To Return |
Obrigatório. O número máximo de listas de redes a devolver. O valor predefinido e máximo é |
Max Network List Items To Return |
Obrigatório. O número máximo de itens a devolver por lista de redes. O valor predefinido e máximo é |
Resultados da ação
A ação Get Network Lists fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação 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/"
}
}
}
}
]
Mensagens de saída
A ação Get Network Lists apresenta as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
|
Ação efetuada com êxito. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Get Network Lists:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Adicione itens à lista de redes
Use a ação Adicionar itens à lista de redes para adicionar itens à lista de redes no Akamai.
Dados de ações
A ação Adicionar itens à lista de redes requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de redes a atualizar. Se |
Network List ID |
Opcional. O ID da lista de redes a atualizar. Se |
Items |
Obrigatório. Uma lista de itens separados por vírgulas a adicionar à lista de redes. |
Resultados da ação
A ação Adicionar itens à lista de redes fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação Adicionar itens a 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"
}
}
}
Mensagens de saída
A ação Adicionar itens à lista de redes fornece as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
Successfully updated network list in Akamai. |
Ação efetuada com êxito. |
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores para o resultado do script quando usa a ação Add Items To Network List (Adicionar itens à lista de redes):
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Remova itens da lista de redes
Use a ação Remover itens da lista de rede para remover itens da lista de rede no Akamai.
Dados de ações
A ação Remover itens da lista de redes requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de redes a atualizar. Se |
Network List ID |
Opcional. O ID da lista de redes a atualizar. Se |
Items |
Obrigatório. Uma lista de itens separados por vírgulas a remover da lista de redes. |
Resultados da ação
A ação Remover itens da lista de redes fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação Remover itens de 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"
}
}
}
Mensagens de saída
A ação Remover itens da lista de redes fornece as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
|
Ação efetuada com êxito. |
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Remover itens da lista de redes:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Ative a lista de redes
Use a ação Ativar lista de redes para remover itens da lista de redes no Akamai.
Dados de ações
A ação Activate Network List requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de redes a atualizar. Se |
Network List ID |
Opcional. O ID da lista de redes a atualizar. Se |
Environment |
Opcional. O ambiente de destino para a ativação. Os valores possíveis são os seguintes:
|
Comment |
Opcional. Um comentário que descreve a finalidade da ativação. |
Notification Recipients |
Opcional. Uma lista de endereços de email separados por vírgulas para enviar uma notificação sobre a ativação da lista de redes. |
Resultados da ação
A ação Activate Network List fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação 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/"
}
}
}
Mensagens de saída
A ação Activate Network List apresenta as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
Successfully activated the network list in Akamai. |
Ação efetuada com êxito. |
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Activate Network List:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Obtenha listas de clientes
Use a ação Get Client Lists para obter informações sobre listas de clientes no Akamai.
Dados de ações
A ação Get Client Lists requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Client List Name |
Opcional. Uma lista separada por vírgulas de nomes de listas de clientes a pesquisar. |
Client List ID |
Opcional. Uma lista de IDs de listas de clientes separados por vírgulas para pesquisar. |
Include Items |
Opcional. Devolve informações sobre os artigos na lista de clientes. O valor predefinido é Nota: estas informações só são devolvidas se forem fornecidas |
Type |
Opcional. O tipo de lista de clientes a pesquisar. Os valores possíveis são os seguintes:
ASN TLS Fingerprint File Hash Nota: se for fornecido |
Max Client Lists To Return |
Obrigatório. O número máximo de listas de clientes a devolver. O valor predefinido e máximo é |
Max Client List Items To Return |
Obrigatório. O número máximo de itens a devolver por lista de clientes. O valor predefinido e máximo é |
Resultados da ação
A ação Get Client Lists fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação 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
}
]
Mensagens de saída
A ação Get Client Lists fornece as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
|
Ação efetuada com êxito. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Get Client Lists:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Adicione itens à lista de clientes
Use a ação Add Items To Client List para adicionar itens à lista de clientes no Akamai.
Dados de ações
A ação Adicionar itens à lista de clientes requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Client List Name |
Opcional. O nome da lista de clientes a atualizar. Nota: se forem fornecidos |
Client List ID |
Opcional. O ID da lista de clientes a atualizar. Nota: se forem fornecidos |
Item Value |
Obrigatório. Uma lista de itens separados por vírgulas a adicionar à lista de clientes. |
Item Description |
Opcional. Uma descrição dos artigos adicionados à lista de clientes. |
Item Expiration Date |
Opcional. Uma data de validade para os artigos adicionados, no formato ISO 8601. |
Item Tags |
Opcional. Uma lista de etiquetas separadas por vírgulas a associar aos itens adicionados. |
Resultados da ação
A ação AddItemsToClientList fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação Adicionar itens à 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"
}
}
]
Mensagens de saída
A ação AddItemsToClientList fornece as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
Successfully returned client lists from Akamai. |
Ação efetuada com êxito. |
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Adicionar itens à lista de clientes:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Remova itens da lista de clientes
Use a ação Remover itens da lista de clientes para remover itens da lista de clientes no Akamai.
Dados de ações
A ação Remover itens da lista de clientes requer os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Client List Name |
Opcional. O nome da lista de clientes a atualizar. Nota: se forem fornecidos |
Client List ID |
Opcional. O ID da lista de clientes a atualizar. Nota: se forem fornecidos |
Item Value |
Obrigatório. Uma lista de itens separados por vírgulas a remover da lista de clientes. |
Resultados da ação
A ação Remover itens da lista de clientes fornece os seguintes resultados:
Tipo de saída da ação | Disponibilidade |
---|---|
Fixação à parede da caixa | Não disponível |
Link da parede da caixa | Não disponível |
Mesa de parede para caixas | Não disponível |
Tabela de enriquecimento | Não disponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação 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"
}
]
Mensagens de saída
A ação Remove Items From Client List (Remover itens da lista de clientes) fornece as seguintes mensagens de saída:
Mensagem de saída | Descrição da mensagem |
---|---|
|
Ação efetuada com êxito. |
|
Falha na ação. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Remover itens da lista de clientes:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.