Listas

Compatível com:

Este documento descreve um conjunto de ferramentas que podem ajudar a gerir listas personalizadas.

Pesquise uma lista de clientes

Descrição

Pesquise uma string especificada nos registos de uma lista personalizada. Se não forem fornecidos valores, a pesquisa devolve todos os registos da lista personalizada.

Parâmetros

Parâmetro Tipo Valor predefinido É obrigatório Descrição
String a pesquisar String N/A Não Especifique a string a pesquisar nos registos de uma lista personalizada.
Categorias String N/A Não Especifique a categoria da lista personalizada na qual quer pesquisar.

Exemplo

Neste exemplo, o sistema verifica se .com está incluído em quaisquer registos numa lista personalizada com a categoria "Domínios bloqueados".

Configurações de ações

Parâmetro Valor
Entidades Todas as entidades
String a pesquisar .com
Categorias Domínios bloqueados

Resultados da ação

  • Resultado do script
    Nome do resultado do script Opções de valor Exemplo
    Match_Records Verdadeiro/Falso verdadeiro
  • Resultado JSON 
    [{
"entityIdentifier": "sample.com", "category": "Blocked Domains", "forDBMigration": false, "environments": ["*"], "id": 1, "creationTimeUnixTimeInMs": 1674846992575, "modificationTimeUnixTimeInMs": 1674846992575
}]

Pesquise uma string especificada numa lista personalizada de ambientes

Descrição

Pesquisa uma string especificada nos registos da lista personalizada do ambiente do registo atual. Se não forem fornecidos valores, a pesquisa devolve todos os registos de listas personalizadas.

Parâmetros

Parâmetro Tipo Valor predefinido É obrigatório Descrição
String a pesquisar String N/A Não Especifique a string a pesquisar nos registos de uma lista personalizada.
Categorias String N/A Não Especifique a categoria da lista personalizada na qual quer pesquisar.

Exemplo

Neste exemplo, o sistema verifica se 1.1.1.1 está incluído em quaisquer registos numa lista personalizada com a categoria "vuln_scanner".

Configurações de ações

Parâmetro Valor
Entidades Todas as entidades
String a pesquisar 1.1.1.1
Categorias vuln_scanner

Resultados da ação

  • Resultado do script
    Nome do resultado do script Opções de valor Exemplo
    Match_Records Verdadeiro/Falso verdadeiro
  • Resultado JSON 
    [
  {
    "entityIdentifier": "1.1.1.1",
    "category": "vuln_scanner",
    "environments": [
      "Default Environment"
    ],
    "id": 5,
    "name": "test",
    "creationTimeUnixTimeInMs": 1673953571935,
    "modificationTimeUnixTimeInMs": 1673953571935
  }
]

A string está na lista personalizada

Descrição

Verifica se uma string está numa lista personalizada.

Parâmetros

Parâmetro Tipo Valor predefinido É obrigatório Descrição
ListItem String N/A Sim Especifique a string a adicionar a uma lista personalizada.
Categoria String Lista de autorizações Sim Especifique a categoria ou o nome da lista personalizada.

Example

In this example, the system checks whether the IP address 0.0.0.0 exists in a list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
IdentifierList 0.0.0.0
Categories bad_ips_list

Action results

  • Script result
Script result name Value options Example
NumOf FoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Add string to custom list

Description

Adds a string to a custom list.

Parameters

Parameter Type Default value Is mandatory Description
ListItem String N/A Yes Specify string to add to a custom list.
Category String Allowlist Yes Specify the custom list category/name.

Example

In this example, an IP address of 0.0.0.1 is added to a custom list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
Listitem 0.0.0.1
Categories bad_ips_list

Action results

  • Script result
    Script result name Value options Example
    NumOf FoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Remove string from custom list

Description

Removes a string from a custom list.

Parameters

Parameter Type Default value Is mandatory Description
Category String Allowlist Yes Specify the custom list category/name.
ListItem String N/A Yes Specify string to remove from a custom list.

Example

In this example, an IP address 0.0.0.1 is removed from a custom list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
IdentifierList 0.0.0.1
Categories bad_ips_list

Action results

  • Script result
    Script result name Value options Example
    NumOfFoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Need more help? Get answers from Community members and Google SecOps professionals.