index.html.erb - warvox - VoIP based wardialing tool, forked from rapid7/warvox.
(HTM) git clone git://jay.scot/warvox
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
---
index.html.erb (5622B)
---
1 <div class="row">
2 <div class="span3">
3 <div class="sidebar">
4 <ul class="nav nav-list">
5 <li class="active"><a href="#"><i class="fa fa-play"></i> Getting Started</a></li>
6 <li><a href="#"><i class="fa fa-book"></i> Library</a></li>
7 <li><a href="#"><i class="fa fa-pencil"></i> Applications</a></li>
8 <li><a href="#"><i class="fa fa-cogs"></i> Settings</a></li>
9 </ul>
10 </div>
11 </div>
12 <div class="span9">
13
14 <h1 class='title'>Introduction</h1>
15
16 <p>
17 WarVOX is a suite of tools for exploring, classifying, and auditing telephone systems. Unlike normal wardialing tools,
18 WarVOX works with the actual audio from each call and does not use a modem directly. This model allows WarVOX to find
19 and classify a wide range of interesting lines, including modems, faxes, voice mail boxes, PBXs, loops, dial tones, IVRs,
20 and forwarders. WarVOX provides the unique ability to classify all telephone lines in a given range, not just those
21 connected to modems, allowing for a comprehensive audit of a telephone system.
22 </p>
23
24 <h1 class='title'>Getting Started</h1>
25 <p>
26 In order to make phone calls, WarVOX needs to be configured with one or more service providers. For a list of compatible VoIP ISPs, please see the <a href="http://warvox.org/#Providers">Service Providers</a> section of the WarVOX web site. To add a new provider to WarVOX, access the web interface, click the <a href="/providers">Providers</a> link, and fill in the <b>New Provider</b> form. This form allows you to specify a nickname for the provider and indicate how many concurrent outbound calls can be made using this account. WarVOX can make use of multiple service providers and multiple outbuond calls per provider when processing jobs.
27 </p>
28
29 <p>Once one or more service providers have been configured, click the <a href="/jobs/">Jobs</a> link. This will present a form that asks for the phone number range to dial, the number of seconds of audio to capture, and the maximum number of outgoing lines to use for this job.
30 </p>
31
32 <p>The phone number range is specified by entering the phone number (including country code), with numbers replaced by X's where an entire range should be dialed. For example, the value 1-512-555-XXXX will make 10,000 calls, one to each number within the 512-555 exchange. In contrast, the value 1-512-555-555X will only make 10 calls, covering 5550 to 5559. Only 5 digits of the phone number range can be masked.
33 </p>
34
35 <p>
36 The seconds field indicates the number of seconds to spend on each call, including the ring time. The larger the value, the more audio that can be captured, but you run the risk of leaving silent voice mail messages if this value is too large. Keep in mind that many per-minute service providers include ring time in the billing and round up to the nearest minute. This rounding is why the default value is set to 53 seconds. Most service providers do not charge for calls which were not answered.
37 </p>
38
39 <p>
40 The outgoing line count is limited by the number of providers available and the number of lines available at each provider. If you are dialing a range with a limited number of inbound lines, the outgoing line count should be set to a small value, otherwise leave this value at the maximum number of available lines to complete jobs as quickly as possible. Each concurrent outbound call requires approximately 80kbits/s of downstream bandwidth.
41 </p>
42
43 <p>The Caller ID is specified by entering the phone number (including country code), with numbers replaced by X's where parts of the number should be chosen randomly. This field also accepts the special value of "SELF", which will cause all calls to be made with the Caller ID set to the destination number (useful for testing poorly implemented voice mail security).
44 </p>
45
46 <p>
47 Once the job parameters have been specified, click the <b>Create</b> button to start dialing. If you return the main <a href="/jobs/">Jobs</a> screen you can track the progress of the job via the percentage value in the active jobs table. The amount of time a given job takes depends on the number of phone numbers within the range, the number of seconds of audio to record, and the number of concurrent outbound lines. A 1,000 number range with 53 seconds of audio and 10 outbound lines would take approximately 100 minutes to complete.
48 </p>
49
50 <p>
51 After the job completes, access the <a href="/calls/">Results</a> link to view a listing of finished jobs. Click the <b>View</b> link to look at the raw call breakdown. To analyze the call data, click on the Results link, and then click the <b>Analyze Calls</b> link. Depending on the speed of your server, this can take up to 60 seconds per connected call to process all of the data. Once the data has been processed, the results will now be listed under the <a href="/analyze/">Analysis</a> link. Viewing the results will provide the signal graph, spectrum graph, and an audio player to hear the actual call.
52 </p>
53
54
55 <h1 class='title'>Troubleshooting</h1>
56 <p>
57 If for some reason WarVOX is not working correctly, or if you have any questions, please contact the WarVOX development team at warvox[at]metasploit.com. To determine whether software dependencies have been satisfied, you can use the <b>bin/verify_install.rb</b> Ruby script included with the WarVOX distribution. The <a href="/home/about/">About</a> page also includes detailed information that may help resolve installation issues. If your calls fail to produce any results, double check the Provider configuration. To obtain the latest version of this software, please check the <a href="http://warvox.org/">WarVOX Web Site</a>.
58 </p>
59
60 </div>
61 </div>