Skip to content

Running Reference Tools

Milton Smith edited this page Sep 2, 2016 · 2 revisions

INSTALLATION & USE INSTRUCTIONS, 1) DOWNLOAD BINARIES or compile source, 2) make sure Java 8+ installed, 3) download dvUI.jar to your desktop from the Release tab near the top of the screen, double-click to run.

CAUTION, use care to review reports for sensitive information prior to distribution or posting to the Internet

RUNNING FROM DESKTOP, simply double-click on the dvGUI.jar on your desktop or launch the desktop application from the command line. Note: there are no command line options when staring the DeepViolet GUI from the command line.
java -jar dvUI.jar deepviolet-git

RUNNING FROM COMMAND LINE, The following command line executes a scan against www.github.com and includes all reporting sections. The output of the report is the same as the sample included in this file.
java -jar dvCMD.jar -serverurl https://www.github.com/

The following command line produces the same report but specifies each report section individually. Including less sections increases the speed of the scan.
java -jar dvCMD.jar -serverurl https://www.github.com/ -s thrcisn

The following command line exports the certificate on www.github.com to a PEM encoded file for offline use. java -jar dvCMD.jar -serverurl https://www.github.com/ -wc ~/milton/DeepViolet/github.pem

Conversely the following command line reads a PEM encoded certificate and generates a report ('s' option) by default. Note: the -rc option is mututually exclusive with other options. The primary reason is that -rc is an offline reporting function. Whereas other options are applicable for online servers.
java -jar dvCMD.jar -rc ~/milton/DeepViolet/github.pem

If you need some help while your in the shell, command line help is available.
java -jar dvCMD.jar -h

The previous help command produces output like the following.
dvcmd-snapshot

DEEPVIOLET API IN YOUR PROJECT, Include DeepViolet API within your own Java project to extend your projects SSL/TLS scanning capabilities. To get started check out the samples package, com.mps.deepviolet.api.samples Generate your own JavaDocs or view the pregenerated API documentation available in the docs folder.

FEATURE REQUESTS & BUG REPORTS, See DeepViolet Wiki This project leverages the works of other open source community projects and is provided for educational purposes. Use at your own risk. See LICENSE for further information.