Flussonic Watcher v2

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

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

просмотр истории страницы
...
#* Добавьте камеры [через мобильное приложение|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:Локальный сайт. Личный кабинет.], вместе с прочими услугами.
...
{code}dvr_lock_days=7{code}

Опция камеры "Получать события" должна быть включена, чтобы работало сохранения записи по движению, поэтому если задать параметры лимита DVR, то опция "Получать события" будет включена автоматический.

h4. PTZ
...
{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}

|| Вкладка "Основные" || Вкладка "Дополнительно" || Вкладка "Личный кабинет" ||
...
Биллинг сразу создаст на 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!
...

В статье [CarbonBilling:Примеры технических отчётов] мы подготовили несколько отчётов, которые могут быть полезны администраторам:
* [Услуги, привязанные к NAS|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] отразит основные параметры услуг из справочника, привязанных к выбранному NAS
* [Количество абонентов с услугами привязанными к NAS-серверам|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] покажет количество абонентов по NAS - то есть, с подключенным видеонаблюдением.
* [Учтетные [Flussonic Watcher v2, учтётные записи, камеры и услуги по камерам для схемы интеграции Flussonic Watcher v2|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Учтетныезаписи%2CкамерыиуслугипокамерамдлясхемыинтеграцииFlussonicWatcherv2SUP675790] 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?

Синхронизатор автоматический отключит в биллинге услуги по этой камере в течение 5 минут - этим управляет синхронизация.

h3. Если удалить камеру на Watcher, и добавить вновь, что будет в справочнике оборудования?
...

Организация и учётная запись останутся на 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. Как дать пользователю доступ к камерам в нескольких организациях?

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