---
title: "Условия на вашем прокси | FoxAuth"
description: "Пускайте в приложение или API за прокси только из вашей сети, только в рабочие часы, только из отдела или только после недавнего входа."
canonical: "https://foxauth.dev/ru/docs/get-started/add-conditions-at-your-proxy/"
lastmod: "2026-11-17T11:19:13+03:00"
---
Условия на вашем прокси

Приложение за прокси решает, кто может открыть каждый путь. API, токены которого проверяет прокси, решает, какие
инструменты может вызвать токен. Об этом две страницы: Вход перед веб-приложением
и Защита MCP-сервера на вашем прокси. Эта страница
добавляет к ним условия.

Условие означает «и только если». Оно никого не пускает сверх того, кого пускали раньше. Оно может только сузить
доступ.

Какие бывают условияЗаголовок раздела «Какие бывают условия»

Условие
Что проверяет
Для чего

From where
адрес входит в один из ваших диапазонов или ни в один из них
приложения, API

Network facts
адрес не из Tor, VPN или хостинга либо из ваших стран
приложения, API

When
момент попадает в ваши часы, в выбранном часовом поясе
приложения, API

Attribute
отдел, должность или другое поле человека равны одному из ваших
приложения, API

Groups
человек состоит в одной из ваших групп
API

Ask to sign in again
человек вошёл не раньше чем N минут назад
приложения

Группы приложения уже указаны в его правиле для каждого пути, поэтому условием они бывают только у API. Сведения о
сети входят в From where и отдельным условием не считаются. У API нет условия Ask to sign in again. Вместо
этого на его собственной вкладке Access можно требовать код из приложения-аутентификатора или недавний вход:
смотрите раздел Код или недавний вход для подключения.

Значения внутри одного условия объединяются через «или»: «из офиса или через VPN». Разные условия объединяются через
«и»: «из офиса и в рабочие часы». У правила не больше одного условия каждого вида.

Как условия действуют на путиЗаголовок раздела «Как условия действуют на пути»

Кто может открыть путь, по-прежнему решает самый длинный подходящий путь. Условия складываются вниз по путям:
условия / действуют на все пути, а условие на /admin действует на /admin и всё под ним, вместе с условиями /.
Путь может добавить условие. Убрать условие пути выше он не может. У публичных путей условий нет.

Проект решает в постоянном порядке:

From where и When, до входа. Человеку не из того места или не в те часы отказывают, не спрашивая пароль.

Вошёл ли человек, может ли он входить и состоит ли в группах правила.

Attribute.

Ask to sign in again, последним. Никого не отправляют входить, чтобы потом всё равно отказать.

Сведения о сети, которые вместо отказа просят войти снова, проверяются вместе с Ask to sign in again, последними.

From where: прокси передаёт адресЗаголовок раздела «From where: прокси передаёт адрес»

Адрес человека знает только ваш прокси. Браузер может записать в заголовок любой адрес, поэтому проект верит адресу,
только когда прокси доказывает, что записал его сам.

На странице Connect приложения или API откройте шаг Your proxy passes people’s addresses и нажмите
Issue a proxy key. Скопируйте ключ: он показывается один раз. У проекта не больше двух ключей, поэтому один
можно заменить другим без момента, когда прокси получает отказ.

Добавьте в прокси строки из конфигурации на этой странице. Они перезаписывают X-Forwarded-For адресом, с
которого пришло соединение, и добавляют ключ. Для Caddy задайте FOXAUTH_PROXY_KEY в окружении, где работает
Caddy. Для nginx вставьте ключ туда, где в конфигурации написано <FOXAUTH_PROXY_KEY>.

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

Условие по сети нельзя сохранить, пока не пришла проверка с ключом и публичным адресом. Поэтому одно сохранение не
может запереть всех.

CaddyЗаголовок раздела «Caddy»

Caddyfile

grafana.example.com {

route {

request_header -X-Auth-*

request_header -X-FoxAuth-Proxy-Key

forward_auth https://auth.example.com {

uri /acme/verify/<appId>

header_up Host {upstream_hostport}

header_up X-Forwarded-For {remote_host}

header_up X-FoxAuth-Proxy-Key {$FOXAUTH_PROXY_KEY}

copy_headers X-Auth-User X-Auth-Email X-Auth-Groups X-Auth-Assertion X-Auth-Reason

}

reverse_proxy 127.0.0.1:8080

}

}

nginxЗаголовок раздела «nginx»

nginx server block

server {

listen 443 ssl;

server_name grafana.example.com;

# ssl_certificate and ssl_certificate_key for grafana.example.com

location / {

auth_request /_foxauth_check;

auth_request_set $foxauth_x_auth_user $upstream_http_x_auth_user;

auth_request_set $foxauth_x_auth_email $upstream_http_x_auth_email;

auth_request_set $foxauth_x_auth_groups $upstream_http_x_auth_groups;

auth_request_set $foxauth_x_auth_assertion $upstream_http_x_auth_assertion;

auth_request_set $foxauth_x_auth_reason $upstream_http_x_auth_reason;

error_page 401 403 = @foxauth;

proxy_set_header X-Auth-User $foxauth_x_auth_user;

proxy_set_header X-Auth-Email $foxauth_x_auth_email;

proxy_set_header X-Auth-Groups $foxauth_x_auth_groups;

proxy_set_header X-Auth-Assertion $foxauth_x_auth_assertion;

proxy_set_header X-Auth-Reason $foxauth_x_auth_reason;

proxy_set_header Host $host;

proxy_set_header X-FoxAuth-Proxy-Key "";

proxy_pass http://127.0.0.1:8080;

}

location = /_foxauth_check {

internal;

proxy_pass https://auth.example.com/acme/verify/<appId>?mode=status;

proxy_set_header X-Forwarded-Host $host;

proxy_set_header X-Forwarded-Uri $request_uri;

proxy_set_header X-Forwarded-Method $request_method;

proxy_set_header Host auth.example.com;

proxy_ssl_server_name on;

proxy_pass_request_body off;

proxy_set_header Content-Length "";

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header X-FoxAuth-Proxy-Key "<FOXAUTH_PROXY_KEY>";

}

location /_foxauth/ {

rewrite ^ /acme/verify/<appId>? break;

proxy_pass https://auth.example.com;

proxy_redirect off;

proxy_set_header X-Forwarded-Host $host;

proxy_set_header X-Forwarded-Uri $request_uri;

proxy_set_header X-Forwarded-Method $request_method;

proxy_set_header Host auth.example.com;

proxy_ssl_server_name on;

proxy_pass_request_body off;

proxy_set_header Content-Length "";

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header X-FoxAuth-Proxy-Key "<FOXAUTH_PROXY_KEY>";

}

location @foxauth {

rewrite ^ /acme/verify/<appId>? break;

proxy_pass https://auth.example.com;

proxy_redirect off;

proxy_set_header X-Forwarded-Host $host;

proxy_set_header X-Forwarded-Uri $request_uri;

proxy_set_header X-Forwarded-Method $request_method;

proxy_set_header Host auth.example.com;

proxy_ssl_server_name on;

proxy_pass_request_body off;

proxy_set_header Content-Length "";

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header X-FoxAuth-Proxy-Key "<FOXAUTH_PROXY_KEY>";

}

}

Ключ и адрес задаются во всех трёх местах, откуда nginx обращается к проверке.

TraefikЗаголовок раздела «Traefik»

Traefik dynamic configuration

http:

middlewares:

foxauth:

forwardAuth:

address: "https://auth.example.com/acme/verify/<appId>"

trustForwardHeader: false

authResponseHeadersRegex: "^X-Auth-"

preserveLocationHeader: true

foxauth-key:

headers:

customRequestHeaders:

X-FoxAuth-Proxy-Key: "<FOXAUTH_PROXY_KEY>"

foxauth-key-drop:

headers:

customRequestHeaders:

X-FoxAuth-Proxy-Key: ""

routers:

app:

rule: "Host(`grafana.example.com`)"

entryPoints:

- websecure

middlewares:

- foxauth-key

- foxauth

- foxauth-key-drop

service: app

tls: {}

services:

app:

loadBalancer:

servers:

- url: "http://127.0.0.1:8080"

Заметка

Traefik не умеет сам добавить заголовок к проверке, поэтому ключ передаётся
через два промежуточных слоя headers: первый добавляет его перед проверкой,
второй убирает после, и ваше приложение его не получает.

Чему верит проектЗаголовок раздела «Чему верит проект»

Ровно одному адресу, записанному обычным образом. Два адреса, порт, скобки или необычная запись делают адрес
неизвестным.

Неизвестный адрес не проходит ни одно условие по сети: ни «только из», ни «не из».

Частный адрес, например балансировщика или сети контейнеров, для «не из» считается неизвестным. Страница Connect
говорит, когда прокси присылает такой адрес.

CDN перед прокси не поддерживается, кроме Cloudflare, когда прокси принимает соединения только с адресов
Cloudflare.

Адрес сравнивается с вашими диапазонами, а со сведениями о сети ещё и ищется в собственной копии снимка
FoxTrust на вашем сервере. Проверка никогда не пишет его в строки журнала и никуда его не отправляет. Когда путь
отказывает человеку или просит его войти заново, вкладка Activity этого человека хранит адрес 90 дней, потому что
ваш прокси подтвердил его ключом проекта. Пока включена настройка Look up network owner and location at
FoxTrust (по умолчанию она включена), сервер затем отправляет этот сохранённый адрес в API FoxTrust, чтобы показать
рядом с ним владельца сети, регион и город (что FoxAuth хранит о людях).

VPN или резидентный прокси всё равно могут обойти список диапазонов. Условие по сети замедляет злоумышленника, но не
останавливает. Сведения о сети не пускают VPN-сервисы из списка FoxTrust, но резидентный прокси всё равно пройдёт.

Для API адрес принадлежит машине, которая его вызывает. Ассистенты, работающие в облаке, вызывают API из своего
облака, а не из сети человека.

Сведения о сети: Tor, VPN, хостинг и страныЗаголовок раздела «Сведения о сети: Tor, VPN, хостинг и страны»

Список диапазонов называет адреса, которые вы знаете. Сведения о сети говорят, что это за адрес, даже если вы его
никогда не видели: выход сети Tor, коммерческий VPN, дата-центр или страна. Это необязательная вторая часть
From where, на пути приложения и у API. Как и списку диапазонов, им нужны ключ прокси и адрес из шагов выше.

Включите загрузкуЗаголовок раздела «Включите загрузку»

Сведения о сети берутся у FoxTrust, сервиса репутации IP-адресов. FoxTrust публикует подписанный снимок того, что
знает об адресах в интернете. Ваш сервер сам скачивает снимок и сам его проверяет.

Суперадминистратор открывает Settings → Integrations и включает Network facts from FoxTrust. По умолчанию
это выключено. Это бесплатно на любом тарифе.

После этого каждый процесс сервера раз в сутки скачивает полный файл примерно на 13 МБ, а каждый час обновление к
нему. Новый файл он ищет каждые 5 минут. Файл используется только после проверки его размера, контрольной суммы и
подписи FoxTrust.

Карточка под настройкой показывает, когда собран снимок, его возраст, сколько в нём диапазонов адресов и последнюю
ошибку, если она была.

Для условия адреса людей никогда не отправляются ни в FoxTrust, ни куда-либо ещё. Сервер только ищет их в своей
копии, и FoxTrust узнаёт лишь то, что файл скачали. Владельца сети и место адресов, которые хранит активность
человека, показывает отдельная настройка, Look up network owner and location at FoxTrust. Она отправляет эти
адреса в API FoxTrust.

Что можно не пускатьЗаголовок раздела «Что можно не пускать»

В разделе Network facts from FoxTrust отметьте, кого путь не пускает:

Выбор
Что сюда входит

Tor
Выходы сети Tor.

Commercial VPN
Только VPN-сервисы из списка FoxTrust. VPN вашей компании сюда не входит.

Hosting or a cloud
Дата-центры и облака. Через них работают и сети доставки контента, и выходы в интернет некоторых компаний.

iCloud Private Relay в списке нет, и его адреса проходят. FoxTrust не считает их ни VPN, ни хостингом.

СтраныЗаголовок раздела «Страны»

Выберите Only from или Not from, а затем страны. В одном условии бывает только один из двух списков, до 250
стран.

Адрес, страна которого неизвестна, не проходит Only from и проходит Not from.

У адреса из частной сети самого прокси страны нет, поэтому Only from его не пускает. Not from его
пропускает, и для категорий, и для стран.

Регион и город не используются.

Страны берутся из DB-IP. Везде, где консоль показывает страну, она показывает и строку, которую требует лицензия
данных: IP Geolocation by DB-IP, CC BY 4.0.

Что происходит с подходящим адресомЗаголовок раздела «Что происходит с подходящим адресом»

Выберите, что будет, когда адрес подходит под условие:

Refused. Ещё до входа человек видит страницу с заголовком «You can’t open app.example.com from where you are» на
своём языке. На ней не названы ни источник, ни категория, ни страна. Прокси получает 403 с
X-Auth-Reason: not_from_network.

Asked to sign in again within N minutes, только для приложения. Человека, чей вход старше N минут, отправляют
войти снова. N бывает от 5 минут до суток. Отметьте with a code from an authenticator app, чтобы просить и код.
Тогда консоль покажет те же числа людей, что и для кода в Ask to sign in again.

Адрес, который не подходит под условие, ни о чём не спрашивают. То, что FoxTrust знает о сети, может оказаться
неверным, а попросить войти снова мягче, чем отказать. На API, который проверяется на прокси, сведения о сети могут только
отказать: при проверке токена нет браузера, который можно отправить на вход. Но сам API может просить код или
недавний вход в своих настройках: смотрите раздел Код или недавний вход для подключения.

Строка правила описывает условие словами, например «not from Tor, a VPN or hosting» или «only from Germany or
Austria».

Когда сведения неизвестныЗаголовок раздела «Когда сведения неизвестны»

Сервер не может сказать, что это за адрес, пока загрузка выключена, пока не загрузился первый снимок и когда
загруженный снимок собран больше 26 часов назад. Тогда каждый путь со сведениями о сети закрыт, что бы ни было выбрано
для подходящего адреса.

Человек видит страницу с заголовком «app.example.com can’t be opened right now» на своём языке. Прокси получает
403 с X-Auth-Reason: network_facts_unknown.

Консоль отмечает каждый такой путь и объясняет причину.

Когда загрузится свежий снимок, пути откроются сами.

Неудачная загрузка сразу ничего не меняет. Сервер продолжает работать с последним хорошим снимком, пока тому не
исполнится 26 часов.

Добавить или изменить сведения о сети можно только при включённой загрузке. Условие, сохранённое раньше, после
выключения загрузки остаётся сохранённым и закрывает свой путь.

Проверьте адресЗаголовок раздела «Проверьте адрес»

В Check access введите адрес из сообщения человека. Консоль ищет его в собственной копии снимка на сервере и
показывает его категории и страну или пишет, что FoxTrust о нём ничего не знает, а также возраст снимка. Адрес никуда
не отправляется. Если адрес не введён, у сведений о сети стоит «?».

Агент задаёт сведения о сети через behind_proxy_app_update или resource_update, в виде facts у условия
network. Объяснить отказ он может через network_facts_lookup.

When: часы работыЗаголовок раздела «When: часы работы»

Выберите дни и часы с шагом 15 минут и часовой пояс, в котором их читать. Пояс задаётся один раз для приложения или
API. Часы, которые кончаются раньше, чем начинаются, переходят через полночь: «пт 22:00–06:00» означает ночь с
пятницы на субботу.

Человек, пришедший вне часов, видит, когда приложение откроется снова, в его часовом поясе.

AttributeЗаголовок раздела «Attribute»

Выберите атрибут и его значения. Это поля, которые задаёт человеку администратор или каталог: отдел, подразделение,
организация, центр затрат, табельный номер, должность или claim, заданный администратором. Claims от внешнего
сервиса входа, например имя или фото, выбрать нельзя: человек может их изменить.

Консоль показывает, сколько людей в проекте подходят. Условие, которому не подходит никто, сохранить нельзя.

Ask to sign in againЗаголовок раздела «Ask to sign in again»

Выберите 15 минут, час, 8 часов, сутки или своё значение от 5 минут. Когда вход человека старше, браузер отправляют
войти снова, и страница входа объясняет зачем. Запрос, который не открывает страницу, получает 401.

Страницы, которые подгружают данные в фоне, например дашборды, перестают работать, пока человек не обновит
страницу. Ставьте условие на пути администратора, а не на всё приложение.

Кто настроил приложение-аутентификатор, при повторном входе вводит и код.

Человека, который входит через внешний сервис, попросят войти там снова. Насколько свежий тот вход, решает сервис.

С кодом из приложения-аутентификатораЗаголовок раздела «С кодом из приложения-аутентификатора»

Отметьте with a code from an authenticator app под условием. Тогда путь откроет только вход, в котором человек ввёл
код и который не старше выбранного времени, самое большее суток. Правило читается как «signed in with a code within
15 min».

Перед сохранением консоль показывает, у скольких людей, которым открыт путь, нет приложения-аутентификатора и сколько
входят только через провайдера. Вы подтверждаете с этими числами. Включить это может только тот, кто управляет
людьми проекта.

Человек с кодом входит снова с паролем и кодом, даже если уже вводил код в тот же день.

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

Человеку, который входит через провайдера, объясняют, что так эту страницу не открыть.

Если вернуться, не войдя, откроется страница о том, что этой странице нужен код. Тот же вход она заново не начинает.

В Check access консоли есть отметка, входил ли человек с кодом.

Группы и атрибуты для APIЗаголовок раздела «Группы и атрибуты для API»

Откройте страницу API и её вкладку Access. Первый раздел, Who can call it, содержит условия API. Они действуют до таблицы
инструментов.

Условию о человеке нужен токен, за которым стоит человек. Эти токены таким не являются, и им отказывают:

токен, который приложение получило для себя, без человека;

токен приложения, которое даёт людям разные идентификаторы в каждом приложении (pairwise);

самодостаточный токен, выданный до этого выпуска: в нём не сказано, когда человек вошёл.

При сохранении консоль называет приложения, токенам которых будут отказывать. Заблокированному или отключённому
человеку отказывают сразу. Человеку, которого исключили из группы, отказывают в течение минуты.

У одного инструмента MCP-сервера могут быть свои условия: группы, From where и When. Они добавляются к условиям
API и никогда их не заменяют. Вызову, который им не отвечает, отказывают, а не просят войти снова. Подробнее в разделе
Условия на один инструмент. Там же сказано,
от чего такое условие не защищает.

Проверьте перед сохранениемЗаголовок раздела «Проверьте перед сохранением»

Check access на вкладке Access приложения принимает адрес в приложении, человека, сетевой адрес, момент и время с
момента входа. Он показывает все условия в том порядке, в котором их проверяет проект, с отметками ✓, ✗ или ?. Поле,
которое вы не заполнили, даёт «?». У API на вкладке Access есть своя карточка Check access: смотрите раздел
Check access.

Изменение, которое пускает больше людей, сначала спрашивает подтверждение и перечисляет, что ослабляется, путь за
путём. Изменение, которое только сужает доступ, сохраняется сразу. Сама консоль FoxAuth никогда не стоит за этими
условиями, поэтому правило не может запереть вас вне её.

Обновление и откатЗаголовок раздела «Обновление и откат»

Первый выпуск с условиями помечает базу так, что более старый выпуск отказывается с ней запускаться. Старый выпуск не
смог бы соблюдать условия, поэтому работать он не должен. Первый выпуск с кодом у прокси помечает базу ещё раз по той
же причине, и первый выпуск со сведениями о сети тоже. Откатиться ниже этого выпуска нельзя. Во время поэтапного
обновления старый процесс, который ещё работает, отвечает ошибкой для приложения или API с условиями, пока его не
заменят. Запрос он не пропускает никогда.

ПредыдущаяЗащита MCP-сервера на вашем проксиСледующаяОтказ адресам, которые подбирают пароли
