Skip to content

sipcapture/hepfix.js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HEPFIX.js

IPFIX to HEP/EEP adapter for Oracle / ACME Packet Net-Net SBCs

ORACLE / ACME PACKET Net-Net SBCs features a built in "Capture Agent" using a custom IPFIX template to export SIP messages and Statistics in realtime from the core. HEPFIX handles and converts IPFIX binary formats to HEP equivalents for using with HOMER and HEPIC without requiring port mirroring and switches/probes/agents.

Status

  • Working prototype w/ HEP support!
  • UDP/TCP Relay, RTP/RTCP QoS Reports

Install

npm install

Configure

Configure the IPFIX port and HEP Server settings using the config.json file:

{
  ipfix_config: {
    debug: false,
    IPFIX_PORT: 4739
  },
  hep_config: {
    debug: false,
    HEP_SERVER: '10.0.0.176',
    HEP_PORT: 9063,
    HEP_ID: 2017,
    HEP_PASS: 'oracme'
  }
}

Run

nodejs hepfix.js

Configure SBC Monitor

Enable the IPFIX comm-monitor using the following example and pointing at the HEPFIX IP and Port:

comm-monitor
    state           enabled
    qos-enable      enabled
    sbc-grp-id      0
    tls-profile
    monitor-collector
        address               192.168.122.1
        port                  4739
        network-interface     wancom0:0

Configuration can also be performed from the SBC User-Interface:

The SBC will send a Handshake packet and start mirroring enabled interface packets to HEPFIX

sh comm-monitor
 
Client                     State                 Protocol
===========================================================
192.168.122.1:4739         Connected             TCP      

WARNING: AN SBC REBOOT/SWITCHOVER MIGHT BE REQUIRED IF FIRST TIME USAGE SHOWS NO HANDSHAKES


IPFIX Types

Type Description Support
256 Handshake Recv x
257 Handshake Send x
258 SIP UDP Recv Msg Sent x
259 SIP UDP Send Msg Sent x
260 SIP TCP Recv Msg Sent x
261 SIP TCP Send Msg Sent x
SIP SCTP Recv Msg Sent
SIP SCTP Send Msg Sent
ENUM Recv Msg Sent
ENUM Send Msg Sent
268 QOS RTP/RTCP x
0 Keep Alive x

To-DO

  • TEST, TEST, TEST!
  • Convert QoS Reports to RTPAgent reports

Credits

Core Structures and GO version seeded by Negbie and project horaclifix

LEGAL

This software is provided as-is and without any warranty what-so-ever. See LICENSE for license details.

HEPFIX is an independent implementation of a generic IPFIX template with custom types based on open standards and definitions and permitted by EU Directive 2009/24/EC. HEPIX is not related, affiliated to or endorsed by ORACLE Communications in any way, form or shape.

ACME PACKET, PALLADION, OCOM are a trademarks of ORACLE Communications. All material rights reserved by their respective owners and not claimed by the author.