iboss

Este documento fornece orientações sobre como integrar o iboss ao Google SecOps.

Casos de uso

  1. Realizar ações de enriquecimento: receber dados do iboss para enriquecer dados nos alertas do Google Security Operations.
  2. Realizar ações ativas: bloquear um IP ou URL no iboss pelo Google SecOps.

Permissão do produto

Para autenticar, as ações realizam duas solicitações. A primeira solicitação é para receber um token, e a segunda é para receber um token XSRF especial.

Configurar a integração do iboss no Google SecOps

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
Nome da instância String N/A Não Nome da instância em que você quer configurar a integração.
Descrição String N/A Não Descrição da instância.
Raiz da API do Cloud String https://cloud.iboss.com/ Sim Especifique a raiz da API iboss cloud.
Raiz da API da conta String https://accounts.iboss.com/ Sim Especifique a raiz da API da conta do iboss.
Nome de usuário String N/A Sim Especifique o nome de usuário da conta do iboss.
Senha Senha N/A Sim Especifique a senha da conta do iboss.
Verificar SSL Caixa de seleção Desmarcado Não Se estiver ativado, verifique se o certificado SSL para a conexão com o servidor de nuvem pública do iboss é válido.
Executar remotamente Caixa de seleção Selecionado Não Marque o campo para executar a integração configurada remotamente. Depois de marcada, a opção de selecionar o usuário remoto (agente) aparece.

Ações

Ping

Descrição

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

Corrida

Essa ação não é executada em entidades 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
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 for bem-sucedida:
imprima "Successfully connected to the iboss server with the provided connection parameters!"

A ação deve falhar e interromper a execução de um playbook:
se não for bem-sucedida:

print "Failed to connect to the iboss server! O erro é {0}".format(exception.stacktrace)

 Geral

Adicionar URL à lista de bloqueio de políticas

Descrição

Adicione o URL à lista de bloqueio do iboss.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique a qual categoria de política você quer adicionar o URL.
Prioridade Inteiro 50 Sim Especifique a prioridade do URL que precisa ser bloqueado.
Direção DDL

Destino

Valores possíveis:

Destino

Origem

Destino e origem

 Sim Especifique a direção do URL.
Porta de início Inteiro N/A Não Especifique a porta inicial relacionada ao URL que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Porta final Inteiro N/A Não Especifique a porta final relacionada ao URL que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Observação String N/A Não Adicione uma observação relacionada ao URL que precisa ser bloqueado.
É uma expressão regular Caixa de seleção Desmarcado Não Se ativado, o URL será considerado uma expressão regular.
Esquema de faixa Caixa de seleção Desmarcado Não Se ativada, a ação vai remover o esquema relacionado ao URL.

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
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:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se não for possível bloquear URLs específicos(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio (is_success = false):

print "A categoria com o ID {category_id} não está associada a uma lista de bloqueio."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Error executing action "Add URL to Policy Block List". Motivo: {0}''.format(error.Stacktrace)

 Geral

Adicionar IP à lista de bloqueio da política

Descrição

Adicione o IP à lista de bloqueio do iboss.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique a qual categoria de política você quer adicionar o URL.
Prioridade Inteiro 50 Sim Especifique a prioridade do URL que precisa ser bloqueado.
Direção DDL

Destino

Valores possíveis:

Destino

Origem

Destino e origem

 Sim Especifique a direção do URL.
Porta de início Inteiro N/A Não Especifique a porta inicial relacionada ao URL que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Porta final Inteiro N/A Não Especifique a porta final relacionada ao URL que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Observação String N/A Não Adicione uma observação relacionada ao URL que precisa ser bloqueado.
É uma expressão regular Caixa de seleção Falso Não Se ativado, o URL será considerado uma expressão regular.

Corrida

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
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:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se não for possível bloquear URLs específicos(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio (is_success = false):

print "A categoria com o ID {category_id} não está associada a uma lista de bloqueio."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Error executing action "Add URL to Policy Block List". Motivo: {0}''.format(error.Stacktrace)

 Geral

Adicionar IP à lista de bloqueio da política

Descrição

Adicione o IP à lista de bloqueio do iboss.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique a categoria de política em que você quer adicionar o IP.
Prioridade Inteiro 50 Sim Especifique a prioridade do IP que precisa ser bloqueado.
Direção DDL

Destino

Valores possíveis:

Destino

Origem

Destino e origem

 Sim Especifique qual é a direção do IP.
Porta de início Inteiro N/A Não Especifique a porta inicial relacionada ao IP que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Porta final Inteiro N/A Não Especifique a porta final relacionada ao IP que precisa ser bloqueado. Observação: se apenas "Porta inicial" ou "Porta final" for especificada, o valor será adicionado aos dois parâmetros de ação.
Observação String N/A Não Adicione uma observação relacionada ao IP que precisa ser bloqueado.
É uma expressão regular Caixa de seleção Desmarcado Não Se ativado, o IP será considerado uma expressão regular.

Corrida

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
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 for bem-sucedido e pelo menos um dos IPs fornecidos tiver sido bloqueado(is_success = true):
print "Successfully blocked the following IPs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se não for possível bloquear IPs específicos(is_success = true):
print "Action was not able to block the following IPs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

print: "No IPs were blocked in the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio (is_success = false):

print "A categoria com o ID {category_id} não está associada a uma lista de bloqueio."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Error executing action "Add IP to Policy Block List". Motivo: {0}''.format(error.Stacktrace)

 Geral

Listar entradas da lista de bloqueio de políticas

Descrição

Retorna as entradas da lista de bloqueio do iboss em um grupo específico.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique em qual categoria de política você quer listar as entradas da lista de bloqueio.
Número máximo de entradas a serem retornadas Inteiro 50 Sim Especifique quantas entradas serão retornadas.

Corrida

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
{
    "entries": [
       {
          "direction": 0,
          "endPort": 0,
          "isRegex": 0,
          "note": "",
          "priority": 0,
          "startPort": 0,
          "type": 0,
          "url": "asaa.com",
          "weight": 501
       }
    ],
    "message": ""
}
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 forem retornados e estiverem disponíveis(is_success = true):
print "Successfully listed entries from the iboss Block List in a category with ID '{0}'".format(category_id)

Se retornado e sem dados (is_success = false):

print: "No Block List entries were found in the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio: (is_success = false)

Imprima "Category with ID {category_id} is not associated with a Block list."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Erro ao executar a ação "Listar entradas da lista de bloqueio de políticas". Motivo: {0}''.format(error.Stacktrace)

 Geral
Painel de casos em CSV

Nome: "Entradas da lista de bloqueio". Categoria {0}".format(Category)

Colunas:

  • Nome (mapeado como URL)
  • Prioridade (mapeada como prioridade)
  • Peso (mapeado como weight)
  • Direção (mapeada como direction. Verificar o comportamento da ação)
  • Porta inicial (mapeada como startPort)
  • Porta final (mapeada como endPort)
  • Observação (mapeada como observação)
  • Regex (mapeado como isRegex. 1 = verdadeiro, 0 = falso)

Remover URL da lista de bloqueio de políticas

Descrição

Remover o URL da lista de bloqueio do iboss.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique de qual categoria de política você quer remover o URL.
Porta de início Inteiro N/A Não Especifique a porta inicial relacionada ao URL que precisa ser excluído. Esse parâmetro é obrigatório se o URL desejado tiver uma porta de início definida. Essa é uma limitação do iboss.
Porta final Inteiro N/A Não Especifique a porta final relacionada ao URL que precisa ser excluído. Esse parâmetro é obrigatório se o URL desejado tiver uma porta final definida. Essa é uma limitação do iboss.
Esquema de faixa Caixa de seleção Desmarcado Não Se ativada, a ação vai remover o esquema relacionado ao URL.

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
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 a operação for bem-sucedida e pelo menos um dos URLs fornecidos for removido (is_success = true):
print "Successfully removed the following URLs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se não for possível remover URLs específicos(is_success = true):

print "Action was not able to remove the following URLs from the category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

Print: "No URLs were removed from the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio (is_success = false):

Imprima "Category with ID {category_id} is not associated with a Block list."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Erro ao executar a ação "Remover URL da lista de bloqueio de políticas". Motivo: {0}''.format(error.Stacktrace)

 Geral

Remover IP da lista de bloqueio de políticas

Descrição

Remova o IP da lista de bloqueio do iboss.

Como encontrar o ID da categoria

  1. Acesse Segurança da Web -> Camadas de política.
  2. Abra o Console das Ferramentas para Desenvolvedores (Ctrl + Shift + I no Google Chrome).
  3. Acesse a guia Rede.
  4. Tente editar a lista de bloqueio necessária.

No console, você vai ver as solicitações que estão sendo feitas. Pesquise entre essas solicitações o parâmetro customCategoryId=xxxx.

Parâmetros
Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da categoria Inteiro 1001 Sim Especifique de qual categoria de política você quer remover o IP.
Porta de início Inteiro N/A Não Especifique a porta inicial relacionada ao IP que precisa ser excluído. Esse parâmetro é obrigatório se o URL desejado tiver uma porta de início definida. Essa é uma limitação do iboss.
Porta final Inteiro N/A Não Especifique a porta final relacionada ao IP que precisa ser excluído. Esse parâmetro é obrigatório se o IP desejado tiver uma porta final definida. Essa é uma limitação do iboss.

Corrida

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
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 for bem-sucedido e pelo menos um dos URLs fornecidos for removido (is_success = true):
print "Successfully removed the following IPs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Se não for possível remover URLs específicos(is_success = true):

print "Action was not able to remove the following IPs from the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

print: "No IPs were removed from the iboss category with ID {0}.".format(category_id)

Se a política não for uma lista de bloqueio: (is_success = false)

Imprima "Category with ID {category_id} is not associated with a Block list."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Erro ao executar a ação "Remover IP da lista de bloqueio de políticas". Motivo: {0}''.format(error.Stacktrace)

 Geral

Busca por URL

Descrição

Realizar uma consulta de URL.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do grupo Inteiro N/A Não Especifique para qual grupo realizar uma consulta de URL. Se nada for especificado, o grupo "Padrão" será usado.

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Nome do host

Resultados da ação

Enriquecimento de entidades
Nome do campo de enriquecimento Origem (chave JSON) Lógica: quando aplicar
IBOSS_group_{group_id}_categories categories Quando disponível em JSON
IBOSS_group_{group_id}_action ação Quando disponível em JSON
IBOSS_group_{group_id}_message mensagem Quando disponível 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
{
    "action": "Not Blocked",
    "categories": "Pornography/Nudity",
    "message": "Url Known."
}
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 a operação for bem-sucedida e pelo menos um dos URLs fornecidos for pesquisado (is_success = true):
print "Successfully retrieved information about the following URLs: \n {0}".format( entity.identifier list)

Se não for possível procurar URLs específicos(is_success = true):

Imprimir: "A ação não conseguiu recuperar informações sobre os seguintes URLs\n: {0}".format([entity.identifier])

Se houver falha na busca de todas as entidades (is_success = false):

Imprima "Nenhuma informação foi recuperada sobre os URLs".

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Erro ao executar a ação "Pesquisa de URL". Motivo: {0}''.format(error.Stacktrace)

 Geral

Recategorização de URL

Descrição

Envie o URL para recategorização.

Corrida

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
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 for bem-sucedido e pelo menos um dos URLs fornecidos tiver sido enviado(is_success = true):
print "Successfully submitted the following URLs for recategorization: \n {0}".format( entity.identifier list)

Se não for possível remover URLs específicos(is_success = true):

print "Action was not able to submit the following URLs for recategorization\n: {0}".format([entity.identifier])

Se houver falha no enriquecimento de todas as entidades (is_success = false):

print: "Nenhum URL foi enviado para recategorização."

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

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros:

print "Erro ao executar a ação "Recategorização de URL". Motivo: {0}''.format(error.Stacktrace)

 Geral

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