README.html

<h1 align="center">
Мониторинг сигнализации Starline
</h1>
<p clear="both">
<div data-align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://thumb.cloud.mail.ru/weblink/thumb/xw1/W6iB/sgfcSLwR8">
<img alt="ZtarLine" src="https://thumb.cloud.mail.ru/weblink/thumb/xw1/W6iB/sgfcSLwR8" width="600">
</picture>
<p align="center">
<img src="https://img.shields.io/badge/PHP-7.2.5 or later-blue" />
<img src="https://img.shields.io/badge/Ubuntu_Server-18.04 or later-blue" />
<img src="https://img.shields.io/badge/Zabbix-6.x +-blue" />
<img src="https://img.shields.io/badge/Apache-2.4 or later-blue" />
<img src="https://img.shields.io/badge/Mysql-8.0.X-blue" />
</p>
</div>
*
<h3 align="center">
Скрипт ZstarLine нужен для интеграции автомобильной сигнализации
Starline в систему мониторинга Zabbix как для личного использования, так
и для коммерческого.
</h3>
<ul>
<li>*
<h4 align="center">
Данный скрипт тестируется на
<a href="https://releases.ubuntu.com/focal/">OC Ubuntu Server 22.04.6
LTS</a>, <a href="https://www.php.net/downloads.php#v8.2.12">PHP
8.2.12</a>, <a href="http://archive.apache.org/dist/httpd/">Apache
2.4.58</a>,
<a href="https://downloads.mysql.com/archives/community/?tpl=files&os=22&version=8.2.12&osva=Ubuntu Linux 22.04 (x86, 64-bit)">MySQL
8.2.12</a>,
<a href="https://store.starline.ru/catalog/avtosignalizatsii/starline_s96_bt_2can_4lin_2sim_gsm/">Starline
s96v2</a>
</h4>
<ul>
<li></br></li>
</ul></li>
</ul>
<!-- TABLE OF CONTENTS -->
<a name="readme-top"></a>
<details>
<summary>
МЕНЮ
</summary>
<ol>
<li>
<a href="#Системные-требования">Системные требования</a>
</li>
<li>
<a href="#Установка">Установка</a>
</li>
<li>
<a href="#Настройка">Настройка</a>
</li>
<ul>
<li>
<a href="#AppId-и-Secret-Starline">AppId и Secret Starline</a>
</li>
<li>
<a href="#Настройка-Zabbix">Настройка Zabbix</a>
</li>
</ul>
</li>
</ol>
</details>
<p></br></p>
<h1 id="системные-требования">Системные требования</h1>
Данный скрипт работает на установленной системе мониторинга Zabbix
начиная с 6 версии и выше. С требованиями к системе вы можете
ознакомиться в официальной инструкции
-&gt;<a href="https://www.zabbix.com/documentation/6.0/ru/manual/installation/requirements#примеры-конфигураций-оборудования">Требования</a>
<p align="right">
(<a href="#readme-top">Вверх</a>)
</p>
<p></br></p>
<h1 id="установка">Установка</h1>
<p><sub>Данное руководство для Ubuntu/Debian OC</sub></p>
<p>Скачиваем скрипт в домашнюю директорию ubuntu</p>
<pre><code>sudo git clone https://github.com/iFraso-dev/ZtarLine.git</code></pre>
<p>переходим в скаченную директорию</p>
<pre><code>cd ZtarLine/</code></pre>
<p>копируем файлы в директорию <code>/externalscripts</code> Zabbix <a
href="#fn1" class="footnote-ref" id="fnref1"
role="doc-noteref"><sup>1</sup></a></p>
<pre><code>sudo cp ztarline.php user_data.php /usr/lib/zabbix/externalscripts</code></pre>
<p>меняем права доступа к файлам, измением владельца и группу</p>
<pre><code>sudo chmod 755 /usr/lib/zabbix/externalscripts/ztarline.php
sudo chown root:root /usr/lib/zabbix/externalscripts/ztarline.php
sudo chmod 755 /usr/lib/zabbix/externalscripts/user_data.php
sudo chown root:root /usr/lib/zabbix/externalscripts/user_data.php</code></pre>
<p>отредактируйте файл “user_data.php”. Внесите данные, полученные в
разделе <a href="#AppId-и-Secret-Starline">AppId и Secret
Starline</a></p>
<pre><code>sudo nano /usr/lib/zabbix/externalscripts/user_data.php</code></pre>
<p>укажите:</p>
<ul>
<li>$user_login = ‘Your@email.com’; ⇒ Ваш логин от
https://my.starline.ru</li>
<li>$user_pass = sha1(‘Your_password’); ⇒ Ваш пароль от
https://my.starline.ru</li>
<li>$user_AppId = ‘AppId’; ⇒ Ваш сгенерированный AppId в личном
кабинете</li>
<li>$user_Secret = ‘Your_generated_Secret’; ⇒ Ваш сгенерированный Secret
в личном кабинете</li>
<li>$user_Secret_md5 = md5(‘Your_generated_Secret’); ⇒ Ваш
сгенерированный Secret в личном кабинете</li>
</ul>
<p align="right">
(<a href="#readme-top">Вверх</a>)
</p>
<p></br></p>
<h1 id="настройка">Настройка</h1>
<h2 id="appid-и-secret-starline">AppId и Secret Starline</h2>
<p>Войдите в личный кабинет <a
href="https://my.starline.ru/developer">My Starline</a> в раздел <a
href="https://my.starline.ru/developer">Разработчикам</a>. Заполняете
форму для получения AppId и Secret. Укажите цель полуения доступа к API
(в нашем случае для интеграции в систему мониторинга).</p>
<p>После одобрения заявки будет доступен раздел “Разработчикам”.</p>
<p>Нажмите “Создать приложение” и в окне “Новое приложение” задайте “Имя
приложения”. Далее “СОХРАНИТЬ”.</p>
<p><picture>
<img alt="ZtarLine" src="https://thumb.cloud.mail.ru/weblink/thumb/xw1/fFVp/jYhWuKFPQ" width="800">
</picture> <picture>
<img alt="ZtarLine" src="https://thumb.cloud.mail.ru/weblink/thumb/xw1/EgvV/SwFL3GH39" width="800">
</picture></p>
<h2 id="настройка-zabbix">Настройка Zabbix</h2>
<p>Переходим на страницу Zabbix http://host-ip/zabbix <a href="#fn2"
class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a></p>
<p>Создаем “Группы узлов сети” c именем “MyDevice”.</p>
<p align="right">
(<a href="#readme-top">Вверх</a>)
</p>
<p></br></p>
<section class="footnotes footnotes-end-of-document"
role="doc-endnotes">
<hr />
<ol>
<li id="fn1" role="doc-endnote"><p>Для определения расположени
директории <code>/externalscripts</code> используйте команду
<code>find / -type d -iname externalscripts</code>. В ответ получите
<code>/usr/lib/zabbix/externalscripts</code> или другое расположение
директории.<a href="#fnref1" class="footnote-back"
role="doc-backlink">↩︎</a></p></li>
<li id="fn2" role="doc-endnote"><p>URL-адрес по умолчанию для
пользовательского интерфейса Zabbix при использовании веб-сервера
Apache.<a href="#fnref2" class="footnote-back"
role="doc-backlink">↩︎</a></p></li>
</ol>
</section>