Cloudflare

Neste documento, descrevemos como integrar o Cloudflare ao Google Security Operations.

Casos de uso do produto

Enriquecer entidades

Configurar a integração do Cloudflare no Google Security Operations

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

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://api.cloudflare.com Sim Raiz da API da instância do Cloudflare.
Token da API Senha N/A Sim Token de API da instância do Cloudflare.
Nome da conta String N/A Sim Nome da conta que precisa ser usada na integração.
Verificar SSL Caixa de seleção Selecionado Não Se ativada, verifica se o certificado SSL para a conexão com o servidor do Cloudflare é válido.

Como configurar o token

  1. Acesse Configurações do perfil e clique em Tokens de API.
  2. Acesse Criar token > Criar token personalizado e selecione as seguintes permissões:
Conta WAF da conta Ler
Conta Políticas de regras Ler
Conta Listas de filtros de conta Editar
Conta Acesso ao firewall da conta Editar
Conta Firewall de DNS Ler
Conta Configurações da conta Ler
Zona WAF da zona Editar
Zona Configurações de zona Ler
Zona Zona Ler
Zona Registros Ler
Zona Serviços de firewall Editar
Zona Serviços de firewall Ler
Zona Analytics Ler

Lista de permissões necessárias

Ações

Adicionar IP à lista de regras

Descrição

Adicione endereços IP à lista de regras no Cloudflare. Entidades compatíveis: endereço IP.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da regra String N/A Sim Especifique o nome da lista de regras em que você quer adicionar itens.
Descrição String N/A Não Especifique uma descrição para os itens da lista de regras recém-adicionados.

Data de execução

Essa ação é executada na entidade de endereço IP.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
Painel de casos
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 o código de status 200 for informado para uma entidade (is_success=true): "As seguintes entidades foram adicionadas à lista de regras {name} no Cloudflare: {entity.identifier}."

Se não for bem-sucedido para uma entidade (is_success=true): "A ação não conseguiu adicionar as seguintes entidades à lista de regras {name} no Cloudflare: {entity.identifier}."

Se não for bem-sucedido para todos (is_success=false): "Nenhuma das entidades fornecidas foi adicionada à lista de regras {name}."

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

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Adicionar IP à lista de regras'. Motivo: {0}''.format(error.Stacktrace)

Se a lista não for encontrada: "Erro ao executar a ação 'Adicionar IP à lista de regras'. Motivo: a lista de regras {name} não foi encontrada no Cloudflare.''

Se a lista não for do tipo válido: "Erro ao executar a ação 'Adicionar IP à lista de regras'. Motivo: a lista de regras {name} não é do tipo "IP"."

 Geral

Adicionar URL à lista de regras

Descrição

Adicione URLs à lista de regras no Cloudflare. Entidades compatíveis: URL.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da regra String N/A Sim Especifique o nome da lista de regras em que você quer adicionar itens.
URL de origem String N/A Sim Especifique o URL de origem do item da lista de regras.
Descrição String N/A Não Especifique uma descrição para os itens da lista de regras recém-adicionados.
Código de status DDL

301

Valores possíveis:

  • 301
  • 302
  • 307
  • 308
 Não Especifique o status do item da lista de regras.
Preservar string de consulta Caixa de seleção Desmarcado Não Se ativado, o item da lista de regras preserva a string de consulta.
Incluir subdomínios Caixa de seleção Desmarcado Não Se ativado, o item da lista de regras inclui subdomínios.
Correspondência de subcaminho Caixa de seleção Desmarcado Não Se ativado, o item da lista de regras corresponde ao subcaminho.
Preservar sufixo do caminho Caixa de seleção Desmarcado Não Se ativado, o item da lista de regras preserva o sufixo do caminho.

Data de execução

Essa ação é executada na entidade de endereço IP.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
Painel de casos
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 o código de status 200 for para uma entidade (is_success=true): "As seguintes entidades foram adicionadas à lista de regras {name} no Cloudflare: {entity.identifier}."

Se não for bem-sucedido para uma entidade (is_success=true): "A ação não conseguiu adicionar as seguintes entidades à lista de regras {name} no Cloudflare: {entity.identifier}."

Se não houver sucesso para todas as entidades (is_success=false): "Nenhuma das entidades fornecidas foi adicionada à lista de regras {name}."

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

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Adicionar URL à lista de regras'. Motivo: {0}''.format(error.Stacktrace)

Se a lista não for encontrada: "Erro ao executar a ação 'Adicionar URL à lista de regras'. Motivo: a lista de regras {name} não foi encontrada no Cloudflare.''

Se a lista não for do tipo válido: "Erro ao executar a ação 'Adicionar URL à lista de regras'. Motivo: a lista de regras {name} não é do tipo "Redirecionamento".'

 Geral

Criar regra de firewall

Descrição

Crie uma regra de firewall no Cloudflare.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da zona String N/A Sim Especifique o nome da zona que contém a regra de firewall.
Nome String N/A Não Especifique o nome da regra de firewall.
Ação DDL

Bloquear

Valores possíveis:

  • Permitir
  • Bloquear
  • Ignorar
  • Registro
  • CAPTCHA legado
  • Desafio gerenciado
  • Desafio de JS
 Não

Especifique a ação da regra de firewall.

Se "Bloquear" estiver selecionado, você precisará fornecer valores no parâmetro "Produtos".
Expressão String N/A Sim Especifique a expressão para a regra de firewall.
Produtos CSV N/A Não

Especifique uma lista separada por vírgulas de produtos para a regra de firewall.

Observação:esse parâmetro só é obrigatório se "Ignorar" estiver selecionado para o parâmetro "Ação".

Valores possíveis: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
Prioridade Inteiro N/A Não Especifique a prioridade da regra de firewall.
Tag de referência String N/A Não

Especifique uma tag de referência para a regra de firewall.

Observação:ele pode ter até 50 caracteres.

Data de execução

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
Painel de casos
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 o código de status 200 for informado (is_success=true): "Uma nova regra de firewall foi criada na zona '{zone_name}" no Cloudflare".

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

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Criar regra de firewall'. Motivo: {0}''.format(error.Stacktrace)

Se a lista de erros não estiver vazia: "Erro ao executar a ação 'Criar regra de firewall'. Motivo: {0}''.format(errors/message)

Se a zona não for encontrada: "Erro ao executar a ação 'Criar regra de firewall'. Motivo: a zona {zone_name} não foi encontrada no Cloudflare.''

 Geral

Criar lista de regras

Descrição

Crie uma lista de regras no Cloudflare.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome String N/A Sim Especifique o nome da lista de regras.
Tipo DDL

Endereço IP

Valores possíveis:

  • Endereço IP
  • Redirecionado
 Não Especifique o tipo da lista de regras.
Descrição String N/A Não Especifique a descrição da lista de regras.

Data de execução

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
    "id": "d19589d629f140c0b961c467feadf99d",
    "name": "123",
    "kind": "ip",
    "num_items": 0,
"description": "description",
    "num_referencing_filters": 0,
    "created_on": "2022-07-25T12:13:46Z",
    "modified_on": "2022-07-25T12:13:46Z"
}
Painel de casos
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 o código de status 200 for informado (is_success = true): "Uma lista de regras foi criada no Cloudflare."

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

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Criar lista de regras'. Motivo: {0}''.format(error.Stacktrace)

Se a lista de erros não estiver vazia: "Erro ao executar a ação 'Criar lista de regras'. Motivo: {0}''.format(errors/message)

 Geral

Listar regras de firewall

Descrição

Liste as regras de firewall disponíveis no Cloudflare.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da zona String N/A Sim Especifique o nome da zona que vai conter a regra de firewall.
Chave de filtro DDL

Selecione uma opção.

Valores possíveis:

  • Selecione uma opção.
  • Nome
  • ID
  • Ação
 Não Especifique a chave que precisa ser usada para filtrar {tipo de item}.
Lógica de filtro DDL

Selecione uma opção.

Valores possíveis:

  • Selecione uma opção
  • Igual
  • Contém
 Não

Especifique a lógica de filtro que deve ser aplicada.

A lógica de filtragem é baseada no valor fornecido no parâmetro "Chave de filtro".
Filtrar por valor String N/A Não

Especifique o valor que deve ser usado no filtro.

Se "Igual" for selecionado, a ação vai tentar encontrar a correspondência exata entre os resultados.

Se "Contém" estiver selecionado, a ação vai tentar encontrar resultados que contenham essa substring.

Se nada for fornecido nesse parâmetro, o filtro não será aplicado.

A lógica de filtragem é baseada no valor fornecido no parâmetro "Chave de filtro".
Número máximo de registros a serem retornados Inteiro 50 Não

Especifique o número de registros a serem retornados.

Se nada for fornecido, a ação vai retornar 50 registros.

Data de execução

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
    "id": "55ec8db30f9e4640b5d0d13cff6b5429",
    "paused": false,
    "description": "rulle2",
    "action": "allow",
    "filter": {
        "id": "2bb05df8c4f547bd9792d8dc38a86b81",
        "expression": "(ip.geoip.country eq \"BG\")",
        "paused": false
    },
    "created_on": "2022-07-05T13:53:39Z",
    "modified_on": "2022-07-05T13:53:39Z"
}
Painel de casos
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 os dados estiverem disponíveis (is_success=true): "Encontramos {item name} para os critérios fornecidos em {product name}".

Se os dados não estiverem disponíveis (is_success=false): "Nenhum {item name} foi encontrado para os critérios fornecidos em {product name}"

Se o parâmetro "Filter Value" estiver vazio (is_success=true):

"O filtro não foi aplicado porque o parâmetro "Valor do filtro" está vazio."

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

Se o parâmetro "Chave de filtro" estiver definido como "Selecionar um" e o parâmetro "Lógica de filtro" estiver definido como "Igual" ou "Contém":

"Erro ao executar a ação "{action name}". Motivo: é necessário selecionar um campo do parâmetro "Chave de filtro"."

Se um valor inválido for fornecido para o parâmetro "Máximo de registros a serem retornados": "Erro ao executar a ação '{nome da ação}'. Motivo: "O valor fornecido para "Máximo de registros a serem retornados" é inválido: . É preciso informar um número positivo."

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação '{action name}'. Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela do painel de casos

Nome da tabela: {grupo de itens} disponível

Colunas da tabela: {fields}

 Geral

Ping

Descrição

Teste a conectividade com o Cloudflare usando os parâmetros fornecidos na página de configuração da integração na página do Google SecOps Content Hub.

Parâmetros

N/A

Data de execução

A ação não usa nenhuma das entidades de escopo do Google SecOps nem tem parâmetros de entrada obrigatórios.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
N/A
Painel de casos
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 der certo: "Conexão com o servidor do SpyCloud estabelecida com os parâmetros fornecidos."

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

Se não for concluída: "Falha ao se conectar ao servidor do SpyCloud! O erro é {0}".format(exception.stacktrace)

Se a conta não for encontrada: "Falha ao se conectar ao servidor do Cloudflare! O nome da conta fornecido é inválido. Verifique a ortografia."

 Geral

Atualizar regra de firewall

Descrição

Atualize uma regra de firewall no Cloudflare.

Data de execução

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

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da regra String N/A Sim Especifique o nome da regra que precisa ser atualizada.
Nome da zona String N/A Sim Especifique o nome da zona que contém a regra de firewall.
Ação DDL

Bloquear

Valores possíveis:

  • Permitir
  • Bloquear
  • Ignorar
  • Registro
  • CAPTCHA legado
  • Desafio gerenciado
  • Desafio de JS
 Não

Especifique a ação da regra de firewall.

Se "Bloquear" estiver selecionado, você precisará fornecer valores no parâmetro "Produtos".
Expressão String N/A Sim Especifique a expressão para a regra de firewall.
Produtos CSV N/A Não

Especifique uma lista separada por vírgulas de produtos para a regra de firewall.

Observação:esse parâmetro só é obrigatório se "Ignorar" estiver selecionado para o parâmetro "Ação".

Valores possíveis: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
Prioridade Inteiro N/A Não Especifique a prioridade da regra de firewall.
Tag de referência String N/A Não

Especifique uma tag de referência para a regra de firewall.

Observação:ele pode ter até 50 caracteres.

Data de execução

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
Painel de casos
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 o código de status 200 for informado (is_success=true): "Uma regra de firewall foi atualizada na zona "{zone_name}" no Cloudflare."

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

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Atualizar regra de firewall'. Motivo: {0}''.format(error.Stacktrace)

Se a lista de erros não estiver vazia: "Erro ao executar a ação 'Atualizar regra de firewall'. Motivo: {0}''.format(errors/message)

Se a zona não for encontrada: "Erro ao executar a ação 'Atualizar regra de firewall'. Motivo: a zona {zone_name} não foi encontrada no Cloudflare.''

 Geral

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