Настройки

tip

This section is available to the Founder, Owners and Administrators.

На вкладке Настройки приложения собраны параметры, которые влияют на то, как прокси обрабатывает запросы к upstream — заголовки, пути, TLS, CORS и внешний вид страницы входа.

Видимость

Определяет, видят ли участники команды это приложение в пользовательском каталоге.

Если выключить — приложение исчезнет из каталога, но продолжит работать по своему адресу. Полезно для внутренних сервисов, к которым обращаются только через API или автоматизацию.

Логотип и страница блокировки

• Ссылка на логотип — URL изображения, которое появится на странице входа вместо стандартного. Помогает пользователям сразу понять, куда они попали.
• Адрес страницы блокировки — вместо стандартной страницы «доступ запрещён» пользователь будет перенаправлен по этому адресу. Например, на корпоративную страницу поддержки.

Заголовок Host

• Принудительно установить заголовок Host — по умолчанию upstream получает Host из своего URL. Если ваш бэкенд ожидает конкретный Host (например, nginx с виртуальными хостами), укажите его здесь.
• Передать оригинальный Host из запроса клиента — upstream увидит тот же Host, что ввёл пользователь в браузере. Перекрывает Host Override.

Путь

Управление URL-путём запроса перед проксированием.

• Вырезать префикс — удаляет указанный префикс из пути. Пример: при значении /api/v1 запрос /api/v1/users пойдёт на upstream как /users.
• Добавить префикс — приклеивает префикс к пути перед отправкой на upstream. Применяется после вырезания.

info

Комбинация: вырезать /api/v1 + добавить /internal → запрос /api/v1/users пойдёт на upstream как /internal/users.

Лимит размера тела запроса

Максимальный размер тела HTTP-запроса от клиента (upload) в байтах. По умолчанию — 32 МиБ (33554432 байт). Если ваш сервис принимает большие файлы, увеличьте значение. 0 — без ограничения.

CORS

Если ваш фронтенд живёт на другом домене и обращается к приложению через fetch/XMLHttpRequest — включите CORS. Preflight-запросы (OPTIONS) при этом проходят без авторизации.

После включения появляются параметры:

Параметр	Описание
Разрешённые источники	Домены, с которых разрешены запросы. По одному на строку, * — все
Разрешённые методы	HTTP-методы: GET, POST, PUT, DELETE и др.
Разрешённые заголовки	Заголовки, которые клиент может отправлять
Разрешить Cookies	Позволяет передавать cookies и заголовки авторизации. Нельзя комбинировать с * в источниках
Кэш Preflight	Сколько секунд браузер может кэшировать ответ на OPTIONS

Заголовки запроса и ответа

Добавьте пользовательские заголовки к запросам (при передаче на upstream) и ответам (перед отправкой клиенту). Типичные примеры: X-Custom-Header для идентификации источника, Strict-Transport-Security для HSTS.

TLS до upstream

Настройки TLS-соединения между прокси и вашим бэкендом.

• Не проверять TLS сертификат upstream — включайте только для тестовых окружений или бэкендов с самоподписанным сертификатом.

Клиентский сертификат (mTLS)

Если ваш upstream требует взаимную аутентификацию (mTLS), прокси может предъявить клиентский сертификат. Это позволяет upstream убедиться, что запрос пришёл именно через Tuna, а не напрямую.

• Клиентский сертификат (PEM) — сертификат, который прокси предъявляет upstream.
• Приватный ключ (PEM) — ключ к сертификату.
• Корневой CA (PEM, опционально) — корневой сертификат, если upstream использует собственный CA.