Это старая версия документа.


Установка ABillS на Debian

Версия для которой писалась документация

Debian 8.6.0 \\

При установке, параметры:

  • SSH Server
  • Standart system utilities

Переходим в режим root. (Используя пароль, который вводили при установке)

# su

Скачиваем ABillS: На момент написания статьи актуальная версия 0.75.110 (Сходите сюда и проверьте).

# cd /usr
# wget https://sourceforge.net/projects/abills/files/abills/0.75/abills-0.75.110.tgz
# tar zxvf abills-0.75.110.tgz
# cp /usr/abills/libexec/config.pl.default /usr/abills/libexec/config.pl

Изменяем конфигурационный файл /usr/abills/libexec/config.pl

#DB configuration 
$conf{dbhost}='localhost';
$conf{dbname}='abills'; 
$conf{dbuser}='abills';
$conf{dbpasswd}='sqlpassword'; 
$conf{ADMIN_MAIL}='info@your.domain'; 
$conf{USERS_MAIL_DOMAIN}="your.domain";
# используется для шифрования паролей администраторов и пользователей.
$conf{secretkey}="test12345678901234567890"; \\

При изменении значения в $conf{secretkey} поменяйте его также в файле /usr/abills/db/abills.sql

Настройка сопутствующего ПО

MySQL

Debian 8.xx

# apt-get install mariadb-server libmysqlclient-dev

Создаём пользователя и базу.

# mysql --default-character-set=utf8 -u root -p

В консоли mysql делаем :

  use mysql;
  GRANT ALL ON abills.* TO `abills`@localhost IDENTIFIED BY "sqlpassword";  
  CREATE DATABASE abills DEFAULT CHARACTER SET utf8 COLLATE  utf8_general_ci;
  flush privileges;
  quit;

Загружаем таблицы в базу.

# cd /usr/abills/db/
# mysql --default-character-set=utf8 -D abills < abills.sql -p

Web Server

Apache

Установка Apache

# apt-get install apache2

Создаём сертификаты.

# /usr/abills/misc/certs_create.sh apache

Копируем готовый конфиг Apache в папку внешних конфигураций apache
Apache 2.2

# cp /usr/abills/misc/apache/abills_httpd.conf /etc/apache2/Includes/

Apache 2.4

# cp /usr/abills/misc/apache/abills_httpd.conf /etc/apache2/sites-enabled/

Включаем модули для апача:

a2enmod ssl
a2enmod rewrite
a2enmod suexec
a2enmod include
a2enmod cgid

Создаем файл лога ошибок Abills

# mkdir /var/log/httpd
# touch /var/log/httpd/abills-error.log
# service apache2 restart

Perl modules

Для работы системы нужны модули.

DBI # apt-get install libdbi-perl
DBD-mysql # apt-get install libdbd-mysql-perl
Digest-MD5 для Chap авторизации
# apt-get install libdigest-md5-file-perl
Digest-SHA1 для MS-ChapV2 авторизации
# apt-get install libdigest-sha-perl
libnet Нужен только при авторизации из UNIX passwd
# apt-get install libnet1
Time-HiRes Нужен только для тестирования скорости выполнения авторизации, аккаунтинга, и страниц веб-интерфейса

Radius

Инсталяция:

  # apt-get install libperl-dev  gcc make
  # wget ftp://ftp.freeradius.org/pub/freeradius/freeradius-server-2.2.9.tar.gz
  # tar zxvf freeradius-server-2.2.9.tar.gz
  # cd freeradius-server-2.2.9
  # ./configure --prefix=/usr/local/freeradius --with-rlm-perl-lib-dir=/usr/lib/ --with-openssl=no
  # make
  # make install

Настройка

  cp /usr/abills/misc/freeradius/v2/radiusd.conf /usr/local/freeradius/etc/raddb/radiusd.conf
  rm /usr/local/freeradius/etc/raddb/sites-enabled/*
  cp /usr/abills/misc/freeradius/v2/users_perl /usr/local/freeradius/etc/raddb/users
  cp /usr/abills/misc/freeradius/v2/default_rlm_perl /usr/local/freeradius/etc/raddb/sites-enabled/abills_default
  cp /usr/abills/misc/freeradius/v2/perl /usr/local/freeradius/etc/raddb/modules/
  
  ln -s /usr/local/freeradius/sbin/radiusd /usr/sbin/radiusd

Файл для автозапуска ,- создаем и вставляем в него следующий текст

nano /etc/init.d/freeradius
#!/bin/sh
# Start/stop the FreeRADIUS daemon.

### BEGIN INIT INFO
# Provides:          freeradius
# Required-Start:    $remote_fs $network $syslog
# Should-Start:      $time mysql slapd postgresql samba krb5-kdc
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Radius Daemon
# Description:       Extensible, configurable radius daemon
### END INIT INFO

set -e

. /lib/lsb/init-functions

PROG="freeradius"
PROGRAM="/usr/sbin/radiusd"
PIDFILE="/var/run/radiusd/radiusd.pid"
DESCR="FreeRADIUS daemon"

test -f $PROGRAM || exit 0

# /var/run may be a tmpfs
if [ ! -d /var/run/radiusd ]; then
 mkdir -p /var/run/radiusd
 chown freerad:freerad /var/run/radiusd
fi

export PATH="${PATH:+$PATH:}/usr/sbin:/sbin"

ret=0

case "$1" in
        start)
                log_daemon_msg "Starting $DESCR" "$PROG"
                start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $PROGRAM || ret=$?
                log_end_msg $ret
                exit $ret
                ;;
        stop)
                log_daemon_msg "Stopping $DESCR" "$PROG"
                if [ -f "$PIDFILE" ] ; then
                  start-stop-daemon --stop --retry=TERM/30/KILL/5 --quiet --pidfile $PIDFILE || ret=$?
                  log_end_msg $ret
                else
                  log_action_cont_msg "$PIDFILE not found"
                  log_end_msg 0
                fi
                ;;
        restart|force-reload)
                $0 stop
                $0 start
                ;;
        *)
                echo "Usage: $0 start|stop|restart|force-reload"
                exit 1
                ;;
esac

exit 0
chmod +x /etc/init.d/freeradius

update-rc.d freeradius defaults

Меняем в конфиге радиуса:

#nano /usr/local/freeradius/etc/raddb/radiusd.conf

  prefix = /usr/local/freeradius
  
  user = freerad
  group = freerad

В файле /usr/local/freeradius/etc/raddb/clients.conf удалить всё и вписать:

client 127.0.0.1 {
 secret = secretpass
 shortname = shorrname
}

Создание user и group если freeradius ранее не был установлен то без этого не стартует

# groupadd freerad
# useradd -g freerad -s /bash/bash freerad
# chown -R freerad:freerad /usr/local/freeradius/etc/raddb

Запуск radius в режиме отладки

  #  /usr/local/freeradius/sbin/radiusd -X

или

  # service radiusd -X

На всякий случай оставлю здесь: Кажется настроил, но никто не может подключиться

ABillS - Настройка

Вносим в /etc/crontab периодические процессы
billd - контролер активных сессий
periodic - дневные и месячные периодические процессы

*/5  *      *    *     *   root   /usr/abills/libexec/billd -all
 1     0     *    *     *   root    /usr/abills/libexec/periodic daily
 1     1     *    *     *   root    /usr/abills/libexec/periodic monthly

Установить права на чтение и запись веб-сервером для файлов веб интерфейса

# mkdir /usr/abills/var/ /usr/abills/var/log /usr/abills/backup
# touch /usr/abills/var/log/abills.log
# chown -Rf www-data /usr/abills/cgi-bin
# chown -Rf www-data /usr/abills/Abills/templates
# chown -Rf www-data /usr/abills/backup

Добавляем линки на gzip и mysqldump для создания бэкапов базы:

# ln -s /bin/gzip /usr/bin/gzip
# ln -s /usr/bin/mysqldump /usr/local/bin/mysqldump

Веб интерфейс администратора:
https://your.host:9443/admin/

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

Проверка
Для проверки правильно ли настроен сервис нужно запустить утилиту radtest указав логин и пароль существующего пользователя.
После установки, в системе существует пользователь как раз на такой случай.
Логин: test Пароль: 123456

# /usr/local/freeradius/bin/radtest test 123456 127.0.0.1:1812 0 secretpass 0 127.0.0.1

Если всё правильно настроено, в журнале ошибок /Отчёт/Internet/Ошибка/ должна появиться строка

 2005-02-23 12:55:55 LOG_INFO: AUTH [test] NAS: 1 (xxx.xxx.xxx.xxx) GT: 0.03799

Если Вы увидите другие ошибки смотрите в список ошибок. Если журнал ошибок пуст значит неправильно настроено взаимодействие с RADIUS сервером, смотрите FAQ.

Дополнительно

Открытие фаервола для RADIUS пакетов

iptables -A ufw-user-input -p udp --dport 1812 -j ACCEPT
iptables -A ufw-user-input -p udp --dport 1813 -j ACCEPT