Add files via upload

README.html

@@ -0,0 +1,152 @@
+<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>