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

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

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

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

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

Сделайте reconfig что бы изменения вступили в силу.

Вы также можете задать раздельный профиль для каждого сервиса, входящего в 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 px).

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

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

Выполните reconfig что бы изменения вступили в силу.

Дополнительно, используя любой генератор иконок, вы можете создать свой собственный пакет фавиконов в разных форматах для разных браузеров (например, 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

Выполните reconfig что бы изменения вступили в силу.

После старта 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

После выполнения reconfig в 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.