nipper_parser

NipperParser

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.