Integrar a Akamai ao Google SecOps
Este documento explica como integrar a Akamai ao Google Security Operations (Google SecOps).
Versão da integração: 1.0
Parâmetros de integração
A integração com a Akamai exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Host |
Obrigatório. O nome do host da instância do Akamai. |
Client Token |
Obrigatório. Seu token de cliente da Akamai. |
Client Secret |
Obrigatório. Sua chave secreta do cliente da Akamai. |
Access Token |
Obrigatório. Seu token de acesso da Akamai. |
Verify SSL |
Obrigatório. Valida o certificado SSL ao se conectar à Akamai. Essa opção é selecionada por padrão. |
Ações
Para mais informações sobre ações, consulte Responder a ações pendentes na Sua mesa de trabalho e Realizar uma ação manual.
Ping
Use a ação Ping para testar a conectividade com a Akamai.
Essa ação não é executada em entidades do Google SecOps e não tem parâmetros de entrada.
Saídas de ação
A ação Ping fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Indisponível |
Resultado do script | Disponível |
Mensagens de saída
A ação Ping fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
A ação foi concluída. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Ping:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Receber listas de rede
Use a ação Get Network Lists para receber informações sobre as listas de uma rede na Akamai.
Entradas de ação
A ação Receber listas de rede exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. Uma lista separada por vírgulas de nomes de listas de rede a serem pesquisados. |
Network List ID |
Opcional. Uma lista separada por vírgulas de IDs de lista de rede a serem pesquisados. |
Include Items |
Opcional. Retorna informações sobre os itens nas listas de rede. O valor padrão é |
Include Activation Status |
Opcional. Retorna o status de ativação de cada lista de rede. O valor padrão é Observação: essas informações só serão retornadas se |
Activation Environment |
Opcional. O ambiente para o qual o status de ativação é retornado. Os valores possíveis são os seguintes:
Observação: essas informações só serão retornadas se |
Max Network Lists To Return |
Obrigatório. O número máximo de listas de rede a serem retornadas. O valor padrão e máximo é |
Max Network List Items To Return |
Obrigatório. O número máximo de itens a serem retornados por lista de rede. O valor padrão e máximo é |
Saídas de ação
A ação Receber listas de rede fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Receber listas de rede:
[
{
"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 Receber listas de rede fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
|
A ação foi concluída. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Receber listas de rede:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Adicionar itens à lista de rede
Use a ação Adicionar itens à lista de rede para incluir itens na lista de rede no Akamai.
Entradas de ação
A ação Adicionar itens à lista de rede exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de rede a ser atualizada. Se |
Network List ID |
Opcional. O ID da lista de rede a ser atualizada. Se |
Items |
Obrigatório. Uma lista separada por vírgulas de itens a serem adicionados à lista de redes. |
Saídas de ação
A ação Adicionar itens à lista de rede fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída de resultado JSON recebida ao usar a ação Adicionar itens às listas de rede:
{
"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 rede fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
Successfully updated network list in Akamai. |
A ação foi concluída. |
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Adicionar itens à lista de rede:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Remover itens da lista de rede
Use a ação Remover itens da lista de rede para remover itens da lista de rede no Akamai.
Entradas de ação
A ação Remover itens da lista de rede exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de rede a ser atualizada. Se |
Network List ID |
Opcional. O ID da lista de rede a ser atualizada. Se |
Items |
Obrigatório. Uma lista separada por vírgulas de itens a serem removidos da lista de rede. |
Saídas de ação
A ação Remover itens da lista de rede fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Remover itens das listas de rede:
{
"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 rede fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
|
A ação foi concluída. |
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Remover itens da lista de rede:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Ativar lista de redes
Use a ação Ativar lista de rede para remover itens da lista de rede no Akamai.
Entradas de ação
A ação Ativar lista de rede exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Network List Name |
Opcional. O nome da lista de rede a ser atualizada. Se |
Network List ID |
Opcional. O ID da lista de rede a ser atualizada. 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 separada por vírgulas de endereços de e-mail para notificar sobre a ativação da lista de rede. |
Saídas de ação
A ação Ativar lista de rede fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Ativar listas de rede:
{
"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 Ativar lista de rede fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
Successfully activated the network list in Akamai. |
A ação foi concluída. |
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Ativar lista de rede:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Acessar listas de clientes
Use a ação Receber listas de clientes para ter informações sobre as listas de clientes no Akamai.
Entradas de ação
A ação Receber listas de clientes exige 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 serem pesquisados. |
Client List ID |
Opcional. Uma lista separada por vírgulas de IDs de lista de clientes para pesquisar. |
Include Items |
Opcional. Retorna informações sobre os itens na lista de clientes. O valor padrão é Observação: essas informações só serão retornadas se |
Type |
Opcional. O tipo de lista de clientes a ser pesquisada. Os valores possíveis são os seguintes:
ASN TLS Fingerprint File Hash Observação: se |
Max Client Lists To Return |
Obrigatório. O número máximo de listas de clientes a serem retornadas. O valor padrão e máximo é |
Max Client List Items To Return |
Obrigatório. O número máximo de itens a serem retornados por lista de clientes. O valor padrão e máximo é |
Saídas de ação
A ação GetClientLists fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Receber 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
}
]
Mensagens de saída
A ação Receber listas de clientes fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
|
A ação foi concluída. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Receber listas de clientes:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Adicionar itens à lista de clientes
Use a ação Adicionar itens à lista de clientes para incluir itens na lista de clientes da Akamai.
Entradas de ação
A ação Adicionar itens à lista de clientes exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Client List Name |
Opcional. O nome da lista de clientes a ser atualizada. Observação: se |
Client List ID |
Opcional. O ID da lista de clientes a ser atualizada. Observação: se |
Item Value |
Obrigatório. Uma lista separada por vírgulas de itens a serem adicionados à lista de clientes. |
Item Description |
Opcional. Uma descrição dos itens adicionados à lista de clientes. |
Item Expiration Date |
Opcional. Uma data de validade para os itens adicionados, no formato ISO 8601. |
Item Tags |
Opcional. Uma lista separada por vírgulas de tags a serem associadas aos itens adicionados. |
Saídas de ação
A ação Adicionar itens à lista de clientes fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída do resultado JSON recebida ao usar 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 Adicionar itens à lista de clientes fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
Successfully returned client lists from Akamai. |
A ação foi concluída. |
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar a ação Adicionar itens à lista de clientes:
Nome do resultado do script | Valor |
---|---|
is_success |
True ou False |
Remover itens da lista de clientes
Use a ação Remover itens da lista de clientes para remover itens da lista de clientes no Akamai.
Entradas de ação
A ação Remover itens da lista de clientes exige os seguintes parâmetros:
Parâmetro | Descrição |
---|---|
Client List Name |
Opcional. O nome da lista de clientes a ser atualizada. Observação: se |
Client List ID |
Opcional. O ID da lista de clientes a ser atualizada. Observação: se |
Item Value |
Obrigatório. Uma lista separada por vírgulas de itens a serem removidos da lista de clientes. |
Saídas de ação
A ação Remover itens da lista de clientes fornece as seguintes saídas:
Tipo de saída da ação | Disponibilidade |
---|---|
Anexo do Painel de Casos | Indisponível |
Link do Painel de Casos | Indisponível |
Tabela do painel de casos | Indisponível |
Tabela de enriquecimento | Indisponível |
Resultado JSON | Disponível |
Resultado do script | Disponível |
Resultado JSON
O exemplo a seguir descreve a saída de resultado JSON recebida ao usar a ação Remover itens da 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 Remover itens da lista de clientes fornece as seguintes mensagens de saída:
Mensagem de resposta | Descrição da mensagem |
---|---|
|
A ação foi concluída. |
|
Falha na ação. |
Resultado do script
A tabela a seguir descreve os valores da saída do resultado do script ao usar 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 do Google SecOps.