Esta página foi traduzida pela API Cloud Translation.

Sombras digitais

Versão da integração: 9.0

Casos de uso

A integração do Digital Shadows é usada como fonte de alertas e para enriquecer entidades.

Pré-requisitos

Para usar a API Digital Shadows, é necessário ter uma chave de API.

As solicitações para todos os endpoints de operação exigem autenticação básica HTTP e credenciais de API dedicadas (alta entropia) que normalmente consistem em uma chave de seis caracteres e um secreto de 32 caracteres.

Integrar o Digital Shadows ao Google Security Operations

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Entradas de integração

Para configurar a integração, use os seguintes parâmetros:

Parâmetros
`Instance Name`	Opcional Nome da instância em que você pretende configurar a integração.
`Description`	Opcional Descrição da instância.
`API Key`	Obrigatório Chave de API do Digital Shadow.
`API Secret`	Opcional Chave secreta da API Digital Shadow.
`Run Remotely`	Opcional Marque a caixa para executar a integração configurada remotamente. Depois de marcada, a opção aparece para selecionar o usuário remoto (agente). Por padrão, essa opção não está marcada.

Ações

Aperfeiçoar CVE

Enriqueça uma CVE usando informações da Digital Shadows.

Os analistas podem usar essa ação para receber mais informações sobre a CVE específica, o que é útil para a investigação.

Entidades

Essa ação é executada na entidade CVE.

Entradas de ação

N/A

Saídas de ação

Tipo de saída da ação
Anexo do Painel de Casos	N/A
Link do Painel de Casos	Disponível
Tabela do painel de casos	N/A
Tabela de enriquecimento	Disponível
Resultado JSON	Disponível
Resultado do script	Disponível

Enriquecimento de entidade

Campo de aprimoramento	Origem (chave JSON)	Lógica
`DigitalShadows_Exploit_title`	`entity/title`	Se disponível no resultado JSON.
`DigitalShadows_Exploit_type`	`entity/type`	Se disponível no resultado JSON.
`DigitalShadows_Exploit_platform`	`entity/platform`	Se disponível no resultado JSON.
`DigitalShadows_Exploit_source`	`entity/sourceUri`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_sourceURL`	`entity/sourceUri`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_description`	`entity/description`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_score`	`entity/cvss2Score/baseScore`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_authentication`	`entity/cvss2Score/authentication`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_accessVector`	`entity/cvss2Score/accessVector`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_accessComplexity`	`entity/cvss2Score/accessComplexity`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_confidentialityImpact`	`entity/cvss2Score/confidentialityImpact`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_integrityImpact`	`entity/cvss2Score/integrityImpact`	Se disponível no resultado JSON.
`DigitalShadows_Vulnerability_availabilityImpact`	`entity/cvss2Score/availabilityImpact`	Se disponível no resultado JSON.

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/Falso

Resultado JSON

{
    "content": [
        {
            "entity": {
                "cveIdentifier": "CVE-2011-0489",
                "created": "2011-01-18T18:03:00.000Z",
                "updated": "2017-08-17T01:33:00.000Z",
                "sourceUri": "https://nvd.nist.gov/vuln/detail/CVE-2011-0489",
                "description": "The server components in Example_DB 10.0 do not require authentication for administrative commands, which allows remote attackers to modify data, obtain sensitive information, or cause a denial of service by sending requests over TCP to (1) the Lock Server or (2) the Advanced Multithreaded Server, as demonstrated by commands that are ordinarily sent by the (a) ookillls and (b) oostopams applications.  NOTE: some of these details are obtained from third party information.",
                "relatedCPEs": [
                    "cpe:/a:example:example%2fdb:10.0"
                ],
                "cvss2Score": {
                    "baseScore": 7.5,
                    "authentication": "NONE",
                    "accessVector": "NETWORK",
                    "accessComplexity": "LOW",
                    "confidentialityImpact": "PARTIAL",
                    "integrityImpact": "PARTIAL",
                    "availabilityImpact": "PARTIAL"
                }
            },
            "type": "VULNERABILITY",
            "snippet": "CVE ID: CVE-2011-0489</em><br><br>",
            "sortDate": "2017-08-17T01:33:00.000Z"
        },
        {
            "entity": {
                "id": "f75754b5-65a3-46ee-bea7-e0f015a5283d",
                "uri": "http://example.com",
                "pasted": "2018-01-05T09:10:02.000Z",
                "observableCounts": {
                    "ipV4": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "email": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "md5": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha1": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha256": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "host": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "cve": {
                        "count": 100,
                        "exceededMaximum": true
                    }
                },
                "screenshot": {
                    "id": "3ab6b3cb-349d-4ed7-b150-773454a11908",
                    "link": "https://example.com"
                },
                "screenshotThumbnail": {
                    "id": "7529cf75-5ddb-4e2d-8fc9-f3531e33704e",
                    "link": "https://example.com"
                }
            },
            "type": "PASTE",
            "snippet": "&quot;\n  ], \n  &quot;CVE-2002-1656&quot;: [\n    &quot;3043&quot;\n  ], \n  &quot;CVE-2003-0347&quot;: [\n    &quot;23094&quot;\n  ], \n  &quot;<em>CVE</em>-<em>2011</em>-<em>0489</em>&quot;: [\n    &quot;15988",
            "sortDate": "2018-01-05T09:10:02.000Z"
        },
            "type": "PASTE",
            "snippet": ") sequences in a crafted request.\n| [<em>CVE</em>-<em>2011</em>-<em>0489</em>] The server components in Example_DB 10.0 do ...  in a crafted request.\n| [<em>CVE</em>-<em>2011</em>-<em>0489</em>] The server components in Example_DB 10.0 do not require ...  request.\n| [<em>CVE</em>-<em>2011</em>-<em>0489</em>] The server components in Example_DB 10.0 do not require ...  files via &quot;../\\&quot; (dot dot forward-slash backslash) sequences in a crafted request.\n| [<em>CVE</em>-<em>2011</em>-<em>0489</em>",
            "sortDate": "2019-07-23T21:35:39.000Z"
        }
    ],
    "currentPage": {
        "offset": 0,
        "size": 50
    },
    "total": 4,
    "facets": {}
}

Painel de casos

A ação fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Mensagem de resposta	Descrição da mensagem
`Successfully enriched CVE.` `No CVEs were enriched.`	A ação foi concluída.
`Error executing action "Enrich CVE". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Successfully enriched CVE.

No CVEs were enriched.

A ação foi concluída.

Error executing action "Enrich CVE".
      Reason: ERROR_REASON

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Links do painel de casos

Se TYPE=Exploit estiver disponível na resposta JSON:

Título: URL da fonte do exploit

Link: entity/sourceUri
Se TYPE=Vulnerability estiver disponível na resposta JSON:

Título: URL da origem da vulnerabilidade:

Link: entity/sourceUri
Para todas as entidades que retornaram dados:

Título: Full Digital Shadow Search Result

Link: https://portal-digitalshadows.com/search?q=ENTITY

Enriquecer hash (descontinuado)

Enriqueça um hash usando informações da Digital Shadows.

Casos de uso

Os analistas podem usar essa ação para coletar mais detalhes, por exemplo, se é um hash seguro que seria útil para a investigação.

Executar em

Essa ação é executada na entidade "Filehash".

Resultados da ação

Enriquecimento de entidades

Nome do campo de enriquecimento	Origem (chave JSON)	Lógica: quando aplicar
DigitalShadows_CylanceFileHash_generalScore	entity/fileHashInfo/generalScore	Se disponível no resultado em JSON.
DigitalShadows_CylanceFileHash_classifier_ml	entity/fileHashInfo/classifiers/ml	Se disponível no resultado em JSON.
DigitalShadows_CylanceFileHash_classifier_industry	entity/fileHashInfo/classifiers/industry	Se disponível no resultado em JSON.
DigitalShadows_CylanceFileHash_classifier_human	entity/fileHashInfo/classifiers/human	Se disponível no resultado em JSON.
DigitalShadows_WebrootFileHash_category	entidade/categoria	Se disponível no resultado em JSON.
DigitalShadows_WebrootFileHash_malwareCategory	entity/malwareCategory	Se disponível no resultado em JSON.
DigitalShadows_WebrootFileHash_fileSizeBytes	entity/fileSizeBytes	Se disponível no resultado em JSON.
DigitalShadows_WebrootFileHash_fileLastSeen	entity/fileLastSeen	Se disponível no resultado em JSON.
DigitalShadows_WebrootFileHash_sourceUrls	entity/sourceUrls	Se os dados estiverem disponíveis no resultado JSON. As listas vazias devem ser ignoradas.

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado do JSON

 {
    "content": [
        {
            "entity": {
                "requestedHash": "617f7301fd67e8b5d8ad42d4e94e02cb313fe5ad51770ef93323c6115e52fe98",
                "status": 0,
                "fileHashInfo": {
                    "status": "COMPLETE",
                    "statusCode": 1,
                    "generalScore": -1.0,
                    "classifiers": {
                        "ml": 1.0,
                        "industry": -1.0,
                        "human": -1.0
                    },
                    "hashes": {
                        "sha256": "617F7301FD67E8B5D8AD42D4E94E02CB313FE5AD51770EF93323C6115E52FE98",
                        "sha1": "CF0743ED381ADE69BBA3D1DD3D357A8300BCD4AE",
                        "md5": "8FE94843A3E655209C57AF587849AC3A"
                    }
                }
            },
            "type": "CYLANCE_FILE_HASH"
        },
              {
            "entity": {
                "id": "7ab729ab-2176-4072-8fcc-483410e7949d",
                "uri": "http://example.com",
                "title": "Malware hashes",
                "pasted": "2019-12-07T04:01:21.000Z",
                "observableCounts": {
                    "ipV4": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "email": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "md5": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha1": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha256": {
                        "count": 45,
                        "exceededMaximum": false
                    },
                    "host": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "cve": {
                        "count": 0,
                        "exceededMaximum": false
                    }
                },
                "screenshot": {
                    "id": "a358a7fd-ce76-4ac0-a338-7a17c5affcca",
                    "link": "https://example.com"
                },
                "screenshotThumbnail": {
                    "id": "2a98b417-1846-47ca-835f-b4be580cfdc2",
                    "link": "https://example.com"
                }
            },
            "type": "PASTE",
            "snippet": "617f7301fd67e8b5d8ad42d4e94e02cb313fe5ad51770ef93323c6115e52fe98\n137e17ed0c693f5ba23c3f3bf252f7edc29548d97f426625a4e0c5fea0558e45",
            "sortDate": "2019-12-07T04:01:21.000Z"
        },
        {
            "entity": {
                "id": "e05f1f61-5996-4ff9-b656-5d7fe856e459",
                "uri": "http://example.com",
                "pasted": "2017-12-27T08:53:14.000Z",
                "observableCounts": {
                    "ipV4": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "email": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "md5": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha1": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha256": {
                        "count": 100,
                        "exceededMaximum": true
                    },
                    "host": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "cve": {
                        "count": 0,
                        "exceededMaximum": false
                    }
                },
                "screenshot": {
                    "id": "d41fd1d9-aa0c-411d-87f5-824d036e9843",
                    "link": "https://example.com"
                },
                "screenshotThumbnail": {
                    "id": "ab91eba6-f8fd-4a7e-a3b4-6b100ee50789",
                    "link": "https://example.com"
                }
            },
            "type": "PASTE",
            "snippet": "617F7301FD67E8B5D8AD42D4E94E02CB313FE5AD51770EF93323C6115E52FE98",
            "sortDate": "2017-12-27T08:53:14.000Z"
        }
    ],
    "currentPage": {
        "offset": 0,
        "size": 25
    },
    "total": 4,
    "facets": {}
 }

Painel de casos

Tipo de resultado Valor / Descrição Tipo

Mensagem de saída*

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se não houver erros e dados retornados para entidades: Imprima "Conexão estabelecida com sucesso com o Digital Shadows usando os parâmetros de conexão fornecidos! Se não houver erros e nenhum dado for retornado para entidades: imprima "Nenhum hash foi enriquecido". A ação precisa falhar e interromper a execução de um playbook: Se houver um erro: Imprima "Erro ao executar a ação "Enriquecer hash". Motivo: {0}''.format(error.Stacktrace)	Geral
Links	Para todas as entidades que retornaram dados: Título:Resultado da pesquisa de pegadas digitais completas Link:https://portal-digitalshadows.com/search?q=`ENTITY`	Entidade

A ação não pode falhar nem interromper a execução de um playbook:

Se não houver erros e dados retornados para entidades:
Imprima "Conexão estabelecida com sucesso com o Digital Shadows usando os parâmetros de conexão fornecidos!

Se não houver erros e nenhum dado for retornado para entidades:
imprima "Nenhum hash foi enriquecido".

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro:

Imprima "Erro ao executar a ação "Enriquecer hash". Motivo: {0}''.format(error.Stacktrace)

Geral

Links

Para todas as entidades que retornaram dados:

Título:Resultado da pesquisa de pegadas digitais completas

Link:https://portal-digitalshadows.com/search?q=ENTITY

Entidade

Enriquecer IP (descontinuado)

Enriqueça um IP usando informações do Digital Shadows.

Casos de uso

Os analistas podem usar essa ação para receber mais informações sobre o endereço IP, o que é útil para a investigação.

Executar em

Essa ação é executada na entidade "Endereço IP".

Resultados da ação

Enriquecimento de entidades

Nome do campo de enriquecimento	Origem (chave JSON)	Lógica: quando aplicar
DigitalShadows_WebrootIP_reputationScore	entity/reputationScore	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_asn	entity/asn	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_currentlyClassifiedAsThreat	entity/currentlyClassifiedAsThreat	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_ipThreatHistory	entity/ipThreatHistory	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_country	entity/ipGeoInfo/country	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_region	entity/ipGeoInfo/region	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_state	entity/ipGeoInfo/state	Se disponível no resultado em JSON.
DigitalShadows_WebrootIP_city	entity/ipGeoInfo/city	Se disponível no resultado em JSON.

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado do JSON

 {
    "content": [
        {
            "entity": {
                "ipAddress": "192.0.2.1",
                "updatedDateTime": "2020-02-21T01:10:01.000Z",
                "reputationScore": 18,
                "asn": 13335,
                "currentlyClassifiedAsThreat": false,
                "threatCategories": [],
                "ipThreatHistory": [],
                "ipReputationHistory": [
                    {
                        "timestamp": "2020-02-21T01:10:01.000Z",
                        "reputation": 18
                    },
                    {
                        "timestamp": "2020-02-07T01:10:02.000Z",
                        "reputation": 29
                    }
                ],
                "ipIncidentHistory": [
                    {
                        "classifiedAsThreat": false,
                        "startDateTime": "2019-07-15T00:37:12.000Z",
                        "durationSeconds": 0,
                        "numberOfAttempts": 0,
                        "eventType": "Phishing IPs",
                        "threatType": "Phishing",
                        "eventDescription": "IP hosts phishing sites",
                        "applications": [],
                        "hostingPhishUrls": [
                            "example.net"
                        ],
                        "scanDetails": [],
                        "attackDetails": []
                    },
                    {
                        "classifiedAsThreat": false,
                        "startDateTime": "2018-07-21T00:23:27.000Z",
                        "durationSeconds": 0,
                        "numberOfAttempts": 0,
                        "eventType": "Phishing IPs",
                        "threatType": "Phishing",
                        "eventDescription": "IP hosts phishing sites",
                        "applications": [],
                        "hostingPhishUrls": [
                            "example.net"
                        ],
                        "scanDetails": [],
                        "attackDetails": []
                    }
                ],
                "ipGeoInfo": {
                    "country": "united states",
                    "region": "mid atlantic",
                    "state": "new jersey",
                    "city": "newark",
                    "latitude": "40.73873",
                    "longitude": "-74.19453",
                    "organization": "example  inc.",
                    "carrier": "example",
                    "tld": "",
                    "sld": "",
                    "asn": "example_isn"
                }
            },
            "type": "WEBROOT_IP"
        },
        {
            "entity": {
                "id": "0007b64b-ef21-4b5f-a0c2-1e469ceb6896",
                "uri": "http://example.com",
                "pasted": "2019-10-23T13:32:46.000Z",
                "observableCounts": {
                    "ipV4": {
                        "count": 100,
                        "exceededMaximum": true
                    },
                    "email": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "md5": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha1": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "sha256": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "host": {
                        "count": 0,
                        "exceededMaximum": false
                    },
                    "cve": {
                        "count": 0,
                        "exceededMaximum": false
                    }
                },
                "screenshot": {
                    "id": "b019cfcf-2d36-4bcd-9bf3-69fa67b5ec6d",
                    "link": "https://example.com"
                },
                "screenshotThumbnail": {
                    "id": "57af6550-6690-478f-8ba5-640a5560311a",
                    "link": "https://example.com"
                }
            },
            "type": "PASTE",
            "snippet": "192.0.2.1\n192.0.2.2\n192.0.2.3\n192.0.2.4\n192.0.2.5\n192.0.2.6\n192.0.2.7",
            "sortDate": "2019-10-23T13:32:46.000Z"
        }
    ],
    "currentPage": {
        "offset": 0,
        "size": 50
    },
    "total": 10,
    "facets": {}
 }

Painel de casos

Tipo de resultado Valor / Descrição Tipo

Mensagem de saída*

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se não houver erros e os dados retornados para entidades: Imprima "Enriquecimento de endereços IP {0} concluído".format(entity) Se não houver erros e nenhum dado for retornado para entidades: Imprima "Nenhum endereço IP foi enriquecido". A ação precisa falhar e interromper a execução de um playbook: Se houver um erro: Imprima "Erro ao executar a ação "Enriquecer IP". Motivo: {0}''. format(error.Stacktrace)	Geral
Links	Para todas as entidades que retornaram dados: Título:Resultado da pesquisa de pegadas digitais completas Link:https://portal-digitalshadows.com/search?q= `ENTUTY`	Entidade

A ação não pode falhar nem interromper a execução de um playbook:

Se não houver erros e os dados retornados para entidades:
Imprima "Enriquecimento de endereços IP {0} concluído".format(entity)

Se não houver erros e nenhum dado for retornado para entidades:
Imprima "Nenhum endereço IP foi enriquecido".

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro:

Imprima "Erro ao executar a ação "Enriquecer IP". Motivo: {0}''. format(error.Stacktrace)

Geral

Links

Para todas as entidades que retornaram dados:

Título:Resultado da pesquisa de pegadas digitais completas

Link:https://portal-digitalshadows.com/search?q= ENTUTY

Entidade

Aperfeiçoar URL

Enriqueça um URL usando informações da Digital Shadows.

Os analistas podem usar essa ação para ter mais informações sobre o endereço de URL específico, o que é útil para a investigação.

Entidades

Essa ação é executada na entidade de URL.

Entradas de ação

N/A

Saídas de ação

Tipo de saída da ação
Anexo do Painel de Casos	N/A
Link do Painel de Casos	Disponível
Tabela do painel de casos	N/A
Tabela de enriquecimento	Disponível
Resultado JSON	Disponível
Resultado do script	Disponível

Enriquecimento de entidade

Campo de aprimoramento	Origem (chave JSON)	Lógica
`DigitalShadows_WebrootDomain_timesLabeledAsThreat`	`entity/threatHistory`	Se disponível no resultado JSON.
`DigitalShadows_WebrootDomain_age`	`entity/age`	Se disponível no resultado JSON.
`DigitalShadows_WebrootIP_popularity`	`entity/popularity`	Se disponível no resultado JSON.
`DigitalShadows_WebrootIP_reputation`	`entity/reputation`	Se disponível no resultado JSON.
`DigitalShadows_WebrootIP_threatCategories`	`entity/threatCategories`	Se disponível no resultado JSON.

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/Falso

Resultado JSON

{
    "content": [
        {
            "entity": {
                "domainOrUrl": "www.example.com",
                "lastUpdated": "2020-02-25T12:08:20.944Z",
                "threatCategories": [
                    {
                        "confidence": 93,
                        "group": "Security",
                        "name": "Malware Sites"
                    }
                ],
                "reputation": 10,
                "popularity": "UNRANKED",
                "age": 82,
                "threatHistory": 1,
                "webrootCrawlHistory": [],
                "domainHostedHashes": []
            },
            "type": "WEBROOT_DOMAIN"
        }
    ],
    "currentPage": {
        "offset": 0,
        "size": 50
    },
    "total": 66,
    "facets": {}
}

Painel de casos

A ação fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Mensagem de resposta	Descrição da mensagem
`Successfully enriched URLs: URLS` `No URLs were enriched.`	A ação foi concluída.
`Error executing action "Enrich URL". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Successfully enriched URLs: URLS

No URLs were enriched.

A ação foi concluída.

Error executing action "Enrich URL".
      Reason: ERROR_REASON

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Link do Painel de Casos

Para todas as entidades que retornaram dados:

Título: Full Digital Shadow Search Result
Link: https://portal-digitalshadows.com/search?q=ENTITY

Ping

Teste a conectividade com o Digital Shadows usando os parâmetros fornecidos na página de configuração da integração na guia "Marketplace" do Google Security Operations.

Essa ação pode ser executada manualmente e não usa playbooks.

Entidades

Essa ação não é executada em entidades.

Entradas de ação

N/A

Saídas de ação

Tipo de saída da ação
Anexo do Painel de Casos	N/A
Link do Painel de Casos	Disponível
Tabela do painel de casos	N/A
Tabela de enriquecimento	N/A
Resultado JSON	N/A
Resultado do script	Disponível

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/Falso

Painel de casos

A ação fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully connected to the Digital Shadows with the provided connection parameters! A ação foi concluída.

Mensagem de resposta	Descrição da mensagem
`Successfully connected to the Digital Shadows with the provided connection parameters!`	A ação foi concluída.
`Error executing action "Ping". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Error executing action "Ping".
      Reason: ERROR_REASON

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Link do Painel de Casos

Para todas as entidades que retornaram dados:

Título: Full Digital Shadow Search Result
Link: https://portal-digitalshadows.com/search?q=ENTITY

Conectores

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Digital Shadows: conector de incidentes

Ingerir incidentes do Digital Shadows no Google SecOps.

Entradas do conector

Para configurar o conector, use os seguintes parâmetros:

Parâmetros
`Product Field Name`	Obrigatório Insira o nome do campo de origem para recuperar o nome `Product Field`. O valor padrão é `Product Name`.
`Event Field Name`	Obrigatório Insira o nome do campo de origem para recuperar o nome `Event Field`. O valor padrão é `type`.
`Environment Field Name`	Opcional Nome do campo em que o nome do ambiente é armazenado. Se o campo de ambiente não for encontrado, o ambiente padrão será usado. O valor padrão é `""`.
`Environment Regex Pattern`	Opcional Um padrão de expressão regular a ser executado no valor encontrado no campo `Environment Field Name`. O valor padrão `.*` captura todos os casos e retorna o valor sem alterações. O parâmetro permite manipular o campo "environment" usando a lógica de expressão regular. Se o padrão de expressão regular for nulo ou vazio, ou se o valor do ambiente for nulo, o ambiente padrão será usado.
`Script Timeout (Seconds)`	Obrigatório Tempo limite para o processo Python que executa o script atual. O valor padrão é de 180 segundos.
`API Key`	Obrigatório Chave de API do Digital Shadow.
`API secret`	Obrigatório Chave secreta da API Digital Shadow.
`Client Secret`	Obrigatório Chave secreta do cliente da conta da CrowdStrike.
`Fetch Max Hours Backwards`	Opcional Número de horas antes do momento atual para recuperar incidentes. O valor padrão é 1 hora.
`Lowest Severity To Fetch`	Obrigatório A menor gravidade dos incidentes a serem buscados. Os valores possíveis são: `VERY_HIGH` `HIGH` `MEDIUM` `LOW` `VERY_LOW` `NONE` O valor padrão é `NONE`.
`Incident Type Filter`	Opcional Lista separada por vírgulas de tipos de incidentes que precisam ser ingeridos no Google SecOps. Por padrão, o conector recupera todos os tipos de incidentes. Os valores possíveis são: `DATA_LEAKAGE` `CYBER_THREAT` `PHYSICAL_SECURITY` `SOCIAL_MEDIA_COMPLIANCE` `BRAND_PROTECTION` `INFRASTRUCTURE`
`Max Incidents To Fetch`	Opcional Número de incidentes a serem processados por iteração de conector. O valor padrão é 50.
`Use whitelist as a blacklist`	Obrigatório Se marcada, a lista dinâmica será usada como uma lista de bloqueio. Por padrão, essa opção não está marcada.
`Verify SSL`	Obrigatório Se marcada, verifica se o certificado SSL da conexão com o servidor do CrowdStrike é válido. Por padrão, essa opção não está marcada.
`Proxy Server Address`	Opcional Endereço do servidor proxy a ser usado.
`Proxy Username`	Opcional Nome de usuário do proxy para autenticação.
`Proxy Password`	Opcional Senha do proxy para autenticação.

Regras do conector

O conector é compatível com proxy.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.