amlight/ofp_snifferEin OpenFlow-Sniffer zur Unterstützung der Netzwerkfehlersuche in Produktionsnetzwerken.
OFP_Sniffer ist ein OpenFlow-Sniffer zur Fehlerbehebung und zu Lernzwecken.
Derzeit in Version 1.2 zerlegt es alle OpenFlow 1.0-Nachrichten, arbeitet mit InfluxDB, Grafana und Slack. OpenFlow 1.3 wird in OFP_Sniffer Version 1.3 verfügbar sein (bald erhältlich).
Es arbeitet direkt in der Linux-Shell und zerlegt alle OpenFlow-Nachrichten auf der Leitung oder aus libpcap-Dateien. Mit OFP_Sniffer können Sie OpenFlow-Nachrichten und zugehörige Fehler (falls vorhanden) einfach verfolgen, ohne X11 oder Wireshark zu öffnen. OFP_Sniffer wurde in Python 3.6 geschrieben, um die AmLight-SDN-Bereitstellung (www.sdn.amlight.net) zu unterstützen. AmLight SDN verwendet Internet2 FlowSpace Firewall, OESS und On.Lab ONOS, und diese Apps wurden getestet und werden vollständig unterstützt.
Als Befehlszeilentool hat es einige Eingabeparameter:
# ./ofp_sniffer.py -h
Usage:
./ofp_sniffer.py [-p min|full] [-f pcap_filter] [-F filter_file] [-i dev] [-r pcap_file]
-p : print all TCP/IP headers. Default: min
-f pcap_filter or --pcap-filter=pcap_filter: add a libpcap filter
-F filters_file.json or --filters-file=filters.json
-i interface or --interface=interface. Default: eth0
-r captured.pcap or --src-file=captured.pcap
-T topology.json or --topology-file=topology.json
-w file or --save-to-file=file: save output to file provided
-o or --print-ovs : print using ovs-ofctl format
-h or --help : prints this help
-c or --no-colors: removes colors
-v or --version : prints version
-O WARN:CRIT or --oess-fvd=WARN:CRIT: monitor OESS FVD status
-N or --notify-via-slack: send notifications via Slack. Param is the Slack channel
-S or --enable-statistics: creates statistics
Ab Version 1.0 werden Apps unterstützt, um spezifische Anforderungen zu erfüllen, wie das Verfolgen von OESS-FVD-Nachrichten oder das Erstellen von Statistiken über REST und die Integration in NMS (z. B. Zabbix).
Weitere Informationen: https://amlight.net/wp-content/uploads/2015/03/wpeif-2016-ofpsniffer.pdf
##################### Installation ######################
Requires Python 3.6
git clone https://github.com/amlight/ofp_sniffer.git
cd ofp_sniffer
pip3.6 install -r docs/requirements.txt
sudo ./ofp_sniffer.py
##################### Beispiele #########################
Beispiele werden unten aufgeführt:
---------------------- -------------------------
| Mininet | | OVS-OFCTL 2.3.0 |
| 192.168.56.101:6634| <-------> | eth1 - 192.168.56.102 |
---------------------- -------------------------
# ovs-ofctl dump-flows tcp:192.168.56.101:6634
cookie=0x0, duration=2183.377s, table=0, n_packets=0, n_bytes=0, idle_age=2183, in_port=1,dl_vlan=2 actions=output:2
# ./ofp_sniffer.py -i eth1 -f " or port 6634"
Sniffing device eth1
2015-09-13 11:47:38.655503 192.168.56.102:37450 -> 192.168.56.101:6634 Size: 74
OpenFlow Version: 1.0(1) Type: Hello(0) Length: 8 XID: 1
1 OpenFlow Hello
2015-09-13 11:47:38.656964 192.168.56.101:6634 -> 192.168.56.102:37450 Size: 74
OpenFlow Version: 1.0(1) Type: Hello(0) Length: 8 XID: 174
174 OpenFlow Hello
2015-09-13 11:47:38.657638 192.168.56.102:37450 -> 192.168.56.101:6634 Size: 86
OpenFlow Version: 1.0(1) Type: Vendor(4) Length: 20 XID: 2
2 OpenFlow Vendor : NICIRA(0x2320)
2 OpenFlow Vendor Data: 12 2
2015-09-13 11:47:38.657870 192.168.56.102:37450 -> 192.168.56.101:6634 Size: 74
OpenFlow Version: 1.0(1) Type: BarrierReq(18) Length: 8 XID: 3
3 OpenFlow Barrier Request
2015-09-13 11:47:38.659270 192.168.56.101:6634 -> 192.168.56.102:37450 Size: 74
OpenFlow Version: 1.0(1) Type: BarrierRes(19) Length: 8 XID: 3
3 OpenFlow Barrier Reply
# ovs-ofctl add-flow tcp:192.168.56.101:6634 "dl_dst=10:00:00:01:20:00,dl_type=0x88bc actions=mod_vlan_vid:14,output:2"
# ./ofp_sniffer.py -i eth1 -f " or port 6634"
2015-09-13 11:49:08.171463 192.168.56.102:37451 -> 192.168.56.101:6634 Size: 154
OpenFlow Version: 1.0(1) Type: FlowMod(14) Length: 88 XID: 2
2 OpenFlow Match - wildcards: 3678439 dl_type: 0x88bc dl_dst: 10:00:00:01:20:00
2 OpenFlow Body - Cookie: 0x00 Command: Add(0) Idle/Hard Timeouts: 0/0 Priority: 32768 Buffer ID: 0xffffffff Out Port: 65535 Flags: Unknown Flag(0)
2 OpenFlow Action - Type: SetVLANID Length: 8 VLAN ID: 14 Pad: 0
2 OpenFlow Action - Type: OUTPUT Length: 8 Port: 2 Max Length: 0
# ovs-ofctl del-flows tcp:192.168.56.101:6634 "dl_type=0x88bc,dl_dst=10:00:00:01:20:00, "
2015-09-13 11:50:43.636925 192.168.56.102:37454 -> 192.168.56.101:6634 Size: 138
OpenFlow Version: 1.0(1) Type: FlowMod(14) Length: 72 XID: 2
2 OpenFlow Match - wildcards: 3678439 dl_type: 0x88bc dl_dst: 10:00:00:01:20:00
2 OpenFlow Body - Cookie: 0x00 Command: Delete(3) Idle/Hard Timeouts: 0/0 Priority: 32768 Buffer ID: 0xffffffff Out Port: 65535 Flags: Unknown Flag(0)
# ovs-ofctl add-flow tcp:192.168.56.101:6634 "dl_dst=10:00:00:01:20:00,dl_type=0x88bc actions=mod_vlan_vid:14,output:2"
2015-09-13 11:52:58.563737 192.168.56.102:37455 -> 192.168.56.101:6634 Size: 154
OpenFlow Version: 1.0(1) Type: FlowMod(14) Length: 88 XID: 2
2 OpenFlow Match - wildcards: 3678439 dl_type: 0x88bc dl_dst: 10:00:00:01:20:00
2 OpenFlow Body - Cookie: 0x00 Command: Add(0) Idle/Hard Timeouts: 0/0 Priority: 32768 Buffer ID: 0xffffffff Out Port: 65535 Flags: Unknown Flag(0)
2 OpenFlow Action - Type: SetVLANID Length: 8 VLAN ID: 14 Pad: 0
2 OpenFlow Action - Type: OUTPUT Length: 8 Port: 2 Max Length: 0
Verwendung von Filtern:
Bei Verwendung der Option -F ./filters.json haben Sie einige Optionen:
"rejected_of_types": Wird verwendet, um auszuwählen, welche OpenFlow-Nachrichtentypen Sie NICHT sehen möchten. Sie können verschiedene Filter je nach OpenFlow-Version definieren.
Filter nach Ethertype:
Wenn Sie nach einem bestimmten Ethertype suchen, der von PacketOut- oder PacketIn-Nachrichten transportiert wird, können Sie alle anderen ablehnen und erhalten so eine einfache Visualisierung.
Beispiel:
"filters":{
"ethertypes": {
"lldp" : 0,
"fvd" : 0,
"arp" : 1,
"others": [ "88b5" ]
},
"packetIn_filter": {
"switch_dpid": "any",
"in_port": "any"
},
"packetOut_filter": {
"switch_dpid": "any",
"out_port": "any"
}
}
}
Im Abschnitt ethertype bedeutet 1 filtern, 0 bedeutet anzeigen. Im bereitgestellten Beispiel werden ARP-Nachrichten nicht angezeigt, während OESS FVD und LLDP angezeigt werden. Sie können die hexadezimale Ethertype-Nummer (ohne 0x) im Abschnitt "others" hinzufügen, indem Sie Kommas (",") hinzufügen.
"packetIn_filter": Wird verwendet, um zu definieren, welche PacketIn + LLDP-Nachrichten Sie SEHEN möchten. Sie können pro Switch und/oder pro Port definieren. Für den Switch müssen Sie die datapath_id verwenden, wie sie von der verwendeten Anwendung gesehen wird. Beispielsweise füllen einige Apps das Feld c_id mit of:dpid_id, andere mit dpid:dpid_id. Für Ports verwenden Sie die OpenFlow-port_id, nicht den Portnamen. Beispielsweise ist auf Brocade eth1/1 == 1. Verwenden Sie also 1 statt eth1/1.
"packetOut_filter": Wird verwendet, um zu definieren, welche PacketOut + LLDP-Nachrichten Sie SEHEN möchten. Sie können pro Switch und/oder pro Port definieren. Für den Switch müssen Sie die datapath_id verwenden, wie sie von der verwendeten Anwendung gesehen wird. Beispielsweise füllen einige Apps das Feld c_id mit of:dpid_id, andere mit dpid:dpid_id. Für Ports verwenden Sie die OpenFlow-port_id, nicht den Portnamen. Beispielsweise ist auf Brocade eth1/1 == 1. Verwenden Sie also 1 statt eth1/1.
Unterstützung für OpenFlow-Proxys:
Bei Verwendung eines OpenFlow-Proxys sehen Sie je nach ausgewählter Schnittstelle zum Sniffen eine der beiden Möglichkeiten:
IP_Controller <-> IP_Proxy IP_Proxy <-> IP_Switch
Es ist schwer zuzuordnen, welcher Controller mit welchem Switch spricht. Um diese Fehlerbehebung zu erleichtern, überwacht der OpenFlow-Sniffer automatisch alle PacketOut- und LLDP-Nachrichten, um ein Wörterbuch von {(IP, Port): name_switch} zu erstellen. Wenn dies bei Ihnen der Fall ist, ändern Sie die Datei docs/topology.json. Wenn Sie den Sniffer das nächste Mal ausführen, sehen Sie die IP und in Klammern das Gerät hinter dem Proxy. Beispiel:
2015-12-16 15:37:41.563621 200.0.207.79(andes1):7801 -> 190.103.184.135:6633 Size: 157 Bytes
OpenFlow Version: 1.0(1) Type: PacketIn(10) Length: 103 XID: 0
0 PacketIn: buffer_id: 0xffffffff total_len: 85 in_port: 49 reason: OFPR_NO_MATCH(0) pad: 0
0 Ethernet: Destination MAC: ff:ff:ff:ff:ff:ff Source MAC: de:ad:be:ef:ba:11 Protocol: 0x8100
0 Ethernet: Prio: 0 CFI: 0 VID: 3720
0 LLDP: Chassis Type(1) Length: 7 SubType: 4 ID: of:cc4e249102000000
0 LLDP: Port Type(2) Length: 5 SubType: 2 ID: 2
0 LLDP: TTL(3) Length: 2 Seconds: 120
0 LLDP: END(0) Length: 0
2015-12-16 15:37:41.564414 190.103.184.133(andes1):56132 -> 190.103.187.72:6633 Size: 165 Bytes
OpenFlow Version: 1.0(1) Type: PacketIn(10) Length: 99 XID: 0
0 PacketIn: buffer_id: 0xffffffff total_len: 81 in_port: 49 reason: OFPR_NO_MATCH(0) pad: 0
0 Ethernet: Destination MAC: ff:ff:ff:ff:ff:ff Source MAC: de:ad:be:ef:ba:11 Protocol: 0x8942
0 LLDP: Chassis Type(1) Length: 7 SubType: 4 ID: of:cc4e249102000000
0 LLDP: Port Type(2) Length: 5 SubType: 2 ID: 2
0 LLDP: TTL(3) Length: 2 Seconds: 120
0 LLDP: END(0) Length: 0
Der Name (andes1) repräsentiert einen Switch namens "andes1" mit DPID cc4e249126000000. Beachten Sie, dass die im Beispiel gezeigte DPID nicht dieselbe ist, da eine PacketIn-Nachricht als Beispiel verwendet wird. PacketIn zeigt die DPID der Nachbarn von "andes1".
Ich hoffe, dieser Code hilft Ihnen.
Fragen/Vorschläge: AmLight Dev Team [email protected]