{toc}
h1. Как интегрировать NAS/BRAS сервер
Подсистема OSS позволяет авторизовать абонента и управлять состоянием сессии: изменять скорость доступа, добавлять или снимать блокировки и тд.
# Определись с [типом авторизации|CarbonBilling:Типы авторизации] абонента и выберите оборудование.
# Выберите подходящую схему интеграции среди [стандартных|CarbonBilling:Стандартные схемы] - это существенно ускорит процесс, биллинг сам настроить NAS по шаблону.
{info}Стандартные схемы можно кастомизировать ([пример|CarbonBilling:Пример. Burst для Mikrotik-Simple и Mikrotik-Simple-Hotspot]), это всё равно будет быстрее чем делать полностью новую схему{info}
# Интегрируйте [по документации|CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]
Если Вы не нашли подходящую стандартную схему, сделайте [пользовательскую|CarbonBilling:Пользовательская схема].
h1. Какие схемы интеграции есть в биллинге
h2. Стандартные
В биллинге уже есть ряд схем интеграции с оборудованием известных вендоров:
{pagetree:root=Стандартные схемы}
h2. Пользовательские
Если подходящей Вам схемы нет, можете создать [пользовательскую схему|CarbonBilling:Пользовательская схема].
Мы подготовили несколько примеров:
{pagetree:root=Пользовательская схема}
h1. Как устроены OSS схемы
h2. Актуальный тип: OSS схема
Содержит шаблон настройки NAS и скрипты управления. После заполнения карточки NAS, из шаблонов формируются готовые конфигурационные файлы по которым настраивается оборудование для взаимодействия с биллингом.
# Вкладка "Описание"
#- *Cтандартная OSS схема*: одна из стандартных, либо "Пользовательская"
#- *OSS Каталог управления*: при создании NAS мастером, будет создан автоматический, при создании NAS через кнопку "Добавить" - укажите нужную папку, предварительно создав её на сервере.
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* оставьте пустым
#- *Тип*: "OSS схема"
Интеграция с использованием OSS схемы поэтапно описана в данном разделе:
* [CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]
* [CarbonBilling:Этап 2. Генерация конфигурации и upload на оборудование]
* [CarbonBilling:Этап 3. Тестирование стандартной схемы]
* [CarbonBilling:Этап 4, 5. Тюнинг Стандартной схемы под требования провайдера или разработка custom схемы]
* [CarbonBilling:Этап 6,7,8,9]
h2. Устаревший тип: базовый скрипт управления
Представляет из себя просто скрипт управления - набор команд отправляемый на оборудования для изменения состояний сессий абонентов. Настройка оборудования биллингом не выполняется, только управление сессиями.
При выборе такой схемы интеграции, в настройках NAS укажите следующее:
# Вкладка "Описание"
#- *Cтандартная OSS схема*: "----"
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* имя нужного файла из папки */app/asr_billing/var/lib/event/*
#- *Тип*: "Другой"
h1. Управление сессиями абонентов на оборудовании
Управление доступом абонентов к сервису осуществляется через отправку [команд|CarbonBilling:Состояния пользователей, услуг и команды управления интернет] по одному или нескольким из перечисленных протоколов: *CoA*, *ssh*, *http*, *telnet*, *snmp*.
Сами команды описываются в функциях shell-скрипта, вызываемых при наступлении тех или иных событий с абонентом в биллинге, например: переход в отрицательный или положительный баланс, изменение скорости по тарифу, добровольная блокировка и тд.
Так, при авторизации по протоколу RADIUS могут вызываться некоторые дополнительные команды, соответствующие событиям протокола: *Accounting Stop*, *Accounting Start*.
Расположение скрипта управления в системе зависит от выбранного типа NAS:
* OSS схема: */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color} или */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#ff6600}{*}u{*}{color}{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color}, если в конкретном NAS Вы модифицировали схему
* Базовый скрипт событий: */var/lib/event/*{color:#ff0000}{*}script.sh{*}{color}
h1. Как интегрировать NAS/BRAS сервер
Подсистема OSS позволяет авторизовать абонента и управлять состоянием сессии: изменять скорость доступа, добавлять или снимать блокировки и тд.
# Определись с [типом авторизации|CarbonBilling:Типы авторизации] абонента и выберите оборудование.
# Выберите подходящую схему интеграции среди [стандартных|CarbonBilling:Стандартные схемы] - это существенно ускорит процесс, биллинг сам настроить NAS по шаблону.
{info}Стандартные схемы можно кастомизировать ([пример|CarbonBilling:Пример. Burst для Mikrotik-Simple и Mikrotik-Simple-Hotspot]), это всё равно будет быстрее чем делать полностью новую схему{info}
# Интегрируйте [по документации|CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]
Если Вы не нашли подходящую стандартную схему, сделайте [пользовательскую|CarbonBilling:Пользовательская схема].
h1. Какие схемы интеграции есть в биллинге
h2. Стандартные
В биллинге уже есть ряд схем интеграции с оборудованием известных вендоров:
{pagetree:root=Стандартные схемы}
h2. Пользовательские
Если подходящей Вам схемы нет, можете создать [пользовательскую схему|CarbonBilling:Пользовательская схема].
Мы подготовили несколько примеров:
{pagetree:root=Пользовательская схема}
h1. Как устроены OSS схемы
h2. Актуальный тип: OSS схема
Содержит шаблон настройки NAS и скрипты управления. После заполнения карточки NAS, из шаблонов формируются готовые конфигурационные файлы по которым настраивается оборудование для взаимодействия с биллингом.
# Вкладка "Описание"
#- *Cтандартная OSS схема*: одна из стандартных, либо "Пользовательская"
#- *OSS Каталог управления*: при создании NAS мастером, будет создан автоматический, при создании NAS через кнопку "Добавить" - укажите нужную папку, предварительно создав её на сервере.
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* оставьте пустым
#- *Тип*: "OSS схема"
Интеграция с использованием OSS схемы поэтапно описана в данном разделе:
* [CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]
* [CarbonBilling:Этап 2. Генерация конфигурации и upload на оборудование]
* [CarbonBilling:Этап 3. Тестирование стандартной схемы]
* [CarbonBilling:Этап 4, 5. Тюнинг Стандартной схемы под требования провайдера или разработка custom схемы]
* [CarbonBilling:Этап 6,7,8,9]
h2. Устаревший тип: базовый скрипт управления
Представляет из себя просто скрипт управления - набор команд отправляемый на оборудования для изменения состояний сессий абонентов. Настройка оборудования биллингом не выполняется, только управление сессиями.
При выборе такой схемы интеграции, в настройках NAS укажите следующее:
# Вкладка "Описание"
#- *Cтандартная OSS схема*: "----"
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* имя нужного файла из папки */app/asr_billing/var/lib/event/*
#- *Тип*: "Другой"
h1. Управление сессиями абонентов на оборудовании
Управление доступом абонентов к сервису осуществляется через отправку [команд|CarbonBilling:Состояния пользователей, услуг и команды управления интернет] по одному или нескольким из перечисленных протоколов: *CoA*, *ssh*, *http*, *telnet*, *snmp*.
Сами команды описываются в функциях shell-скрипта, вызываемых при наступлении тех или иных событий с абонентом в биллинге, например: переход в отрицательный или положительный баланс, изменение скорости по тарифу, добровольная блокировка и тд.
Так, при авторизации по протоколу RADIUS могут вызываться некоторые дополнительные команды, соответствующие событиям протокола: *Accounting Stop*, *Accounting Start*.
Расположение скрипта управления в системе зависит от выбранного типа NAS:
* OSS схема: */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color} или */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#ff6600}{*}u{*}{color}{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color}, если в конкретном NAS Вы модифицировали схему
* Базовый скрипт событий: */var/lib/event/*{color:#ff0000}{*}script.sh{*}{color}