Skip to content

NipperPrser gem is an unofficial parser for Titania Nipper Studio XML report.

License

Notifications You must be signed in to change notification settings

KINGSABRI/nipper_parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NipperParser

Gem Version Code Climate Codacy Badge
inch-ci

NipperParser gem is an unofficial parser for Titania Nipper Studio XML report.

Nipper Modules/Sections

Modules / Sections Supported
Information
Security Audit
Vulnerability Audit
CIS Benchmarks
STIG Compliance
SANS Policy Compliance
PCI Audit
Filtering Complexity
Configuration Report
Raw Configuration
Raw Change Tracking
Appendix

Installation

gem install nipper_parser

Usage

Report information
require 'nipper_parser'
nipper_parser = NipperParser::Config.open('network-devices.xml') 
puts nipper_parser.information.title
puts nipper_parser.information.author
puts nipper_parser.information.date
puts nipper_parser.information.devices 
Dealing with Security Audit
pp security_audit = nipper_parser.security_audit
pp security_audit.findings
finding = security_audit.findings[0]              # Play wit a finding
pp finding.class
pp finding.index
pp finding.title
pp finding.rating
pp finding.ref
pp finding.affected_devices
pp finding.finding
pp finding.impact
pp finding.recommendation
Report Summaries
pp security_audit.introduction.class
pp security_audit.introduction.title
pp security_audit.introduction.date
pp security_audit.introduction.security_issue_overview

pp security_audit.conclusions.class
pp security_audit.conclusions.per_device
pp security_audit.conclusions.list_critical

pp security_audit.recommendations.list

pp security_audit.mitigation_classification.class
pp security_audit.mitigation_classification.list_by.fixing[:involved]
pp security_audit.mitigation_classification.list_by.fixing[:involved][0].rating[:rating]
pp security_audit.mitigation_classification.list_by.rating[:high]
pp security_audit.mitigation_classification.list_by.rating[:high][0].rating[:fix]
pp security_audit.mitigation_classification.statistics.class
pp security_audit.mitigation_classification.statistics.findings
pp security_audit.mitigation_classification.statistics.report

Fore more comprehensive usage, please refer to Parsers ReadMe

Download a dummy XML report to test the library from here.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/nipper_parser.

License

The gem is available as open source under the terms of the MIT License.