Перейти к содержимому

Условия на вашем прокси

Приложение за прокси решает, кто может открыть каждый путь. 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 и всё под ним, вместе с условиями /. Путь может добавить условие. Убрать условие пути выше он не может. У публичных путей условий нет.

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

  1. From where и When, до входа. Человеку не из того места или не в те часы отказывают, не спрашивая пароль.
  2. Вошёл ли человек, может ли он входить и состоит ли в группах правила.
  3. Attribute.
  4. Ask to sign in again, последним. Никого не отправляют входить, чтобы потом всё равно отказать.

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

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

  1. На странице Connect приложения или API откройте шаг Your proxy passes people’s addresses и нажмите Issue a proxy key. Скопируйте ключ: он показывается один раз. У проекта не больше двух ключей, поэтому один можно заменить другим без момента, когда прокси получает отказ.
  2. Добавьте в прокси строки из конфигурации на этой странице. Они перезаписывают X-Forwarded-For адресом, с которого пришло соединение, и добавляют ключ. Для Caddy задайте FOXAUTH_PROXY_KEY в окружении, где работает Caddy. Для nginx вставьте ключ туда, где в конфигурации написано <FOXAUTH_PROXY_KEY>.
  3. Запустите проверку со страницы. Она отправляет через прокси поддельный адрес. Шаг не должен стать красным.

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

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 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 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"
  • Ровно одному адресу, записанному обычным образом. Два адреса, порт, скобки или необычная запись делают адрес неизвестным.
  • Неизвестный адрес не проходит ни одно условие по сети: ни «только из», ни «не из».
  • Частный адрес, например балансировщика или сети контейнеров, для «не из» считается неизвестным. Страница 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, дата-центр или страна. Это необязательная вторая часть From where, на пути приложения и у API. Как и списку диапазонов, им нужны ключ прокси и адрес из шагов выше.

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

  1. Суперадминистратор открывает Settings → Integrations и включает Network facts from FoxTrust. По умолчанию это выключено. Это бесплатно на любом тарифе.
  2. После этого каждый процесс сервера раз в сутки скачивает полный файл примерно на 13 МБ, а каждый час обновление к нему. Новый файл он ищет каждые 5 минут. Файл используется только после проверки его размера, контрольной суммы и подписи FoxTrust.
  3. Карточка под настройкой показывает, когда собран снимок, его возраст, сколько в нём диапазонов адресов и последнюю ошибку, если она была.

Для условия адреса людей никогда не отправляются ни в 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.

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

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

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

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

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

  • Страницы, которые подгружают данные в фоне, например дашборды, перестают работать, пока человек не обновит страницу. Ставьте условие на пути администратора, а не на всё приложение.
  • Кто настроил приложение-аутентификатор, при повторном входе вводит и код.
  • Человека, который входит через внешний сервис, попросят войти там снова. Насколько свежий тот вход, решает сервис.

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

  • Перед сохранением консоль показывает, у скольких людей, которым открыт путь, нет приложения-аутентификатора и сколько входят только через провайдера. Вы подтверждаете с этими числами. Включить это может только тот, кто управляет людьми проекта.
  • Человек с кодом входит снова с паролем и кодом, даже если уже вводил код в тот же день.
  • Человек без кода видит страницу с адресом вашего приложения. Если проект разрешает настроить код самому, человек настраивает его там же и попадает на открытую страницу в том же входе. Иначе страница просит обратиться к вам.
  • Человеку, который входит через провайдера, объясняют, что так эту страницу не открыть.
  • Если вернуться, не войдя, откроется страница о том, что этой странице нужен код. Тот же вход она заново не начинает.
  • В Check access консоли есть отметка, входил ли человек с кодом.

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

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

  • токен, который приложение получило для себя, без человека;
  • токен приложения, которое даёт людям разные идентификаторы в каждом приложении (pairwise);
  • самодостаточный токен, выданный до этого выпуска: в нём не сказано, когда человек вошёл.

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

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

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

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

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