# 13. Найпоширеніші помилки

В таблиці нижче наведено приклади найпоширеніших помилок та способи їх вирішення.

<table border="1" id="bkmrk-%D0%9F%D0%BE%D0%BC%D0%B8%D0%BB%D0%BA%D0%B0-%D0%9F%D1%80%D0%B8%D1%87%D0%B8%D0%BD%D0%B0-%D0%92%D0%B8%D0%BF%D1%80" style="width: 840px; height: 508.844px;" width="689"><thead><tr style="height: 35.1979px;"><td class="align-center" style="width: 214.688px; height: 35.1979px;">**Помилка**

</td><td class="align-center" style="width: 260.698px; height: 35.1979px;">**Причина**

</td><td class="align-center" style="width: 363.802px; height: 35.1979px;">**Виправлення**

</td></tr></thead><tbody><tr style="height: 79.8542px;"><td style="height: 79.8542px;" valign="top"><span lang="UK">При спробі відкрити вебінтерфейс ШБО відображається повідомлення «403 forbidden»</span>

</td><td style="height: 79.8542px;" valign="top"><span lang="UK">На ШБО не надано права доступу до його вебінтерфейсу з робочої станції адміністратора </span>

</td><td style="height: 79.8542px;" valign="top"><span lang="UK">Надати доступ для робочої станції адміністратора згідно [розділу 13.1](https://docs.trembita.gov.ua/link/204#bkmrk-8.1-%D0%92%D0%B8%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BF%D0%BE%D0%BC%D0%B8) даної інструкції</span>

</td></tr><tr style="height: 57.5938px;"><td rowspan="5" style="text-align: justify; width: 214.688px; height: 313.792px;"><span lang="UK">Помилка при виклику вебсервісу</span>

</td><td style="width: 260.698px; height: 57.5938px;" valign="top"><span lang="UK">Немає прав доступу до сервісу для підсистеми даної організації</span>

</td><td style="width: 363.802px; height: 57.5938px;" valign="top"><span lang="UK">Звернутися до адміністратора організації власника вебсервісу для надання доступу</span>

</td></tr><tr style="height: 57.5938px;"><td style="width: 260.698px; height: 57.5938px;" valign="top"><span lang="UK">Не введені PIN-коди для токенів</span>

</td><td style="width: 363.802px; height: 57.5938px;" valign="top"><span lang="UK">Ввести PIN-коди для токенів авторизації і підпису/шифрування</span>

</td></tr><tr style="height: 57.5938px;"><td style="width: 260.698px; height: 57.5938px;" valign="top"><span lang="UK">Закінчився термін дії сертифіката авторизації і/або підпису/шифрування</span>

</td><td style="width: 363.802px; height: 57.5938px;" valign="top"><span lang="UK">Отримати та завантажити діючі сертифікати</span>

</td></tr><tr style="height: 57.5938px;"><td style="width: 260.698px; height: 57.5938px;" valign="top"><span lang="UK">Сервер позначок часу не відповідає</span>

</td><td style="text-align: justify; width: 363.802px; height: 57.5938px;"><span lang="UK">Обрати інший сервер позначок часу згідно [розділу 7.1.3](https://docs.trembita.gov.ua/link/187#bkmrk-6.2.2.2.-%D0%9D%D0%B0%D0%BB%D0%B0%D1%88%D1%82%D1%83%D0%B2%D0%B0%D0%BD%D0%BD) даної інструкції</span>

</td></tr><tr style="height: 83.4167px;"><td style="width: 260.698px; height: 83.4167px;" valign="top"><span lang="UK">При реєстрації було вказано неправильну адресу шлюзу безпечного обміну</span>

</td><td style="width: 363.802px; height: 83.4167px;" valign="top"><span lang="UK">Виправити адресу шлюзу безпечного обміну на сервері Каталогу Учасників системи «Трембіта» (звернутися до Адміністратора системи «Трембіта»)</span>

</td></tr><tr style="height: 80px;"><td style="text-align: justify; width: 214.688px; height: 80px;">Помилка нестачі пам'яті («java.lang.OutOfMemoryError: Java heap space»)

</td><td style="text-align: justify; width: 260.698px; height: 80px;">Для віртуальної машини Java (JVM) служби uxp-proxy виділено недостатньо оперативної пам'яті

</td><td style="width: 363.802px; height: 80px;" valign="top"><span lang="UK">Збільшити кількість пам'яті JVM для служби uxp-proxy згідно [розділу 13.2](https://docs.trembita.gov.ua/link/204#bkmrk-13.2-%D0%92%D0%B8%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BF%D0%BE%D0%BC) даної інструкції</span>

</td></tr></tbody></table>

---

#### <span lang="UK">13.1 </span><span lang="UK"><span lang="UK">Забезпечення доступу до вебінтерфейсу шлюзу безпечного обміну з робочої станції адміністратора</span></span>

<p class="callout warning">**<span lang="UK">Важливо!</span>**<span lang="UK"> В промисловому середовищі користувачі з ролями «Адміністратор вебсервісів» та «Відповідальний за управління ключами» повинні підключатися до вебінтерфейсу ШБО виключно з робочих станцій адміністратора!</span></p>

<p class="callout info">**<span lang="UK">Примітка.</span>**<span lang="UK"> Якщо Суб’єкт електронної взаємодії та Учасник є різними юридичними особами, то Суб’єкт електронної взаємодії аналогічно повинен мати власну робочу станцію адміністратора.</span></p>

<span lang="UK">Керування доступом до вебінтерфейсу шлюзу безпечного обміну здійснюється за допомогою налаштувань NGINX. </span>

<span lang="UK">Перелік IP-адрес, з яких можна підключитись до ШБО знаходиться у файлі дозволених хостів. </span>

<p class="callout warning">**<span lang="UK">Важливо!</span>**<span lang="UK"> Даний файл повинен містити виключно адреси довірених робочих станцій адміністратора. Адміністратор локальних компонентів (системний адміністратор) повинен завжди тримати перелік дозволених адрес у актуальному стані.</span></p>

<span lang="UK">Для того, щоб додати ІР-адресу робочої станції адміністратора до файлу дозволених хостів необхідно:</span>

<span lang="UK">1. Відкрити на редагування файл /etc/uxp/uaic/allowed\_hosts.conf у текстовому редакторі nano за допомогою виконання наступної команди:</span>

```
sudo nano /etc/uxp/uaic/allowed_hosts.conf
```

<span lang="UK">2. Додати до файлу наступний рядок:</span>

```
allow <workstation-IP>;
```

<span lang="UK">де **&lt;workstation-IP&gt;** </span><span lang="UK">–</span><span lang="UK"> IP-адреса робочої станції адміністратора, що буде використовуватися для доступу до вебінтерфейсу ШБО.</span>

<span lang="UK">3. Зберегти зміни і закрити редактор. Для цього необхідно натиснути комбінацію клавіш «Ctrl+X», ввести «Y» для підтвердження збереження внесених змін та натиснути на клавішу «Enter».</span>

<span lang="UK">4. Перевірити конфігурацію за допомогою виконання наступної команди:</span>

```
sudo nginx -t
```

<span lang="UK">Якщо перевірку конфігурації пройдено успішно, буде виведено повідомлення «test is successful»:</span>

<span lang="UK">5. Перезавантажити сервіс NGINX, щоб застосувати зміни на ШБО, за допомогою виконання наступної команди:</span>

```
sudo service nginx reload
```

<span lang="UK">Перед виконанням подальших налаштувань ШБО, необхідно обчислити нові значення геш-функцій програмних компонентів ШБО за допомогою виконання наступної команди:</span>

```
sudo uxp-ua-integritychecker.sh recalc_all
```

---

#### <span lang="UK">13.2 </span><span lang="UK">Виправлення помилки нестачі пам’яті </span>

<span lang="UK">Дана помилка також може характеризуватися наявністю наступного повідомлення у журналі /var/log/uxp/proxy.log:</span>

<p class="callout info"><span lang="UK">&lt;faultcode&gt;Server.ServerProxy.ServiceFailed.InternalError&lt;/faultcode&gt;&lt;faultstring&gt;Self-suppression not permitted&lt;/faultstring&gt;</span></p>

<span lang="UK">Для виправлення даної помилки Адміністратор локальних компонентів (системний адміністратор) повинен збільшити обсяг пам'яті JVM для сервісу uxp-proxy. </span>

<span lang="UK">Для цього необхідно виконати наступні дії:</span>

<span lang="UK">1. Відкрити на редагування файл конфігурації /etc/uxp/services/local.conf за допомогою виконання наступної команди:</span>

```
sudo nano /etc/uxp/services/local.conf
```

<span lang="UK">2. Вказати нове значення обсягу виділеної оперативної пам’яті в наступному рядку:</span>

```
PROXY_JVM_OPTS="${PROXY_JVM_OPTS} -Xmx<size>
```

<span lang="UK">де &lt;size&gt; - розмір виділеної оперативної пам’яті в МБ.</span>

<span lang="UK">Наприклад, </span><span lang="UK">для того, щоб задати максимально можливий</span> <span lang="UK">обсяг виділеної оперативної пам’яті, необхідно вказати значення 1024 MB:</span>

```
PROXY_JVM_OPTS = "${PROXY_JVM_OPTS} -Xmx1024m"
```