[go: nahoru, domu]

Skip to content

nmurilo/BeholderWifi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BeholderWifi

                    Beholder V. 0.8.9

      Nelson Murilo <nmurilo@gmail.com> (main author)

             No illegal activities are encouraged!
     I'm not responsible for anything you may do with it.

            This tool includes a portion of software developed 
            by Jean Tourrilhes for Wireless-Tools package. 

  1. What's beholder?

Beholder is a tool to detect some anomalies in wifi enviroment, such as suspicious changes in essid, also in mac encryption protocol or channel for legitime networks. Generate alerts for new "suspect" networks and it detects passive malicious hotspot tools, like karma, airbase-ng and hotpotter. It also can detects similar essid names and alert for APs suddenly disappear based on regular expressions. By default, beholder can detect Judicious KARMA, and some types of jamming


  1. Supported Systems

Beholder currently works only on Linux machines.


  1. Instalation

make sense

PS: Please ignore "warning: the use of mktemp' is dangerous, better use mkstemp or `mkdtemp'" message, we won't create a temporary files, that is only an easy way to create random essids.


  1. Usage

beholder [options] <wifi_device>

Options:

    -s      send reports to syslog instead to console. 
    -a      add new networks on the initial network table (usual option) 
    -r      regular expression to check essid name variations (case insensitive by default)
    -m      regular expression to check disappeared essid name 
    -c      clever mode. Detect similar essid based on same length and similar name. No regular expression here. 
    -d      debug 
    -dd     verbose  

Regular expression option works without limitations. Please spend a time to learn about regex to explore all potential of it.

Example: beholder -r ".[1i]nf[0o]s[3e]c." It matchs with "0infosec", "inf0sec","1nfosec-1", etc.

beholder -r ".[1i]nf[0o]s[3e]c." -m ".companynet." It matches with "0infosec", "inf0sec","1nfosec-1" and starts with "companynet"


  1. Reports and questions Please send comments, questions and bug reports to nmuriloatgmail.com.

  1. ACKNOWLEDGMENTS Many thanks to Andre, Luiz Eduardo, Ronaldo Vasconcellos and Willian Caprino for really nice ideas and bug reports.

About

WIDS - Beholder

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages