From efcf6a0db36e044b92b06843c9bf5ad6fea625cd Mon Sep 17 00:00:00 2001 From: "Eric A. Miller" Date: Sat, 1 Nov 2014 19:37:22 -0400 Subject: [PATCH] Support for Fortinet devices in new class L3::Fortinet --- ChangeLog | 1 + Info.pm | 7 ++ Info/Layer3/Fortinet.pm | 200 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 208 insertions(+) create mode 100644 Info/Layer3/Fortinet.pm diff --git a/ChangeLog b/ChangeLog index 177795be..202f5e5b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -6,6 +6,7 @@ version 3.21 () * Support obtaining FDB in Avaya SPBM edge deployments in L2::Baystack NOTE: This requires a RAPID-CITY MIB with the rcBridgeSpbmMacTable + * Support for Fortinet devices in new class L3::Fortinet [ENHANCEMENTS] diff --git a/Info.pm b/Info.pm index 382d2a36..5d820392 100644 --- a/Info.pm +++ b/Info.pm @@ -778,6 +778,12 @@ Subclass for Force10 devices. See documentation in L for details. +=item SNMP::Info::Layer3::Fortinet + +Subclass for Fortinet devices. + +See documentation in L for details. + =item SNMP::Info::Layer3::Foundry Subclass for Brocade (Foundry) Network devices. @@ -1510,6 +1516,7 @@ sub device_type { 9303 => 'SNMP::Info::Layer3::PacketFront', 10002 => 'SNMP::Info::Layer2::Ubiquiti', 12325 => 'SNMP::Info::Layer3::Pf', + 12356 => 'SNMP::Info::Layer3::Fortinet', 14179 => 'SNMP::Info::Layer2::Airespace', 14525 => 'SNMP::Info::Layer2::Trapeze', 14823 => 'SNMP::Info::Layer3::Aruba', diff --git a/Info/Layer3/Fortinet.pm b/Info/Layer3/Fortinet.pm new file mode 100644 index 00000000..9a920aa9 --- /dev/null +++ b/Info/Layer3/Fortinet.pm @@ -0,0 +1,200 @@ +# SNMP::Info::Layer3::Fortinet +# +# Copyright (c) 2014 Eric Miller +# All rights reserved. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are met: +# +# * Redistributions of source code must retain the above copyright notice, +# this list of conditions and the following disclaimer. +# * Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# * Neither the name of the University of California, Santa Cruz nor the +# names of its contributors may be used to endorse or promote products +# derived from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +# LIABLE FOR # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +# POSSIBILITY OF SUCH DAMAGE. + +package SNMP::Info::Layer3::Fortinet; + +use strict; +use Exporter; +use SNMP::Info::Layer3; + +@SNMP::Info::Layer3::Fortinet::ISA + = qw/SNMP::Info::Layer3 Exporter/; +@SNMP::Info::Layer3::Fortinet::EXPORT_OK = qw//; + +use vars qw/$VERSION %GLOBALS %FUNCS %MIBS %MUNGE/; + +$VERSION = '3.20'; + +%MIBS = ( + %SNMP::Info::Layer3::MIBS, + 'FORTINET-CORE-MIB' => 'fnSysSerial', + 'FORTINET-FORTIGATE-MIB' => 'fgVdMaxVdoms', +); + +%GLOBALS = ( + %SNMP::Info::Layer3::GLOBALS, +); + +%FUNCS = ( + %SNMP::Info::Layer3::FUNCS, +); + +%MUNGE = ( + %SNMP::Info::Layer3::MUNGE, +); + +sub vendor { + return 'fortinet'; +} + +sub model { + my $fortinet = shift; + my $id = $fortinet->id() || ''; + + my $model = &SNMP::translateObj($id); + + return $id unless defined $model; + + $model =~ s/^f[grsw][tfw]?//i; + return $model; +} + +sub os { + return 'fortios'; +} + +sub os_ver { + my $fortinet = shift; + + my $ver = $fortinet->fgSysVersion() || ''; + + if ( $ver =~ /(\d+[\.\d]+)/ ) { + return $1; + } + + return $ver; +} + +sub serial { + my $fortinet = shift; + + return $fortinet->fnSysSerial(); +} + +1; +__END__ + +=head1 NAME + +SNMP::Info::Layer3::Fortinet - SNMP Interface to Fortinet network devices. + +=head1 AUTHOR + +Eric Miller + +=head1 SYNOPSIS + + # Let SNMP::Info determine the correct subclass for you. + my $fortinet = new SNMP::Info( + AutoSpecify => 1, + Debug => 1, + DestHost => 'myswitch', + Community => 'public', + Version => 2 + ) + or die "Can't connect to DestHost.\n"; + + my $class = $fortinet->class(); + print "SNMP::Info determined this device to fall under subclass : $class\n"; + +=head1 DESCRIPTION + +Abstraction subclass for Fortinet network devices. + +For speed or debugging purposes you can call the subclass directly, but not +after determining a more specific class using the method above. + + my $fortinet = new SNMP::Info::Layer3::Fortinet(...); + +=head2 Inherited Classes + +=over + +=item SNMP::Info::Layer3 + +=back + +=head2 Required MIBs + +=over + +=item F + +=item F + +=item Inherited Classes' MIBs + +See L for its own MIB requirements. + +=back + +=head1 GLOBALS + +These are methods that return scalar value from SNMP + +=over + +=item $fortinet->vendor() + +Returns 'fortinet' + +=item $fortinet->model() + +Returns the chassis model. + +=item $fortinet->os() + +Returns 'fortios' + +=item $fortinet->os_ver() + +Returns the software version extracted from (C). + +=item $fortinet->serial() + +Returns the chassis serial number. + +(C) + +=back + +=head2 Globals imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=head1 TABLE METHODS + +These are methods that return tables of information in the form of a reference +to a hash. + +=head2 Table Methods imported from SNMP::Info::Layer3 + +See documentation in L for details. + +=cut