Интеграция с Mikrotik

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (42)

просмотр истории страницы
...
Далее выполняем следующие действия по шагам:

**Шаг 1. Инициализация.**
*Шаг 1. Инициализация.*

{{:проект_биллинг5:маркетинг:статьи_и_рассылки:screenshot_10.png?700|}}

**1.1** *1.1* <mark>rtsh cfg init mikrotik_simple v1</mark> - инициализировать каталог управления /var/oss/core/Mikrotik. Этим действием мы создаем структуру каталогов и файлов внутри каталога /var/oss/core/Mikrotik

Среди созданных файлов будут шаблоны, на основании которых будет генерироваться схема и ini файлы, в которых будет хранится информация, которую мы добавляли на основной вкладке оборудования. После шага 1.1 файлы создаются со значением по умолчанию.

**1.2** *1.2* <mark>rtsh cfg fill 192.168.248.1</mark> - заполнить ini файлы данными из биллинга. В этом шаге биллинг заменяет значение переменных из ini файлов значением из информации о NAS'e. Например, в файле main.ini идет замена nas_ip="192.168.0.10" (значение по умолчанию) на nas_ip="192.168.248.1"(значение, взятое из настроек NAS'а).

**1.3** *1.3* <mark>rtsh cfg save</mark> - сохранить сгенерированные файлы в историю. Этот шаг сохраняет те изменения, которые были сделаны на шаге 1.2.

\\
**Шаг 2. Сохранение текущей конфигурации.**
*Шаг 2. Сохранение текущей конфигурации.*

{{:проект_биллинг5:маркетинг:статьи_и_рассылки:mikrotik_billing:rtsh2_1.png?nolink&801x195}}

**2.1** *2.1* <mark>rtsh cfg download</mark> - загрузить конфигурационные файлы с оборудования в каталог /var/oss/core/Mikrotik/cur. Этот шаг своего рода бэкап со стороны биллинга Вашей текущей конфигурации.

**2.2** *2.2* <mark>rtsh cfg save</mark> - сохранить скаченную конфигурацию в историю.

\\
**Шаг 3. Подготовка конфигурации.**
*Шаг 3. Подготовка конфигурации.*

{{:проект_биллинг5:маркетинг:статьи_и_рассылки:mikrotik_billing:rtsh3_1.png?nolink&878x242}}

**3.1** *3.1* <mark>rtsh cfg make</mark> - сгенерировать файлы конфигурации из ini-файлов и шаблонов в каталог /var/oss/core/Mikrotik/upload. Этот шаг проводит генерацию конфигурации, которая будет загружена на оборудование. Генерация проходит на основании шаблонов, в которые добавляются переменные из ini файлов. Посмотреть шаблоны можно в /var/oss/core/Mikrotik/tmplt/ а ini файлы в /var/oss/core/Mikrotik/

**3.2** *3.2* <mark>rtsh cfg upload show</mark> - вывести все сгенерированные конфигурации. Этот шаг выведет весь конфигурационный файл на экран.

**3.3** *3.3* <mark>rtsh cfg save</mark> сохранить сгенерированные конфигурации в историю.

\\
**Шаг 4. Загрузка конфигурации.**
*Шаг 4. Загрузка конфигурации.*

{{:проект_биллинг5:маркетинг:статьи_и_рассылки:mikrotik_billing:rtsh4_1.png?nolink&706x136}}

**4.1** *4.1* <mark>rtsh cfg upload</mark> - загрузить сгенерированные конфигурационные файлы в оборудование. На этом шаге идет загрузка конфигурации на оборудование по тем реквизитам, которые указаны в NAS'e и ini файлах. Если загрузка идет через ssh - обязательно проведите предварительное подключение с биллинга до NAS по ssh, перейдя в chroot /app/asr_billing/. Для этого выполните следующие команды с биллинга:

<code> {code}
chroot /app/asr_billing/
ssh admin@192.168.248.1
</code> {code}

Это данные из примера. Этим действием Вы убедитесь, что между биллингом и Mikrotik'ом есть доступ и подтвердите прием ssh ключей.
...


===== Добавление абонента в биллинг =====
h1.Добавление абонента в биллинг

После того, как NAS добавлен в биллинг и конфигурация успешно загружена на Mikrotik, можно приступать к добавлению абонентов в биллинг.
...
Теперь, когда у нас есть тариф, можно переходить к созданию нового абонента. Для этого перейдем во вкладку "Управление абонентами и тарифами - Абонент" и используем кнопку "+Абонент". Откроется мастер создания абонента, состоящий из 3 шагов:

**Шаг 1. Заполняем основную информацию по абоненту.**
*Шаг 1. Заполняем основную информацию по абоненту.*

Ключевые параметры здесь "Название/ФИО", "Тариф" и "Номер договора". После заполнения информации нажимаем кнопку "Далее".
...
{{:проект_биллинг5:маркетинг:статьи_и_рассылки:mikrotik_billing:abonent2.png?nolink&782x749}}\\

**Шаг 2. Вводим реквизиты абонента.**
*Шаг 2. Вводим реквизиты абонента.*

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

**Шаг 3. Сетевые реквизиты абонента.**
*Шаг 3. Сетевые реквизиты абонента.*

Укажем тип авторизации "По ip static", назначим IPv4-адрес из подсети локального интерфейса Mikrotik'а нажав на кнопку рядом с полем (биллинг выберет свободный адрес автоматически), например 192.168.248.5 и выберем в качестве NAS'а Mikrotik. После нажатия кнопок "Далее" и "Готово", будет создан абонент.
...
{{:проект_биллинг5:маркетинг:статьи_и_рассылки:mikrotik_billing:abonent3.png?nolink&800x520}}

**В момент создания абонента на Mikrotik уйдут команды из функций:**

- user_add, абонент добавлен в биллинг. Эта команда добавит IP-адрес 192.168.248.5 в crb_auth_list.
...

Проверим это командой:
{code}
<code>
ip firewall address-list print where address=192.168.248.5
</code> {code}

Ответ:

<code> {code}
Flags: X - disabled, D - dynamic
# LIST ADDRESS CREATION-TIME
...
crb_auth_list 192.168.248.5 oct/04/2018 13:16:11
crb_negbal_list 192.168.248.5 oct/04/2018 13:16:11
</code> {code}

В crb_negbal_list абонент находится, так как при добавлении абонента у него нет на счёте достаточно средств для активации услуги, которая стоит 100 рублей. При этом у абонента будет соответствующий статус в биллинге.
...
Проверим, что абонент находится в правильных адрес листах. Выполним на Mikrotik'е команду:

<code> {code}
ip firewall address-list print where address=192.168.248.5
</code> {code}

В ответ получим следующее:
{code}
<code>
Flags: X - disabled, D - dynamic
# LIST ADDRESS CREATION-TIME
0 ;;; 192.168.248.5_crb_auth
crb_auth_list 192.168.248.5 oct/04/2018 13:18:16
</code> {code}

Как видно из вывода, абонент находится только в одном адрес листе crb_auth_list, соответственно имеет доступ в интернет. Проверить какой шейпер назначен абоненту можно командой:
<code> {code}
queue simple print where target=192.168.248.5/32
</code> {code}

В выводе получим данные по скоростям:

<code> {code}
Flags: X - disabled, I - invalid, D - dynamic
0 name="crb_192.168.248.5" target=192.168.248.5/32 parent=none packet-marks="" priority=8/8 queue=default-small/default-small limit-at=0/0 max-limit=1024k/1024k burst-limit=0/0 burst-threshold=0/0
burst-time=0s/0s bucket-size=0.1/0.1
</code> {code}

Данные совпадают с информацией, которая указана в тарифе, а именно max-limit=1024k/1024k При авторизации по PPPoE изменится только этап авторизации, на котором нужно ввести логин/пароль. Остальная логика останется прежней.
...