Project

kekkan

0.0
No commit activity in last 3 years
No release in over 3 years
kekkan is an SAX XML parser and database for NVD CVE and CPE XML files.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.6.8, ~> 1.6
>= 4.2.6, ~> 4.2
 Project Readme

#Kekkan

Gem Version Build Status
Code Climate Inline docs

Kekkan is a parser and ActiveRecord database for NVD version 2.0 CVE and CPE XML files. The CVE feed can be found on the NVD here.

The name comes from the Japanese word for 'flaw/defect'.

Requirements

##Ruby Keigan has been tested with ruby-1.9.2-p320, ruby-1.9.3-p125. Please try to use one of these versions if possible. I recommend using RVM to setup your ruby environment you can get it here.

RubyGems

Kekkan relies heavily on RubyGems to install other dependencies I highly recommend using it. RubyGems is included by default in the 1.9.x versions of Ruby.

  • rails
  • yaml
  • nokogiri

Installation

Installation is really easy just gem install!

% gem install kekkan

Database Setup

% kekkan --create-config
% $EDITOR kekkan.cfg
% kekkan --create-tables
  1. Generate the kekkan.cfg file.
  2. Edit the kekkan.cfg file, filling in the variables as needed.
  3. Migrate the database schema.

Parsing NVD CVE XML

% kekkan nvdcve-2.0-2012.xml [nvdcve-2.0-2011.xml ...]
  1. Parse the files by passing their names on the command line.

Viewing Data

The data can be queried with a built in console or with an external database viewer. The data is mostly for consumption from another program.

% kekkan --console

Contributing

If you would like to contribute bug fixes/etc to Kekkan. The easiest way is to fork the project on github and make the changes in your fork and the submit a pull request to the project.

Issues

If you have any problems, bugs or feature requests please use the github issue tracker.

Contact

You can reach the team at jacob.hammack[at]hammackj[dot]com.

You can also contact the team on IRC on irc.freenode.net, #risu