Manual de Uso
WB Manager
Gerencie whitelists e blacklists — adicionando, editando, removendo e exportando registros pela interface web.
O que é o WB Manager?
O WB Manager é um sistema web para gerenciar listas de bloqueio (blacklist) e liberação (whitelist) de endereços IP, domínios, emails, URLs e outros tipos de dados.
Contém valores permitidos / confiáveis. Endereços IP, domínios ou emails nesta lista recebem tratamento preferencial ou são explicitamente liberados de filtros.
Contém valores bloqueados / suspeitos. Endereços, domínios ou emails nesta lista são barrados, marcados como spam ou tratados como ameaça.
Acesso e Login
Acesse o sistema pelo navegador. Na tela de login, informe seu usuário ou email e senha. Se foi ativado o 2FA, um código de 6 dígitos será enviado ao seu email.
Abrir o sistema no navegador
Acesse o endereço fornecido pelo administrador (ex: https://wbmanager.spamcop.com.br).
Informar credenciais
Digite seu email ou nome de usuário e sua senha. Clique em Entrar. As credenciais padrão serão fornecidas via email ou whatsapp — troque imediatamente após o primeiro login.
Verificação em 2 fatores (se ativado)
Se o 2FA estiver ativo na sua conta, o sistema exibirá uma tela pedindo o código de 6 dígitos enviado ao seu email. O código expira em 10 minutos. Insira o código e clique em Verificar.
Recuperar senha esquecida
Na tela de login, clique em Esqueci minha senha. Informe o email da conta. Um link de redefinição válido por 1 hora será enviado. Clique no link e crie uma nova senha com pelo menos 8 caracteres.
Dashboard
A tela inicial apresenta um panorama completo do sistema em tempo real.
Quatro cards no topo mostram: total de entradas (com quantas foram inseridas hoje), total na whitelist, total na blacklist e número de categorias e usuários ativos.
Quatro gráficos interativos: barras com entradas por categoria, linha de tendência dos últimos 7 dias (whitelist vs blacklist), rosca com distribuição por tipo de dado, e rosca whitelist vs blacklist com percentual.
Tabela com os 50 registros inseridos mais recentemente, mostrando valor, tipo de lista, categoria, tipo de dado, usuário responsável e data de inserção.
Adicionar Registros
Acesse Adicionar no menu lateral. É possível inserir múltiplos valores de uma só vez — um por linha — sem limite de linhas.
Selecionar o Tipo de Lista
Escolha ✅ Whitelist para valores permitidos ou 🚫 Blacklist para valores a bloquear. Um banner colorido confirma sua seleção imediatamente abaixo do campo.
Escolher Categoria e Tipo de Dado
Selecione a Categoria (ex: Spam, Fraud, Trusted) e o Tipo de Dado (ex: IP Address, Domain, Email). Esses campos são obrigatórios e permitem filtrar e exportar os dados depois.
Colar os valores — um por linha
No campo Valores, cole ou digite os dados, um por linha. Use os botões Exemplo IPs, Exemplo Domínios ou Exemplo Emails para carregar exemplos de formato. O contador ao pé do campo mostra quantas linhas estão preenchidas em tempo real.
Limpar duplicatas (opcional)
Clique em Limpar duplicatas para remover linhas repetidas antes de inserir. O sistema também rejeita automaticamente qualquer valor que já exista no banco com a mesma combinação de lista + categoria + tipo.
Adicionar observações (opcional)
O campo Observações permite registrar o contexto da inserção (ex: "IPs bloqueados após ataque de 15/01").
Clicar em Inserir Entradas
O sistema processa cada linha, ignora duplicatas e exibe um resumo: quantas foram inseridas, quantas linhas repetidas foram ignoradas no próprio texto e quantas já existiam no banco.
Importar Arquivo
Acesse Importar no menu lateral para carregar arquivos TXT, CSV ou LOG diretamente do seu computador.
| Formato | Comportamento |
|---|---|
| TXT | Um valor por linha. Linhas iniciando com # são ignoradas como comentários. |
| CSV | Apenas a primeira coluna de cada linha é importada. Colunas extras são descartadas. |
| LOG | Tratado como TXT — um valor por linha. |
Selecionar o arquivo
Arraste o arquivo para a área pontilhada ou clique em clique para selecionar. O nome e tamanho do arquivo aparecerão confirmados na tela.
Configurar lista, categoria e tipo
Escolha o Tipo de Lista, a Categoria e o Tipo de Dado para todos os registros do arquivo. Todos os valores importados receberão os mesmos atributos.
Iniciar importação
Clique em Importar. O sistema exibe um resumo com total de linhas lidas, registros inseridos e linhas ignoradas (vazias, comentários ou duplicatas).
Buscar e Filtrar
Acesse Listas no menu lateral para visualizar, filtrar e pesquisar todos os registros. A tabela exibe no máximo 50 itens por página.
| Filtro | Descrição |
|---|---|
| Tipo de Lista | Filtrar apenas whitelist, apenas blacklist ou todas. |
| Categoria | Filtrar por categoria específica (Spam, Fraud, Trusted…). |
| Tipo de Dado | Filtrar por tipo (IP Address, Domain, Email…). |
| Buscar valor | Pesquisa parcial no conteúdo do registro (busca LIKE %texto%). |
| Buscar usuário | Filtrar registros inseridos por um usuário específico. |
Aplicar filtros
Selecione os filtros desejados na barra de filtros e clique em Filtrar. Os filtros de tipo de lista e categoria aplicam automaticamente ao trocar o valor nos menus.
Navegar pelas páginas
Use os controles de paginação ao pé da tabela para navegar entre páginas. O total de registros encontrados aparece no cabeçalho da tabela.
Copiar valor rapidamente
Clique no ícone de cópia ao lado de qualquer valor na tabela para copiá-lo para a área de transferência sem precisar selecionar o texto.
Limpar filtros
Clique em Limpar (aparece quando há filtros ativos) para voltar à listagem completa.
Editar Registro
Qualquer registro pode ser editado individualmente. É possível alterar o valor, o tipo de lista, a categoria, o tipo de dado e as observações.
Localizar o registro
Acesse Listas e use os filtros para localizar o registro que deseja editar.
Clicar em Editar
Na coluna Ações da tabela, clique no botão ✏ Editar. Você será redirecionado para a tela de edição do registro.
Alterar os campos
Na tela de edição estão disponíveis os campos:
| Campo | Descrição |
|---|---|
| Valor | O dado em si (IP, domínio, email…). Permite múltiplas linhas por registro. |
| Tipo de Lista | Whitelist ou Blacklist. |
| Categoria | Categoria do registro. |
| Tipo de Dado | Classificação do dado. |
| Observações | Notas livres sobre o registro. |
Salvar alterações
Clique em Salvar Alterações para confirmar. Uma mensagem de sucesso confirma a atualização. Clique em Cancelar para voltar à lista sem salvar.
Remover Registro
A exclusão é permanente e irreversível. Não há lixeira — o registro é deletado imediatamente do banco de dados.
Localizar o registro
Acesse Listas e use os filtros para encontrar o registro.
Clicar em Excluir
Na coluna Ações, clique no botão ✕ Excluir. Uma janela de confirmação será exibida com o nome do registro a ser removido.
Confirmar a exclusão
Clique em OK na janela de confirmação. O registro é removido da tabela sem recarregar a página e uma notificação de sucesso aparece no canto da tela.
Exportar Dados
Acesse Exportar no menu lateral. É possível baixar os dados em múltiplos formatos com filtros avançados, prefixos e sufixos customizados.
| Campo | Descrição |
|---|---|
| Tipo de Lista | Exportar whitelist, blacklist ou ambas. |
| Categoria | Filtrar por categoria específica ou todas. |
| Tipo de Dado | Filtrar por tipo específico ou todos. |
| Data Início / Fim | Limitar o período dos registros exportados. |
| Formato | TXT (uma linha por registro), CSV ou JSON. |
| Nome do arquivo | Nome base do arquivo a ser baixado. |
| Extensão customizada | Sobrescreve a extensão padrão (ex: .cf, .acl). |
| Prefixo de valor | Texto adicionado antes de cada valor (ex: deny ). |
| Sufixo de valor | Texto adicionado após cada valor (ex: ;). |
| Delimitador | Separador de colunas no CSV. |
| Incluir cabeçalho | Adiciona linha de cabeçalho ao CSV. |
| Incluir metadados | Acrescenta colunas de list_type, categoria, tipo, usuário e data. |
Templates de Exportação
Salve configurações de exportação frequentes como templates para reutilizar com um clique, sem precisar reconfigurar os filtros toda vez.
Configurar a exportação desejada
Preencha os filtros, formato, prefixo, sufixo e demais opções na aba Exportação Personalizada.
Clicar em Salvar Template
Clique no botão Salvar Template. Um painel aparece pedindo o nome e uma descrição opcional para o template.
Usar um template salvo
Acesse a aba Templates Rápidos. Cada template mostra o tipo de lista, formato e nome do arquivo. Clique em ↓ Exportar para baixar imediatamente com as configurações salvas.
Excluir template
Clique em ✕ no card do template para excluí-lo. Apenas admins e o criador do template podem excluí-lo.
Categorias e Tipos de Dado
Acesso exclusivo para Admin. Gerencie as categorias e tipos disponíveis para classificar os registros.
Acesse Categorias no menu. Cada categoria tem nome, descrição e uma cor identificadora. Use cores distintas para diferenciar categorias nos gráficos e na listagem.
Para criar: preencha o nome, descrição opcional e escolha uma cor. Clique em + Criar Categoria. Para editar, clique em Editar na linha da categoria. Categorias com registros vinculados não podem ser excluídas — remova os registros primeiro.
Acesse Tipos no menu. Tipos definem a natureza do dado: IP Address, Domain, Email, URL, CPF/CNPJ, Hash, Keyword, etc. Crie tipos personalizados conforme a necessidade.
Para criar: informe o nome e descrição opcional. Clique em + Criar Tipo. Tipos com registros vinculados não podem ser excluídos.
Gerenciamento de Usuários
Acesso exclusivo para Admin. Acesse Usuários no menu lateral.
| Funcionalidade | Admin | Colaborador |
|---|---|---|
| Visualizar listas | ✓ | ✓ |
| Adicionar registros | ✓ | ✓ |
| Editar registros | ✓ | ✓ |
| Excluir registros | ✓ | ✓ |
| Importar arquivos | ✓ | ✓ |
| Exportar dados | ✓ | ✓ |
| Gerenciar usuários | ✓ | — |
| Gerenciar categorias | ✓ | — |
| Gerenciar tipos | ✓ | — |
| Configurações do sistema | ✓ | — |
Criar novo usuário
Clique em + Novo Usuário. Preencha usuário, email, senha (mínimo 8 caracteres), perfil (Admin ou Colaborador) e se o 2FA estará ativo. Clique em Criar Usuário.
Editar usuário existente
Clique em Editar na linha do usuário. É possível alterar o perfil, ativar/desativar o 2FA e redefinir a senha. Deixe o campo de senha em branco para manter a senha atual.
Ativar ou desativar usuário
Clique no badge de status (● Ativo / ○ Inativo) diretamente na tabela para alternar o status sem abrir o modal. Usuários inativos não conseguem fazer login.
Excluir usuário
Clique em ✕ na linha do usuário. Não é possível excluir sua própria conta. Os registros inseridos pelo usuário excluído permanecem no banco.
Configurações do Sistema
Acesso exclusivo para Admin. Acesse Configurações no menu lateral. Três abas organizam as opções.
Define o nome da aplicação exibido na interface, a URL base do sistema (usada nos links de emails) e a quantidade de itens exibidos por página nas listagens.
Configure o servidor de email para envio dos códigos de verificação 2FA e links de recuperação de senha. Preencha host, porta, criptografia (TLS recomendado), usuário, senha, email e nome do remetente. Use o botão Testar Email para enviar uma mensagem de teste e confirmar que o SMTP está funcionando.
| Provedor | Host | Porta | Criptografia |
|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | TLS |
| Outlook | smtp.office365.com | 587 | TLS |
| Brevo | smtp-relay.brevo.com | 587 | TLS |
Ative a opção Exigir 2FA para todos os usuários para forçar a verificação em dois fatores em todo login, independente da configuração individual de cada usuário. Requer o SMTP configurado e funcionando.
Cada usuário pode escolher entre tema escuro e claro individualmente. A preferência é salva por conta e persiste entre sessões. O botão de alternância fica no rodapé da sidebar (ícone de sol/lua) e também na tela de Meu Perfil.