Miscellaneous.
Changing the default language of fBuilder
Files included with fBuilder
Starting your firewall at boot time
Changing the default language of fBuilder:
The default language distributed with fBuilder is English, however fBuilder can be translated
to any language you choose to make it easier for your IT department. To change the language
seen on all of the screens in fBuilder you should translate the following files:
- language.conf
- column.html
- fbuilder.html
- fbuilderout.html
- docs/*.html
Translating the html files are self explanatory. The language.conf file is formated in the
following way:
key::value
To translate the file, change the value to the appropriate value for your desired language.
Please be aware that some lines span across two keys and should remain that way because fBuilder
must perform some action in the middle of those lines. For example:
pr_013::Choosing this option will have fBuilder grab the most common files
pr_014::and add them to the fingerprint
In fBuilder, this line reads 'Choosing this option will have fBuilder grab the most common files
and add them to the fingerprint'. Please be aware of this so that your interface will look correct
once the file has been translated.
Example Translation Format (English to French):
w_016::Yes
would become
w_016::Oui
InnerTek Software would gladly accept any translations that you perform for fBuilder and will give
credit for your translation in the language.conf file. If you translate fBuilder, please send us a copy
of the column.html, fbuilder.html, fbuilderout.html, and language.conf files so we can add the language
support for clients in your area!
Files included with fBuilder:
fBuilder creates or uses the following files:
- /usr/local/fbuilder/.fbuilder -- Used by the Firewall Wizard to store the data from the last use
- /usr/local/fbuilder/.fparse_cache -- Used by the Log Viewing application fParse.cgi to cache name lookups
- /usr/local/fbuilder/.hosts -- Stores the information of the firewall machine name
- /usr/local/fbuilder/.interfaces -- Stores the information of your interface configuration
- /usr/local/fbuilder/access_log -- The access log for the boa web server
- /usr/local/fbuilder/error.log -- The error log for the boa web server
- /usr/local/fbuilder/boa -- Web server for serving fBuilder cgi
- /usr/local/fbuilder/boa.conf -- Configuration of the boa web server
- /usr/local/fbuilder/column.html -- HTML for the left hand navigation
- /usr/local/fbuilder/docs/*.html -- Documentation files
- /usr/local/fbuilder/executescript -- Application for executing scripts
- /usr/local/fbuilder/fb-report -- Generates Reports and Alerts via email
- /usr/local/fbuilder/fb-report.conf -- Configuration file for fb-report
- /usr/local/fbuilder/fBuilder.cgi -- Main fBuilder application
- /usr/local/fbuilder/fBuilder_chains -- Application to execute commands
- /usr/local/fbuilder/fbuilder.conf -- Configuration file for fBuilder
- /usr/local/fbuilder/fbuilder.html -- Main fBuilder HTML file
- /usr/local/fbuilder/fbuilder.lic -- License file needed for applications to run
- /usr/local/fbuilder/fbuilderout.html -- HTML for after logout
- /usr/local/fbuilder/fParse.cgi -- Parses log files and displays results
- /usr/local/fbuilder/.fPrint -- Fingerprint data
- /usr/local/fbuilder/fPrint.cgi -- Fingerprinting application
- /usr/local/fbuilder/fw-init -- Main script created by fBuilder.
- /usr/local/fbuilder/graphics/* -- Graphics used by fBuilder
- /usr/local/fbuilder/index.html -- Sets up frames
- /usr/local/fbuilder/language.conf -- Configuration file for languages. Can be edited to translate fBuilder to
another language.
- /usr/local/fbuilder/popup.js -- Javascript for popup errors.
- /usr/local/fbuilder/rc.firewall -- The script created when using "Export" functions in the View Firewall screen.
You can use this script to start your firewall at boot time
- /usr/local/fbuilder/style.css -- Stylesheet for fBuilder
- /usr/local/fbuilder/updateCache.pl -- Can be run from Cron to keep your .fparse_cache up to date.
- /usr/local/fbuilder/wizard.cgi -- The Firewall Wizard application
- /root/loadmods.pl -- Can be used to load all firewall modules at boot time.
Starting your firewall at boot time:
To start your firewall at boot time, you will first want to create your firewall through fBuilder and Export to
rc.firewall on the View Firewall screen. Once the rc.firewall has been exported, you are ready. You should:
- Copy your rc.firewall to a safe location (other than /usr/local/fbuilder). This is a good idea so that you
don't accidentally overwrite your 'known good' configuration when working in the fBuilder interface
and have to start over
- Set your rc.firewall to be executable
- Open the startup script you would like to use. If you are unsure, check your system for rc.local
- Create the following items in the file:
- /root/loadmods.pl # Loads modules used for iptables
- %path to rc.firewall%/rc.firewall # Note %path to rc.firewall% should be the path where you put the file
- /usr/local/fbuilder/boa #Optional -- This will start the boa we server so you can access the fBuilder interface
- Save the file and exit.
Some people choose to leave the boa line out of the start up scripts because you don't need it to run the firewall
script. Others choose to add this line so they don't have to manually start boa every time they want to
work with fBuilder