02. Getting started

Table of contents

• Initializing the database
• (Optional) Configure SSL
• Starting the web interface
• Running a scanner instance

Initializing the database

The database needs to be initialized before you can use CERTitude. In particular, a first account must be created, as well as the encryption master key. In order to do so, run python main.py run –c init Please note than future execution of this command will have no effect if the data.db file is already present and may corrupt it.

(Optional) Configure SSL

If you want to enable SSL support, make sure that you have openssl.exe or openssl in your PATH. Then run:

REM on Windows
cd ssl
gen-cert-for-me.bat

# On Linux
cd ssl
./gen-cert-for-me.bat

Then, open the config.py file and modify the following lines:

USE_SSL = True
SSL_KEY_FILE = '/path/to/key'
SSL_CERT_FILE = '/path/to/cer'

Starting the web interface

In order to configure CERTitude scanning environment, you will have to use the web interface which acts as a frontend to access the backend database. To start the web interface:

Windows:

Scripts\activate.bat
python main.py run –c interface

Linux:

. ./bin/activate.bat
python main.py run –c interface

This command starts a web server on your local IP on port 5000. You still need to open your browser to access it at http://localhost:5000 (or https://localhost:5000 if SSL is enabled). See chapter 3 for detailed explanations on how to use the web interface.

Running a scanner instance

Once you have configured your scans, you will be able to launch scanner instances. See more details on how to do it here.