0.01
Low commit activity in last 3 years
No release in over a year
Unofficial parser for Titania Nipper Studio XML report.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.2, >= 2.2.10
~> 12.3, >= 12.3.3

Runtime

~> 1.12, >= 1.12.2
 Project Readme

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.