Skip to content

Другие настройки

Настройка профиля безопасности seccomp для Docker

Вы можете задать в явном виде профиль безопасности seccomp для Docker. Для этого измените конфигурацию.

Загрузите профиль seccomp на машину, на которой установлен Apiary. В свойстве seccomp.profile укажите путь до профиля seccomp:

[main]
seccomp.profile = /path/to/seccomp_profile

Выполните реконфигурацию, чтобы изменения вступили в силу.

Вы также можете задать раздельный профиль для каждого сервиса, входящего в Apiary. Подробнее об опциях seccomp.profile смотрите в файле /opt/hw-fh/config/user-template.ini.

Конфигурация логотипа и фавикона

При необходимости можно установить собственные логотипы и фавиконы в Apiary:

  • В Окно логина;
  • В левую навигационную панель;
  • В левый верхний угол Главной страницы;
  • В окно About (О нас).

На машине, где установлен Apiary, создайте новую директорию, например:

mkdir /opt/my-logo

В эту директорию загрузите свой логотип и фавикон. В большинстве случаев вам понадобится всего три файла:

  • favicon.ico — значок во вкладке браузера, закладках и адресной строке;
  • logo-white.svg — логотип в левой панели навигации (размер логотипа должен быть 200 х 55 пикселей);
  • logo.svg — логотип в верхней панели навигации и в окне логина (размер логотипа должен быть 200 x 55 пикселей).

Нужно изменить конфигурацию и добавить свойство f.deck.logotypes.dir в секцию main:

```
f.deck.logotypes.dir = /opt/my-logo
```

Выполните реконфигурацию, чтобы изменения вступили в силу.

Дополнительно, используя любой генератор иконок, вы можете создать свой собственный пакет фавиконов в разных форматах для разных браузеров (Chrome, Safari и т. д.) и платформ (iOS, Android и т. д.), затем загрузить эти файлы в свой каталог. Пример:

  • apple-touch-icon.png
  • favicon-32x32.png
  • favicon-194x194.png
  • android-chrome-192x192.png
  • favicon-16x16.png
  • safari-pinned-tab.svg

Если вы хотите использовать разные размеры фавикона, добавьте файл site.webmanifest в эту же директорию с логотипом и укажите необходимые настройки.

Пример:

{
  "icons": [
    {
      "src": "./android-chrome-36x36.png",
      "sizes": "36x36",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-48x48.png",
      "sizes": "48x48",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-72x72.png",
      "sizes": "72x72",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-96x96.png",
      "sizes": "96x96",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-144x144.png",
      "sizes": "144x144",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-256x256.png",
      "sizes": "256x256",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-384x384.png",
      "sizes": "384x384",
      "type": "image/png"
    },
    {
      "src": "./android-chrome-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ]
}

Спецификация OpenAPI

Если вам требуется увидеть спецификацию OpenAPI (также известную как swagger), но при этом нет доступа к ней через UI, то вы можете скачать её.

На машине, где установлен Apiary, выполните команду (требуются права администратора):

docker cp \
  hw-fh-f_engine_1:/usr/src/app/swagger_server/swagger/swagger.yaml \
  apiary-swagger.yml

Вы также можете изучить спецификацию OpenAPI и попробовать использовать её при помощи Swagger UI. Swagger UI по умолчанию отключён, но его можно включить. Для этого нужно изменить конфигурацию:

[main]
f.engine.swagger.ui.enabled = on

Выполните реконфигурацию, чтобы изменения вступили в силу.

После старта Apiary откройте браузер на странице http://<apiary-URL>/api/ui/.

Дополнительные возможности логирования

В зависимости от политик логирования в вашей компании, вам может потребоваться дополнительно настроить модуль systemd. Для этого в Apiary предусмотрены опции system.syslog.facility и system.syslog.identifier.

Пример файла /opt/hw-fh/config/user.ini:

[main]
system.syslog.facility = local5
system.syslog.identifier = my_app_logger

После реконфигурации в systemd в модуль Apiary будет добавлено:

[Service]
...
SyslogFacility = local5
SyslogIdentifier = my_app_logger

Если опции system.syslog.facility и system.syslog.identifier не заданы, то в модуль systemd не будет добавлено значений для SyslogFacility и SyslogIdentifier, и systemd будет использовать значения по умолчанию.

Прочие настройки

Если вы не нашли нужные настройки, посмотрите файл /opt/hw-fh/config/user-template.ini. Если вы и там не нашли нужных вам настроек, напишите в команду поддержки на почту support@hexway.ru.