abills/libexec/config.pl

Файл настроек существует для создания конфигурации системы. Он заполняется в формате синтаксиса Perl. Если переменной нет в файле настроек или она отключена (значение 0) система использует значение по умолчанию. Существует другой механизм конфигурации (через таблицу config, для управления через веб-интерфейс), значения указанные там имеют приоритет выше, но не всегда используются в дополнительных скриптах.

Переменные включения функций
Для включения нужно указать 1 (один) для выключения 0 (ноль) или комментировать переменную.

Автоматическое создание группы должников. В группу заносятся пользователи у которых депозит ниже указанного в конфигурации и последняя оплата старше определённого количества дней. При включении пользователя в эту группу система автоматически добавляет комментарии с указанием даты добавлении. Если указанная группа не существует система пытается её создать. При погашении долга пользователя автоматически удаляется из группы вместе с комментарием. Можно вносить несколько правил переноса разделяя их запятой.
GROUP_ID - Група в которую переносить должников
DEPOSIT - Депозит при достижении которого клиент попадает в групу должников
LAST_PAYNMENT_DAYS - Количество дней прошедших с дня последней оплаты
USER_GID - Поточная группа пользователя (Не обязательный параметр). Если указан система переносит только пользователей указанной группы.
LAST_FEES_DAYS - Вносить в группу пользователей с которых на протяжении LAST_FEES_DAYS дней не снималась абон. плата. При обявлении этой опции игнорируется опция LAST_PAYNMENT_DAYS


Пример:

$conf{DEBETORS_GROUP}='500:0:20'; # перенести всех должников оплативших 20 дней назад в группу 500)

$conf{DEBETORS_GROUP}='100:0:20:10,500:0:20'; # перенести всех должников из группы 10 в группу 100 и перенести всех должников без группы в группу 500

Система является модульным решением что разрешает в зависимости от потребностей использовать сочетание тех или иных модулей. Список модулей задаётся в переменной @MODULES

@MODULES = (‘Dv’, ‘Mail’);

Показывает что к системе подключены следующие модули Dv (Модуль управления Dialup/VPN соединениями) и Mail (Модуль управления почтой).

Настройки авторизации

Настройки административного интерфейса

Некоторые модули имеют возможность авторегистрации. Авторегистрация подразумевает что пользователь может самостоятельно зарегистрироваться в системе. Для включения возможности авторегистрации нужно прописать в переменную @REGISTRATION название модулей. Если включить несколько модулей для регистрации пользователю будет предоставлен выбор для регистрации.

 @REGISTRATION = ('Dv');

Также можно указать несколько модулей для регистрации:

 @REGISTRATION = ('Dv', 'Msgs');

при регистрации пользователь увидит первый модуль регистрации и кнопки перехода для регистрации в других модулях

Страница регистрации: https://your.host:9443/registration.cgi

Для явного указания отображаемого модуля в строке запроса нужно добавить параметр module=название_модуля

https://your.host:9443/registration.cgi?modules=Dv

Для защиты от роботов авторегистрации можно включить отображения цифр (CAPTCHA) параметр конфигурационного файла:

 $conf{REGISTRATION_CAPTCHA}=1;

Чтобы использовать эту функцию Вам также нужно установить Perl Authen::Captcha либо воспользоваться сервисом Google reCAPTCHA

Чтобы нужный тариф был в авторегистрации нужно его добавить в группу ТП и GID этой группы вписать в следующий параметр

Дополнительные параметры:

На странице регистрации есть кнопка проверки адресов. При нажатии на нее, выскакивает модальное окно в котором абонент может выбрать свой адрес и проверить подключен ли его дом к вашей сети или только планируется к подключению.

Страница восстановления пароля по E-mail или логину: https://your.host:9443/registration.cgi?FORGOT_PASSWD=1

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

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

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

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

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

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

Система может обрабатывать следующие события:

Возможность авторизовать администраторов с LDAP сервера

Параметры

dn: cn=abills_admin,ou=users,dc=your.domain
objectClass: top
objectClass: person
#mail: pupkin@mail.com
#homePhone: 3322334455
telephoneNumber: 38050774433
cn: abills_admin2
sn: Vasya Pupkin
userPassword: {SSHA}wEFKat3VPBps4cAfcFsjZL4j7GOOA3N8