|
Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.
|
Изменения (13)
просмотр истории страницы{toc:maxLevel=3} |
h2. Как работает интеграция |
... |
# Получите заявку от абонента на видеонаблюдение #* Добавьте ему учётную запись Flussonic в биллинге |
#* Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента |
#* Назначьте инженера # Отправьте инженера на подключение |
... |
#* Добавьте камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294]) #* Или [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera] |
#* При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}. |
# В течение 5 минут биллинг заберёт параметры новых камер из Watcher, и подключит пользователю услуги в системе # Если абонент захочет сменить тариф видеонаблюдения, он сделает это в [личном кабинете оператора связи|CarbonBilling:Локальный сайт. Личный кабинет.], вместе с прочими услугами. |
... |
Этот параметр определяется отдельно. Его нельзя задавать в пресете. В Watcher предустановлено 16 возможных вариантов этого параметра |
В настройках услуг в биллинге, лимит DVR в днях определяются парамтером параметром *dvr_lock_days*, например: |
{code}dvr_lock_days=7{code} |
Опция камеры "Получать события" должна быть включена, чтобы работало сохранения записи по движению, поэтому если задать параметры лимита DVR, то опция "Получать события" будет включена автоматический. |
h4. PTZ |
... |
PTZ определяет возможность удалённого управлять камерой. Вы можете включить взимать за это дополнительную плату, но можете и предоставлять эту опцию бесплатно. |
В настройках услуг в биллинге, PTZ определяются парамтером параметром *onvif_ptz*, нужно создать только услугу для включения PTZ: |
{code}onvif_ptz=True{code} |
Если PTZ на камере выключено, биллинг считает это параметром "по-умолчанию", создавать для этого отдельной услуги не нужно. Требуется создать отдельную услугу для включения опции с параметром *motion_detector_enabled*. {code}motion_detector_enabled=True{code} Если на камере включено dvr_lock_days, но выключено motion_detector_enabled, то биллинг подключает услугу motion_detector_enabled и включает motion_detector_enabled на камере. Для опций onvif_ptz и motion_detector_enabled есть значение по умолчанию, если соответствующих услуг у абонента нет, то на камере для опции будет выставлено False. h4. Опция "Получать событие" Опция "Получать событие" позволяет сохранять в ЛК Flussonic в разделе "События" фрагменты записи, полученные при срабаотывании датчика движения в камере. |
h4. Состояние (включена/выключена) |
... |
{code}https://169.254.14.43:2443/auth_flussonic.php{code} 169.254.14.43 замените на IP биллинга |
# В области "Уведомления о событиях" в поле "Внешний URL уведомлений о событиях" укажите путь до обработчика integration_flussonic_v2.php, на него мы получаем информацию о появившихся в сети камерах, например: |
{code}https://169.254.14.43:2443/integration_flussonic_v2.php{code} |
169.254.14.43 так же замените на IP биллинга |
Поле "Внешний URL фильтра событий" оставить незаполненным. |
!Watcher Системные настройки.png|border=0,width=600! |
... |
IP-адрес укажите любой - его заполнить обязательно только чтобы создался NAS. |
Каталог OSS заполнится автоматический. |
!Watcher NAS описание.png|border=0,width=350! |
... |
h3. Настройте услуги |
{warning}В биллинге может быть только одна услуга с уникальным значением в поле *"Строка с дополнительными параметрами по активации"*. Например: preset_id=1; dvr_lock_days=1; onvif_ptz=True Если в биллинге будет две услуги с одинаковым значением в поле *"Строка с дополнительными параметрами по активации"*, услуга не будет подключаться абонентам.{warning} {info:title=Что нельзя настраивать с услугами Flussonic} # *Делать их включёнными в тариф*: интеграция оперирует только услугами, и не сможет удалить услугу включенную в тариф, если, абонент захочет поменять условия обслуживания по видеонаблюдению Если у абонента видеонаблюдение основной или единственный сервис - создайте тариф "заглушку", с единственной услугутой типо "Стандартная" без стоимости. На вкладке "Дополнительно" включите опцию "Не отображать абоненту". # Включать опцию *Для услуги необходима привязка к учетной записи*: эта опция была сделана для других интеграций (например, выдача белого IPv4) и в услугах Flussonic будет вызывать ошибку. # *Строка с дополнительными параметрами по {color:green}активации{color}* и *Строка с дополнительными параметрами по {color:red}деактивации{color}* должны быть уникальны среди услуг! То есть, нельзя сделать две услуги с "preset_id=2", "dvr_lock_days=None" и так далее. {info} |
|| Вкладка "Основные" || Вкладка "Дополнительно" || Вкладка "Личный кабинет" || |
... |
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]|| |Flussonic: PTZ|50|onvif_ptz=True|onvif_ptz=True|Стандартный|Ежемесячно|Предоплата| |
h2. Подключение Watcher абоненту h3. Добавьте учётную запись, привязанную к NAS со схемой Flussonic !Watcher Учетная запись абонента.png|border=0,width=500! Добавьте [учётную запись|CarbonBilling:Учетная запись. Создание и изменение.], привязанную к NAS со схемой Flussonic версии 2. Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента Остальные поля не важны, в том числе тип авторизации. "Внешний ИД" заполнится автоматически после создания пользователя на Flussonic. h3. Отправьте инженера подключить абоненту камеру Установите камеру и авторизуйтесь в Watcher с учётной записью ранее созданной для абонента. Добавьте абоненту камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294]). При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}. Камеру можно настроить в [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera], например если в ней нет агента Watcher, но к ней есть прямой доступ по белому IP-адресу. h3. Биллинг синхронизирует выбранные настройки Биллинг автоматически подключит абоненту услуги по каждой добавленной камере !Watcheh Абонент, вкладка услуги.png|border=0,width=900! Каждая подключенная услуга привязывается к камере из справочника оборудорвания (тоже синхронизируются биллингом автоматически) !Watcheh Абонент, подключенная услуга.png|border=0,width=700! h3. Камеры абонента появятся в справочнике "Оборудование" URL потока вещания - это прямая ссылка на видеопоток с камеры, её можно открыть в браузере. !Watcheh Абонент, параметры камеры.png|border=0,width=600! h2. Отладка h3. Журнал синхронизации Лог синхронизации всегда по одному пути {code}tail -f /app/asr_billing/var/log/nas_event_daemon/flussonic.log{code} Лог отправленных команд по учетным записям абонентов тоже в папке nas_event_daemon, название состоит из наименования NAS и его IP, например: {code}tail -f /app/asr_billing/var/log/nas_event_daemon/Flussonic_v2_1.1.1.8.log{code} h3. Команды диагностики учётной записи Схемой предусмотрена [диагностика учётной записи|CarbonBilling:Команды диагностики пользователей] - эта информация будет полезна инженерам и разработчикам при обращении абонента в техподдержку. || Информация для оператора биллинга || Сырые данные для разработчика || | !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+main.png?version=1&modificationDate=1612859364028|border=0,width=250! | !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+dev.png?version=1&modificationDate=1612859498469|border=0,width=200! | h3. Отчёт со списком всех абонентов В статье [CarbonBilling:Примеры технических отчётов] мы подготовили несколько отчётов, которые могут быть полезны администраторам: * [Количество абонентов с услугами привязанными к NAS-серверам|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] покажет количество абонентов по NAS - то есть, с подключенным видеонаблюдением. * [Flussonic Watcher v2, учтётные записи, камеры и услуги по камерам для схемы интеграции SUP-675790|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-FlussonicWatcherv2%2Cучтётныезаписи%2CкамерыиуслугипокамерамдлясхемыинтеграцииSUP675790] покажет важные параметры для техподдержки по всем абонентам с учетными записями и камерами Flussonic !Watcheh Абонент, в отчёте.png|border=0,width=700! * [Flussonic Watcher v2, услуги сервиса, которые можно подключить абонентам, с контролем ошибок SUP-772439|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-FlussonicWatcherv2%2Cуслугисервиса%2Cкоторыеможноподключитьабонентам%2CсконтролемошибокSUP772439] отразит основные параметры услуг Flussonic и укажет на возможные ошибки настройки h3. Не проходит авторизация на auth_flussonic.php, как проверить? # В первую очередь Flussonic пытается авторизовать абонента по своей внутренней базе, если это не удалось - он обращается к внешнему бекенду, то есть к биллингу. {info}Проблема может возникнуть, если бекенд авторизации не настроен. Выше в статье описано, как его настроить.{info} # Если бекенд настроен и он точно ссылается на биллинг, проверьте , что запросы доходят до биллинга. Запустите снифер трафика по портам авторизации: {code}tcpdump -nni any port 1444 or port 1443 or port 2443{code} {note}На эти же порты обращаются платёжные системы и внутренний трафик биллинга из подсети 169.254.0.0/16. В выводе ищите обращения именно от Флюссоника: с его IP-адресов{note} # Трафик должен идти в обе стороны. #* Например, это значит что связь есть: {panel} 11:06:41.214954 IP {color:purple}*10.90.1.185*{color}.46672 > {color:red}*10.90.185.127*{color}.1444: Flags \[S\], seq 1054804449, win 64240, options \[mss 1460,sackOK,TS val 4209885119 ecr 0,nop,wscale 7\], length 0 11:06:41.214960 IP {color:purple}*10.90.1.185*{color}.46672 > {color:red}*10.90.185.127*{color}.1444: Flags \[S\], seq 1054804449, win 64240, options \[mss 1460,sackOK,TS val 4209885119 ecr 0,nop,wscale 7\], length 0 11:06:41.214992 IP {color:red}*10.90.185.127*{color}.1444 > {color:purple}*10.90.1.185*{color}.46672: Flags \[S.\], seq 2675606213, ack 1054804450, win 14480, options \[mss 1460,sackOK,TS val 569656279 ecr 4209885119,nop,wscale 7\], length 0 11:06:41.214994 IP {color:red}*10.90.185.127*{color}.1444 > {color:purple}*10.90.1.185*{color}.46672: Flags \[S.\], seq 2675606213, ack 1054804450, win 14480, options \[mss 1460,sackOK,TS val 569656279 ecr 4209885119,nop,wscale 7\], length 0 {panel} #* А это - то что связи нет. Flussonic с IP 10.90.1.185 отправляет запросы биллингу на IP 10.90.185.127, но биллинг не отвечает. Добавьте IP Flussonic в [список разрешенных|CarbonBilling:Настройка сети для платежных систем]. {panel} 11:02:08.871798 IP {color:purple}*10.90.1.185*{color}.46306 > {color:red}*10.90.185.127*{color}.1444: Flags \[S\], seq 2241838185, win 64240, options \[mss 1460,sackOK,TS val 4209612782 ecr 0,nop,wscale 7\], length 0 11:02:09.877933 IP {color:purple}*10.90.1.185*{color}.46306 > {color:red}*10.90.185.127*{color}.1444: Flags \[S\], seq 2241838185, win 64240, options \[mss 1460,sackOK,TS val 4209613787 ecr 0,nop,wscale 7\], length 0 {panel} # Когда убедились, что запросы точно идут к биллингу и проходят фаервол, проверьте есть ли они в логе веб-сервера: {code}tail -f /app/asr_fiscal/var/log/httpd/access_log{code} Должно быть что-то вроде этого: {panel} 10.90.1.185 - - \[30/Jul/2021:11:18:21 +0500\] "HEAD /auth_flussonic.php?login=BILL0000015&password=w08tr6 HTTP/1.1" *200* - "-" "curl/7.74.0" 10.90.1.185 - - \[30/Jul/2021:11:18:24 +0500\] "HEAD /auth_flussonic.php?login=121414&password=664731 HTTP/1.1" *403* - "-" "curl/7.74.0" {panel} Первая строка говорит об успешной авторизации, это видно по коду ответа HTTP 200. Вторая строка говорит об ошибке авторизации, это можно понять по коду ответа HTTP 403: скорей всего логин или пароль неверные, или учётная запись в биллинге заблокирована. И то же самое - в логе бекенда авторизации: {code}tail -f /app/asr_fiscal/var/log/integrations/AuthFlussonic.log{code} {code}2021-07-30 11:18:21 Auth attempt, Login: BILL0000015 - SUCCESS 2021-07-30 11:18:24 Auth attempt, Login: 121414 - FAILED{code} # Если записи в логе есть, авторизация не проходит, но Вы точно уверены что логин и пароль [учётной записи|CarbonBilling:Учетная запись. Создание и изменение.] правильные, попробуйте окончательно в этом убедиться, выполнив запросы с CURL: #* Подключитесь к Flussonic по SSH и выполните такой запрос: {note}Поменяйте в запросе IP Вашего биллинга, логин и пароль - от тестируемой учётной записи{note} {code}curl -k -I 'http://10.90.185.127:1444/auth_flussonic.php?login=121414&password=664731'{code} Вывод будет примерно таким: {code}HTTP/1.1 403 Forbidden Date: Thu, 01 Jul 2021 08:16:26 GMT Server: Apache/2.2.15 (CentOS) X-Powered-By: PHP/7.3.21 Vary: Accept-Encoding,User-Agent Cache-Control: max-age=60, private, must-revalidate Content-Type: text/html; charset=UTF-8{code} Потом подключитесь к биллингу по SSH и выполните API запрос авторизации: {note}Поменяйте в запросе логин и пароль - укажите от тестируемой учётной записи{note} {code}curl -d 'method1=objects.filter&arg1={"login":"121414","gen_pwd":"664731"}&fields=["pk","login"]' http://169.254.80.82:8082/rest_api/v2/Users/ -D -{code} Вывод будет примерно таким: {code}HTTP/1.1 200 OK Server: nginx/1.0.15 Date: Thu, 01 Jul 2021 08:14:44 GMT Content-Type: application/json Transfer-Encoding: chunked Connection: keep-alive Vary: Cookie {"call": "/rest_api/v2/Users/", "result": [{"pk": 1424, "model": "Users", "fields": {"pk": 1424, "login": "121414"}}]}{code} #* {info}Вывод с консоли, вместе с запросами, скопируйте в файл передайте нам через запрос на портале [HelpDesk|https://helpdesk.carbonsoft.ru/login.php].{info} h2. FAQ h3. Что будет если абонент поменяет параметры камеры прямо на Watcher? В течение пяти минут пройдёт синхронизация и параметры камеры вернутся к тем, что указаны в биллинге. Например, если абонент заблокирован по балансу, но зайдёт в Watcher и включит камеру - биллинг её выключит. Если изменит пресет - то вернётся тот пресет, что настроен услугами в биллинге. h3. Что будет, если удалить камеру на Watcher? Синхронизатор автоматически отключит в биллинге услуги по этой камере в течение 5 минут - этим управляет синхронизация. h3. Если удалить камеру на Watcher, и добавить вновь, что будет в справочнике оборудования? Старая камера останется, добавится новая. Услуги абонента будут только по новой камере. Это связано с тем, что биллинг не имеет представления о камере как физическом объекте, потому что Watcher не всегда отражает серийный номер камеры. Поэтому в качестве "серийного номера" в биллинге мы записываем наименование камеры, указанное в Watcher - оно всегда уникально для новой камеры, и изменится если её удалить и снова добавить тому же или другому абоненту. h3. Как заново синхронизировать камеру? Вы можете вручную удалить услуги по этой камере в течение 5 минут между синхронизациями и поменять параметры камеры на Watcher. Тогда биллинг подгрузит услуги по параметрам камеры, указанным в Watcher - для него это будет новая камера. h3. Если это сделает абонент заблокированный по балансу? Новые услуги подключатся, но сразу будут заблокированы и камера всё равно выключится. h3. Как заменить тариф камеры в администраторской панели? По статье [CarbonBilling:Изменение условий обслуживания]. Привязку оборудования биллинг сохранит в новой услуге. h3. Если удалить учётную запись в биллинге, что будет с ней на Вотчере? Организация и учётная запись останутся на Watcher, Вы можете удалить их вручную. h3. Не работает синхронизация в биллинге с Flussonic? В случае, если все настройки указаны корректно, при выполнении диагностики в биллинге удается получить информацию о настройках камер из flussonic, а синхронизация корректно не отрабатывает, требуется выполнить перезапуск службы oss и повторно проверить состояние службы в логах. Перезапуск службы oss {code}chroot /app/asr_billing/ service oss restart{code} {code:title=Фрагмент лога /app/asr_billing/var/log/nas_event_daemon/flussonic.log при работе синхронизации} 2021-06-15 19:31:29,770 - worker - flussonic_sync - DEBUG - compare_cameras_in_organization return 2021-06-15 19:31:29,771 - worker - flussonic_sync - DEBUG - compare_cameras user_processed_cameras_names=[u'test-cam0143'] 2021-06-15 19:31:29,781 - worker - flussonic_sync - DEBUG - compare_cameras return 2021-06-15 19:31:29,782 - worker - flussonic_sync - INFO - Завершена синхронизация Flussonic 2021-06-15 19:31:29,782 - worker - flussonic_sync - INFO - Ждем 5 минут {code} h3. Как дать пользователю доступ к камерам в нескольких организациях? Создайте вручную отдельного пользователя, который не будет синхронизироваться биллингом, и добавьте его в обе организации. |