Модуль организации Dialup и VPN доступа.

• Тарификация по времени
• Тарификация по трафику в зависимости от времени суток
• Периодические отчисления (месячная и дневная абонплата)
• Возможность раздельной и совместной тарификации по времени и трафику
• Ограничение доступа в Интернет по времени суток
• Система скидок
• Кредитный лимит пользователя и тарифного плана.
• Установка минимальной цены сессии
• Тарифы с возможностью предоплаты и оплаты по факту использования
• Работа с неограниченным количеством NAS серверов
• Авторизация по SQL базе данных или по системной UNIX базе паролей
• Авторизация по PAP, CHAP, MS-CHAP, MS-CHAPv2 (CHAP при сохранении паролей в SQL базе)
• MPPE - шифрование трафика
• Авторизация PPPOE по MAC адресу
• Авторизация PPTP по IP адресу (для MPD по IP и MAC одновременно)
• Изменение тарифного плана или снятие денег со счета по расписанию
• Классы трафика
• Ограничение скорости в зависимости от класса трафика (Только для NAS exppp)
• Создание месячных, предоплаченных по трафику, пакетов
• Дневные, недельные и месячные лимиты по трафику и времени
• Отчёты по работе системы и состоянию счетов за любой период времени
• Генерация и отправка администратору ежедневных и месячных отчётов по работе системы
• Уведомление клиентов о завершении денег на счету
• Права доступа для администраторов
• Привязка администратора к группе.
• Лог действий администратора, менеджера
• Ограничение сессий по количеству общего (in+out) трафика (для exppp, mpd, pppd + RADIUS plugin (Linux))
• Несъёмный минимум для подключений к NAS серверам (Tarif Plans → Credit Tresshold)
• Смена пароля из пользовательского интерфейса
• Изменение тарифного плана из пользовательского интерфейса.
• Перевод пользователей с негативным депозитом в гостевой доступ оставляя возможность только проверки баланса .
• Закрытие выбранных ресурсов для пользователей с негативным балансом.
• Перенос неиспользованного предоплаченного трафика с предыдущих периодов .
• Дополнительный денежный счёт для абон. платы
• Совместный сервис. Использование параметров одного тарифного плана между несколькими пользователями (Общая скорость, общий предоплаченный трафик)
• Установка суммы минимальной наработки за месяц
• Callback
• Турборежим (При использовании расширения Turbo)

Деньги снимаются со счета пользователя в конце сессии. Чтобы пользователь не зашёл в минус, перед началом сессии для exppp, mpd, mikrotik ppp (с патчем http://abills.asmodeus.com.ua/wiki/doku.php?id=abills:docs:mpd:ru ), linux pppd, Mikrotik OS ppp ставится лимит сессии по времени и по трафику. Для других NAS серверов только по времени. Чтобы пользователи для NAS серверов, не имеющие возможности устанавливать лимиты трафика на сессию, не уходили в минус или для того, чтобы постоянно контролировался расход денег, например снятие абон. платы и других отчислений, нужно включить запускать в кроне программу /usr/abills/libexec/billd

/etc/crontab

*/5 * * * * root /usr/abills/libexec/billd

abills/libexec/config.pl

@MODULES = (
          'Dv'
          );

$conf{DV_USER_SERVICE_HOLDUP}='min_period:max_period:holdup_period:daily_fees:hold_fees_deposit:active_fees:holdup_skip_gids'; 	

Приостановка действия сервиса пользователя из личного кабинета. При приостановленном сервисе абонент не может пользоваться услугой, абон. плата также не снимается. Снятием данного начисления занимается periodic daily Приостановка возможна не чаще чем раз в месяц. Если уже была приостановка то окно приостанови не отображается.

в случае если штатные сообщения системы не устраивают можно их заменить собственными через опцию $conf{DV_WARNING_EXPR} . Если указать в ней текст он будет отображаться в информационной панели. Также можно запустить внешнюю программу, а вывод показать абоненту и администратору.

$conf{DV_WARNING_EXPR}='CMD:/usr/abills/misc/dv_warning.pl LOGIN=%LOGIN% LANGUAGE=%language%';

По умолчания в биллинге используется команда ping для диагностики соединения. Но можно расширить инструменты диагностики за счет внешних программ при помощи опции DV_EXTERNAL_DIAGNOSTIC.

Объявление:

NAME:CMD ARGS 

Список возможных аргументов:

USER_NAME
SESSION_START
ACCT_SESSION_TIME
ACCT_INPUT_OCTETS
ACCT_OUTPUT_OCTETS
EX_INPUT_OCTETS
EX_OUTPUT_OCTETS
CONNECT_TERM_REASON
FRAMED_IP_ADDRESS
LAST_UPDATE
NAS_PORT
NAS_IP_ADDRESS
CALLING_STATION_ID
CONNECT_INFO
ACCT_SESSION_ID
NAS_ID
ACCT_SESSION_STARTED
ACCT_INPUT_GIGAWORDS
ACCT_OUTPUT_GIGAWORDS
FILTER_ID

Пример Использование ARP Ping

$conf{DV_EXTERNAL_DIAGNOSTIC}='ARPPING:arping %CALLING_STATION_ID%';

Если нужно обявить несколько внешних программ это можно сделать через точку с запятой (;)

ARP Ping для mikrotik

$conf{DV_EXTERNAL_DIAGNOSTIC}='/usr/abills/Abills/modules/Dv/arping.pl ACCT_SESSION_ID=%ACCT_SESSION_ID%';

Регистрация IP/MAC адреса клиента для последующей выдачи статического адреса данному клиенту в сети. Абонент подключается в гостевом режиме, его перенаправляет на страницу логина в личный кабинет. Абонент переходит в кабинет и нажимает кнопку зарегистрироваться. Система автоматически ищет следующий свободный рабочий адрес и присваивает его клиенту прописывая в таблице адресов DHCP. Свободные адреса ищутся в журнале DHCP сети ( / Настройка / IP (DHCP) Сети ). Если в пуле раздаваемых адресов не установлена опция статическая сеть, система возвращает адрес 0.0.0.0. Что разрешает раздавать таким абонентам динамические IP адреса.

Опция работает при включённом модуле Dhcphosts

Форма регистрации

Включение опции

$conf{DV_IP_DISCOVERY}='1:129.168.0.0/24:PORTS,VID,NAS_ID;NET_ID:ADDRESS_RANGE:CHECK_PARAMS';

NET_ID - в какую DHCP сеть регистрировать клиента (Dhcp сети).

ADDRESS_RANGE - диапазон адресов куда должен попадать незарегистрированный клиент. Если не указать эту опцию все клиенты попадают в общую сеть указанную в первом параметре. Шаблоны сравнения указываются через точку с запятой. Если не указывать диапазон система будет пробовать авторегистрировать все адреса, а тем которых нет в журнале онлайн показывать ошибку 112.

CHECK_PARAMS - Параметры которые заносятся в базу после регистрации Возможны:

PORTS - Порт
VID - Влан ID
SERVER_VID - SERVER Влан ID
NAS_ID - Номер сервера доступа
IP - IP
MAC - MAC

Также можно задать предустановленные параметры, они не будет брать реальное значение из лиз файла, а будут использовать значение с конфигурационного файла

Например:

 IPN_ACTIVATE=1
 OPTION_82=1

Ошибки включения сервиса

При возникновении определённых событий система может вызывать внешние программы их обработки.
Для вызова таких программ, нужно прописать в конфигурационном файле название файла обработки и путь к нему. При определении внешних обработчиков можно указывать дополнительные флаги.
При вызове внешних обработчиков, система передаёт им определенный параметры и ожидает ответа в формате:

флаг_успешного_выполнения:информационное_сообщение_для_системы

Пример ответа об успешном выполнении внешнего обработчика:
1:INFO=Операция выполнена

Пример программы . Возвращает код успешного выполнения

#!/bin/sh
# External щзукфешщт example

echo "1:INFO=Operation complite. Arguments: '$@'";

• Тарифные планы
• Классы трафика
• Группы тарифных планов

• Журнал абонентов
• Управление услугой
• Изменении тарифного плана
• Компенсация
• Тест - Тестирование подключения
• Турбо режим (Turbo MODE)
• Памятка абонента
• Статистика
  • Детализация

/Отчёты/Internet /

Отчёты работы модуля

• Использовано - отчёт про использованное время и траффик с возможностью выбора по временным периодам, группам.
• Последние входы - Полный список сессий по всем пользователям с возможностью поиска
• Ошибки подключения клиентов - Полный список всех попыток подключений пользователей
• Turbo - отчёт по работе модуля Turto
• Должники - Список должников
• Тарифные планы - Отчет распределения тарифных планов

• Мониторинг

В системе предусмотрена регистрация пользователей через веб интерфейс. Адрес регистратора: https://your.host:9443/registration.cgi

Для включения регистрации нужно заполнить переменную в конфигурационном файле.

 @REGISTRATION = ('Dv');

После регистрации пользователь получает письмо с персональной информацией касающейся аккаунта, а админисратор уведомление о регистрации нового пользователя.

Контролер Dv соединений. Программа следит за балансом пользователей, состоянием аккаунта, состоянием услуги и повисшими сессиями.

• Hanguped Login: knish DEPOSIT: -112.085652 CREDIT: -12.085652 SESSION_SUM: 5.28290305137634 SESSION_ID: RFxmphPuwf

Завершение сессии при отрицательном балансе

• Error: Lost Alive / Login: rambo, Last Alive: 2007-10-05 21:54:19, Session-ID: GiK72BJT5E

Не было RADIUS Alive (пакетов подтверждающих активность абонентов) более 3 alive периодов

Перенос зависшей сессии в Zap. Система считает сессию не активной так как определённое время не приходят RADIUS Alive пакеты (периодические пакеты которые сообщают что лик еще работает) и переносит её в подозрительные сессии. Время прихода RADIUS Alive определяется в настройках сервера доступа.
Данная ситуация возникает:

1. если по какой то причине потерялся Alive пакет
2. Если сервер доступа перезагрузился в экстренном режиме и не успел завершить все сессии

• Error: CALCULATIO rambo Last Alive: 1772, Session-ID: GiK72BJT5E

Система закрыла сессию в билинге так как не было RADIUS Alive (пакетов подтверждающих активность абонентов) пакетов более 5 интервалов

RECHANGE DEPOSIT: 66.000000 CREDIT: 0 SESSION_SUM: 0 SESSION_ID: 99412 STATE: 0 GUEST: 1 Hangup: 1 DURATION: 00:09:15

Система отключает абонента в связи с пополнением счета и перехода аккаунта с гостевого режима в рабочий

 CHANGE_TP 149 -> 80 DEPOSIT: 206.88 CREDIT: 0.00 SESSION_SUM: 0.000000 STATUS: 0 SESSION_ID: 814ff039 GUEST: 0 Hangup: 1

/usr/abills/libexec/billd dv_get_fee DEBUG=2 PAGE_ROWS=1000

В системе существует несколько типов снятия периодических снятий денег (абон. плата) они разделяются на месячные и дневные. Для дневной абон. платы используется скрипт

# /usr/abills/libexec/periodic daily

Для месячной

# /usr/abills/libexec/periodic monthly

дополнительные параметры передаваемые при запуске снятий. Данные программы стоит выполнять через cron с интервалом 1 час. Например дневная программа периодических действий в 00:00:00 месячная в 01:00:00. Месячную и дневную программу нужно запускать каждый день

Снятие абон. платы за определённое число

дневная

# /usr/abills/libexec/periodic daily DATE="2014-06-05"

месячнная

# /usr/abills/libexec/periodic monthly DATE="2014-06-05"

В систем предусмотрен шаблон формирования описания начислений, данный параметр задаётся в конфигурационном файле параметром

$conf{DV_FEES_DSC}='  ';

Параметры Шаблона

Шаблон по умолчанию

$conf{DV_FEES_DSC}='Internet: %FEES_PERIOD_MONTH%%FEES_PERIOD_DAY% %TP_NAME% (%TP_ID%) %PERIOD%';

Данная возможность разрешает к параметрам авторизации абонентам добавить еще один дополнительный параметр а именно порт коммутатора подключения.

Рассмотрим на примере сервера доступа mpd 5.5.

При авторизации сервер доступа передаёт на радиус параметр

ADSL-Agent-Circuit-Id = test_switch_1:GigabitEthernet0/0/1

В данном параметре передаются данные о коммутаторе доступа и порте подключения абонента. Если включена эта опция и заполнен порт у абонента система игнорирует мак авторизацию

Для использования данное параметра в качестве дополнительного параметра авторизации нужно прописать в конфигурационном файле параметр:

$conf{DV_PPPOE_PLUSE_PARAM}='ADSL-Agent-Circuit-Id';

В учётной записи абонента в поле Порт указываем дополнительные данные абонента

test_switch_1:GigabitEthernet0/0/1

Также если в конфигурации указана опция $conf{DV_PPPOE_PLUSE_PARAM} система автоматически заполняет параметр порт для абонентов с незаполненным полем. Чтобы не проверять параметр дополнительной авторизации в поле Порт нужно прописать параметр ANY