https://github.com/ates/netspire-iptraffic

The IPTraffic module for serving VPN customers
https://github.com/ates/netspire-iptraffic

Last synced: 15 days ago
JSON representation

The IPTraffic module for serving VPN customers

• Host: GitHub
• URL: https://github.com/ates/netspire-iptraffic
• Owner: ates
• License: gpl-3.0
• Created: 2009-07-19T13:22:24.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2012-08-07T09:30:57.000Z (over 12 years ago)
• Last Synced: 2024-12-23T03:50:36.519Z (23 days ago)
• Language: Erlang
• Homepage:
• Size: 257 KB
• Stars: 9
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
The IPTraffic module for serving VPN customers

==============================================

Features:

* RADIUS authentication

* Realtime traffic calculation using [Netflow](http://en.wikipedia.org/wiki/Netflow) v5 as a traffic source

* Flexible tariffs (subnet rules, time rules)

* Using PostgreSQL database for the storing users, tariff plans, RADIUS attributes and sessions

* It's easy to add your own backends

Configuration

-------------

The following modules should be added to the netspire.conf file:

    {mod_iptraffic, [{tariffs, "tariffs.conf"}, {session_timeout, 60}, {delay_stop, 5}, {disconnect_on_shutdown, yes}]}

The default value of the **session_timeout** option is 60 seconds and may be ommited.

The ***delay_stop*** option is used to delay stopping of the session to receive all data from netflow sensor after the session closing (After receiving Accounting-Stop packet).

The default value of the ***delay_stop*** option is 5 seconds and and may be ommited.

The ***disconnect_on_shutdown*** option is used to specify is need to disconnect clients from NAS in case of application shutdown.

The default value of the ***disconnect_on_shutdown*** option is yes and may be ommited.

You MUST set **Acct-Interim-Interval** RADIUS attribute for client. This attribute is required to prolong session and it's value MUST be significantly less than **session_timeout**.

Note that if Netspire does not receiving interim updates from NAS via RADIUS, sessions will be marked as *expired* and closed, regardless of real state on NAS.

Be aware about **Acct-Interim-Interval** radius attribute limitation for Linux pppd. It should be no less then 60 seconds.

Also you need to load SQL schema objects from schema.sql file to the already created database.