---
title: "Что вам нужно? | FoxAuth"
description: "Ответьте на два вопроса и узнайте, какая схема входа вам подходит: что происходит на каждом шаге, что видит человек и какая кнопка всё настроит."
canonical: "https://foxauth.dev/ru/guide/"
lastmod: "2026-11-17T15:02:32+03:00"
---
Что вам нужно?
Два вопроса, одна картинка и одна кнопка, которая всё настроит.Раздел руководства
Ваш продуктвход для людей и агентовДля компанийкогда вы продаёте компаниям

1Кто действует?
Человеквходит в ваше приложениеПрограмма без человекасервис, задача по расписанию, ваш APIИИ-агентClaude, Cursor, ChatGPT или ваш собственный2Где работает ваш код?
Готово в CloudНа сервереNext.js, Django, Rails, LaravelГотово в CloudВ браузереReact, Vue, Angular, без сервераГотово в CloudНа телефоне, компьютере или в терминалеiOS, Android, Electron, CLIГотово в CloudНа устройстве без клавиатурытелевизор, приставка, киоскГотово в CloudЗа обратным проксив самом приложении нет входа2Что вы создаёте?
Готово в CloudПрограмму, которая вызывает APIфоновая задача, cron, другой сервисГотово в CloudAPI, который нужно защититьвызывать его могут только ваши приложенияСвой серверПлатформу для других разработчиковони сами регистрируют свои приложения2Что нужно агенту?
Готово в CloudПодключиться к моему MCP-серверупосле входа человека, без регистрацииГотово в CloudРаботать с Google, GitHub… человекаот его имени и с его согласияГотово в CloudУправлять самим FoxAuthчерез административный MCPГотово в CloudПодключиться к моему MCP-серверу через мой прокситокены проверяет прокси, сервер остаётся как есть
Агент работает на компьютере человека и входит от его имени? Тогда это тот же случай, что и приложение на компьютере или в терминале.

Другие частые задачи
Это не схемы входа, но часто именно они нужны следующими.
Вход через Google, GitHub, Apple или MicrosoftГотово в Cloud
Пускать только из офисной сетиГотово в Cloud
Закрыть путь для Tor, VPN и других странГотово в Cloud
Понять, почему человека не пускаетГотово в Cloud
Найти тех, кто больше не пользуется приложениемГотово в Cloud
Просить войти заново перед страницами администратораГотово в Cloud
Люди создают аккаунт сами или приходят по приглашениюГотово в Cloud
Второй фактор при входеГотово в Cloud
Пусть люди сами включают двухэтапную проверкуГотово в Cloud
Спрашивать код только в тех приложениях, которым он нуженГотово в Cloud
Спрашивать код при подключении к MCP-серверу или APIГотово в Cloud
Разрешить один инструмент MCP только некоторым людямГотово в Cloud
Остановить подбор паролей с известных адресовГотово в Cloud
Вход на вашем собственном адресеГотово в Cloud
Выход из одного приложения и сразу из всехГотово в Cloud
Вход в стиле вашего продуктаГотово в Cloud
Люди видят и удаляют приложения, у которых есть доступ к их аккаунтуГотово в Cloud
Люди видят свои входы и выходят вездеГотово в Cloud
Украденный токен бесполезенГотово в Cloud
Здесь показана задача, которую вы выбрали. Снова показать ответ на два вопроса

Если вы продаёте компаниям: что попросит их ИТ-отдел
Обычному приложению ничего из этого не нужно. Выберите, что просит компания.

Компания вашего клиента
СотрудникиOkta или Entra IDКаталог компании&rarr;Ваше приложение с FoxAuthЧто просит компания?
Первыми идут корпоративный вход и SCIM. Обычно их просят вместе.
Корпоративный входОбычно вместеГотово в CloudЛюди появляются и уходят самиОбычно вместеСвой серверОтдел и роль в токенеГотово в CloudЧеловек ушёл: доступ закрыт вездеГотово в CloudАгенты компании без экрана согласияСвой серверЧеловек одобряет одно конкретное действиеСвой серверПодтверждение на телефонеСвой серверСамый строгий профильСвой серверКоманды и журнал аудитаГотово в CloudИнструмент только для ваших администраторовСвой серверВаши администраторы входят в консоль через корпоративный SSOСвой сервер

Выберите ответ на второй вопрос, и он появится здесь.

ЧеловекГотово в FoxAuth Cloud
Сайт со своим сервером

1Ваша проблема

ЧеловекВаш сервер
Ваш сервер хранит пароли всех людей.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаш сервер
Пароль видит только FoxAuth.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth
Пароль или кнопка провайдера
Затем возврат на ваш сайт, уже после входа
Ваш сервер хранит секрет и обменивает одноразовый код на токены. Поэтому такой вход самый простой и самый безопасный.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваш сервер
FoxAuth

1Нажимает «Войти»

2На страницу входа

3Входит

4Одноразовый код

5Код + секрет

6Вход выполнен
FoxAuth
Сообщение
Браузер переходит дальше
Передаёт токен
1Человек нажимает «Войти» на вашем сайте.
2Ваш сервер отправляет браузер на страницу входа FoxAuth.
3Человек вводит пароль или входит через Google. Пароль видит только FoxAuth.
4FoxAuth возвращает человека на ваш адрес возврата с одноразовым кодом.
5Ваш сервер обменивает код на токены и предъявляет свой секрет. Браузер этого не видит.
6Ваш сервер открывает сессию, и человек вошёл.

Полезно знать
Обычный http разрешён только для localhost. Для любого другого адреса нужен https.
Храните секрет на сервере, в переменной окружения, и никогда не пишите его в коде.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-in through FoxAuth to my web app with a server (work out the stack from the code).
Flow: Authorization Code + PKCE, a confidential application (client_secret_basic), refresh tokens.
Callback: http://localhost:3000/callback. After sign-out: http://localhost:3000.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_create with applicationType web, grantTypes authorization_code and refresh_token, tokenEndpointAuthMethod client_secret_basic. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Keep the secret only on the server, in an environment variable.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · Authorization Code + PKCE · client_secret_basic · refresh-токены

ЧеловекГотово в FoxAuth Cloud
Одностраничное приложение в браузере

1Ваша проблема

ЧеловекПрило­жение в брау­зереВаш API
Секрет в коде для браузера виден всем.&rarr;
2С FoxAuth

FoxAuth
ЧеловекПрило­жение в брау­зереВаш API
Одноразовая проверка заменяет секрет.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth
Пароль или кнопка провайдера
Затем возврат в ваше приложение, уже после входа
Секрет здесь хранить негде, поэтому вход защищает PKCE. Это одноразовая проверочная строка, которую знает только эта вкладка браузера.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Прило­жение в брау­зере
FoxAuth
Ваш API

1Нажимает «Войти»

2Вход + PKCE

3Входит

4Одноразовый код

5Код + проверочная строка

6Вызов с токеном
FoxAuth
Сообщение
Браузер переходит дальше
Передаёт токен
1Человек нажимает «Войти» в вашем приложении.
2Приложение отправляет браузер на вход вместе с отпечатком проверочной строки.
3Человек входит на странице FoxAuth.
4FoxAuth возвращает человека в ваше приложение с одноразовым кодом.
5Приложение обменивает код на токены и предъявляет саму проверочную строку. Без неё украденный код бесполезен.
6Приложение вызывает ваш API с токеном доступа.

Полезно знать
Секрета нет, и это нормально: защиту берёт на себя PKCE.
В браузере refresh-токены живут меньше, чем на сервере.
Обычный http разрешён только для localhost.
Не храните токены в localStorage, если библиотека умеет держать их в памяти.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-in through FoxAuth to my single-page app (work out the framework from the code).
Flow: Authorization Code + PKCE, a public application with no secret, refresh tokens.
Callback: http://localhost:5173/callback. After sign-out: http://localhost:5173. Allowed origin (CORS): http://localhost:5173.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_create with applicationType web, tokenEndpointAuthMethod none, corsOrigins http://localhost:5173. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · Authorization Code + PKCE · публичное приложение · refresh-токены

ЧеловекГотово в FoxAuth Cloud
Приложение на телефоне, компьютере или в терминале

1Ваша проблема

ЧеловекВаше прило­жение
Приложение видит пароль человека.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаше прило­жение
Вход открывается в браузере, которому человек доверяет.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth в системном браузере
Затем сообщение от вашего приложения: «эту вкладку можно закрыть»
Вход открывается в системном браузере, а код возвращается в ваше приложение на локальный адрес, на любой порт.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth

1Начинает вход

2Открывает браузер

3Входит

4Код на 127.0.0.1

5Код + PKCE
FoxAuth
Сообщение
Браузер переходит дальше
Передаёт токен
1Человек нажимает «Войти» или запускает вашу команду входа.
2Приложение открывает страницу входа в системном браузере, с PKCE.
3Человек входит в браузере, которому доверяет.
4FoxAuth отправляет код на http://127.0.0.1, на тот порт, который приложение слушает прямо сейчас.
5Приложение обменивает код на токены.

Полезно знать
Один адрес возврата подходит для любого порта, поэтому регистрировать каждый запуск не нужно.
Секрета нет: приложение находится в руках человека, и его можно разобрать.
ИИ-агент, который работает на компьютере человека и входит от его имени, настраивается точно так же.
Не используйте для входа встроенный WebView.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-in through FoxAuth to my native app (mobile, desktop or CLI: work it out from the code).
Flow: Authorization Code + PKCE, a public application with no secret, sign-in in the system browser.
Callback: http://127.0.0.1/callback, on a free port chosen at each run.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_create with applicationType native, tokenEndpointAuthMethod none, redirectUris http://127.0.0.1/callback. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · Authorization Code + PKCE · возврат на loopback-адрес (RFC 8252)

ЧеловекГотово в FoxAuth Cloud
Телевизор или устройство без клавиатуры

1Ваша проблема

ТВ или устройство
Пароль приходится вводить пультом от телевизора.&rarr;
2С FoxAuth

FoxAuth
ТВ или устройствоТелефон человека
Короткий код подтверждается на телефоне.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

Введите код с экрана
WDJB-MJHT
Далее
На устройстве: короткий код и адрес
На телефоне: поле для кода, затем обычный вход
Устройство показывает короткий код, а человек входит на своём телефоне.

На своём сервере включите в разделе Settings: deviceFlow.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

ТВ или устройство
FoxAuth
Телефон человека

1Просит код

2Код WDJB-MJHT

3Вводит код, входит

4Уже готово?

5Токены
FoxAuth
Сообщение
Передаёт токен
1Устройство просит у FoxAuth код для входа.
2FoxAuth возвращает короткий код и адрес. Устройство показывает и то и другое.
3Человек открывает адрес на телефоне, вводит код и входит как обычно.
4Тем временем устройство каждые несколько секунд спрашивает, подтверждён ли код.
5Как только человек вошёл, устройство получает свои токены.

Полезно знать
Человеку нужен второй экран: телефон или компьютер.
Код короткий и быстро истекает. Хранить ничего не нужно.
Соблюдайте интервал опроса и обрабатывайте slow_down.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-in through FoxAuth to my app on a device with no keyboard.
Flow: Device Authorization Grant (RFC 8628), a public application with no secret.
Show the code and the address from the response on screen, then poll /token at the interval the response gives.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_create with applicationType native, grantTypes urn:ietf:params:oauth:grant-type:device_code, tokenEndpointAuthMethod none. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OAuth 2.0 Device Authorization Grant (RFC 8628)

ПрограммаГотово в FoxAuth Cloud
Программа вызывает ваш API без участия человека

1Ваша проблема

Ваша программаВаш API
Один общий ключ, у которого нет срока действия.&rarr;
2С FoxAuth

FoxAuth
Ваша программаВаш API
Короткоживущие токены заменяют общий ключ.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Экрана никто не видит: человек не входит
Программа входит сама, со своим ID и секретом, и получает токен на своё имя.

На своём сервере включите в разделе Settings: clientCredentials.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Ваша программа
FoxAuth
Ваш API

1ID + секрет

2Токен для API

3Вызов с токеном

4Проверяет подпись
FoxAuth
Сообщение
Передаёт токен
Внутри одного блока
1Программа предъявляет свой ID и секрет.
2FoxAuth выдаёт токен доступа.
3Программа вызывает ваш API с этим токеном.
4Ваш API проверяет подпись токена по открытым ключам проекта. Обращаться к FoxAuth при каждом запросе ему не нужно.

Полезно знать
Токен действует от имени программы. Человека в нём нет.
Если секрет утёк, выпустите новый в консоли.
Кешируйте токен, пока он не истечёт. Не запрашивайте новый при каждом вызове.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Set up calls to my API from a background service through FoxAuth.
Flow: Client Credentials, a confidential application (client_secret_basic), no person involved.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_create with grantTypes client_credentials, tokenEndpointAuthMethod client_secret_basic. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OAuth 2.1 · Client Credentials

ПрограммаГотово в FoxAuth Cloud
Ваш API принимает только ваши приложения

1Ваша проблема

Ваше прило­жениеВаш APIДругой API
Ваш API принимает любой токен.&rarr;
2С FoxAuth

×FoxAuth
Ваше прило­жениеВаш APIДругой API
Ваш API принимает только свои токены.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Экрана никто не видит: это общение между программами
Объявите API в своём проекте, и FoxAuth впишет его в каждый токен как получателя. Токен, выданный для другого API, будет отклонён.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Ваше прило­жение
FoxAuth
Ваш API
Другой API

1Токен для вашего API

2Получатель: ваш API

3Принят

4Отклонён
FoxAuth
Вне вашего контроля
Сообщение
Передаёт токен
Отказ
1Приложение запрашивает токен и называет API, для которого он нужен.
2FoxAuth выдаёт токен, в котором записан получатель.
3Ваш API видит себя в получателях и принимает вызов.
4Тот же токен не пройдёт в другом API: получатель не совпадает.

Полезно знать
Адрес API уникален в пределах проекта.
Приложение называет API, когда запрашивает токен.
Ваш API может спросить у FoxAuth, действует ли ещё токен, а приложение может отозвать ненужный ему токен. Для этого суперадминистратор должен включить интроспекцию и отзыв.
Отклоняйте токен с другим получателем (aud), даже если его подпись верна.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Protect my API with FoxAuth tokens.
The API is declared as the resource https://api.example.com.
In the API, check the token signature against the project’s jwks_uri, the issuer (iss) and the recipient (aud = https://api.example.com). Apps must send resource=https://api.example.com when they ask for a token.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use resource_declare with the address https://api.example.com. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OAuth 2.0 Resource Indicators (RFC 8707) · токены с привязкой к аудитории · интроспекция (RFC 7662) · отзыв (RFC 7009)

ПрограммаНа своём сервере
Другие разработчики сами регистрируют приложения на вашей платформе

1Ваша проблема

Стороннее прило­жение
Вы сами выдаёте ключ каждому разработчику.&rarr;
2С FoxAuth

FoxAuth
Стороннее прило­жениеЧеловек
Разработчики сами регистрируют свои приложения.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

auth.acme-notes.app

AAcme Notes
Приложение запрашивает доступ
Оно сможет действовать от вашего имени.

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

Включите в разделе Settings: registration.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Стороннее прило­жение
FoxAuth
Человек

1Регистрируется

2ID + токен управления

3Входит в него

4Изменяет или удаляет
FoxAuth
Вне вашего контроля
Сообщение
Передаёт токен
1Приложение разработчика отправляет свои данные на адрес регистрации.
2FoxAuth сохраняет его как приложение и возвращает его ID и токен управления.
3Люди входят в это приложение, как в любое другое. Экран согласия сообщает, что приложение зарегистрировалось само.
4Позже приложение изменяет или удаляет свою регистрацию с помощью токена управления.

Полезно знать
Это настройка всего сервера. Её включает суперадминистратор.
Для клиентов MCP лучше подходит адрес описания (metadata URL): спецификация MCP объявила для них саморегистрацию устаревшей.
Если выключить регистрацию, новые регистрации прекратятся. Уже зарегистрированные приложения продолжат работать.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Explain how an outside developer registers an app at my FoxAuth project’s registration_endpoint (from discovery), and how they update it with the registration access token.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
Ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Dynamic Client Registration (RFC 7591) · Registration Management (RFC 7592)

ИИ-агентГотово в FoxAuth Cloud
Claude, Cursor или ChatGPT подключаются к вашему MCP-серверу

1Ваша проблема

ИИ-агентВаш MCP-сервер
Ваш MCP-сервер открыт для всех.&rarr;
2С FoxAuth

FoxAuth
ЧеловекИИ-агентВаш MCP-сервер
Токен работает только на вашем сервере.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Claudeпросит разрешения действовать от вашего имени
Читать ваши заметки
Добавлять новые заметки

Не разрешать
Разрешить
Страница входа, затем экран согласия
На нём названы агент и ваш MCP-сервер
Человек разрешает доступ или отказывает
Объявите свой MCP-сервер в проекте, и агент подключится после входа человека, без регистрации. Агент представляется адресом собственного описания.

На своём сервере включите в разделе Settings одну из настроек: clientIdMetadataDocument.enabled или registration.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
ИИ-агент
Ваш MCP-сервер
FoxAuth

1Подключается

2401: войдите в FoxAuth

3Представляется

4Входит, разрешает

5Токен для вашего сервера

6Вызывает инструменты
FoxAuth
Сообщение
Передаёт токен
Отказ
1Агент пытается подключиться к вашему серверу.
2Ваш сервер отвечает, что нужен вход, и называет FoxAuth.
3Агент сообщает адрес своего описания (metadata URL). Заранее он ничего не регистрирует.
4Человек входит и видит, какой агент запрашивает доступ.
5FoxAuth выдаёт токен, который работает только для вашего сервера.
6Агент работает с вашим сервером от имени человека.

Полезно знать
Токен привязан к вашему серверу. На чужом MCP-сервере он не работает.
Ваш сервер сам проверяет токен по открытым ключам проекта.
Агенты представляются адресом описания, только пока суперадминистратор держит эту возможность включённой в настройках сервера. Агенту, который не может разместить описание, вместо этого нужна включённая регистрация.
Не встраивайте регистрацию клиентов в свой MCP-сервер.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add authorization through FoxAuth to my MCP server.
The server is declared as the resource https://mcp.example.com.
Serve /.well-known/oauth-protected-resource with authorization_servers set to the project’s issuer. Answer a request with no token with 401, WWW-Authenticate and resource_metadata.
Check the signature, iss, and aud = https://mcp.example.com.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use resource_declare with the address https://mcp.example.com. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: MCP Authorization · OAuth 2.1 · Protected Resource Metadata · Client ID Metadata Document

ИИ-агентГотово в FoxAuth Cloud
Ваш агент работает в Google, GitHub или Slack человека

1Ваша проблема

ИИ-агентGoogle, GitHub, Slack
Агент хранит ключи от Google-аккаунта человека.&rarr;
2С FoxAuth

ЧеловекИИ-агентFoxAuthGoogle, GitHub, Slack
Токены хранит FoxAuth, а не агент.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
GoogleПодключите свой аккаунт
Тогда ваш агент сможет пользоваться им от вашего имени через FoxAuth.

Отмена
Подключить
Страница, на которой назван сервис, например Google
Человек подключает аккаунт и даёт согласие
Позже: список подключённых аккаунтов
Человек один раз подключает свой аккаунт. После этого агент получает доступ через FoxAuth и сам ничьих токенов не хранит.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
ИИ-агент
FoxAuth
Google, GitHub, Slack

1Подключает Google

2Доступ

3Обменивает токен

4Токен Google

5Действует
FoxAuth
Вне вашего контроля
Сообщение
Передаёт токен
1Человек один раз подключает свой аккаунт и даёт согласие.
2Google выдаёт доступ. FoxAuth хранит его в зашифрованном виде.
3Агент предъявляет свой токен и просит доступ к Google этого человека.
4FoxAuth выдаёт токен Google только для этого человека.
5Агент читает почту, создаёт задачу или пишет в канал от имени человека.

Полезно знать
Вам понадобится своё приложение в этом сервисе: его ID и секрет.
Человек видит свои подключённые аккаунты и может отключить любой из них. Агент сразу теряет доступ.
Агент получает токен только для того человека, который подключил аккаунт.
Не храните токен Google дольше одного запроса.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Teach my agent to act in Google for the signed-in person through FoxAuth.
Google is added to the project as a connected service.
The agent gets a Google token by exchanging its own token at /token (grant_type urn:ietf:params:oauth:grant-type:token-exchange). If the account is not connected yet, show the person the connect link.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use connected_service_create for Google. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OAuth 2.0 Token Exchange (RFC 8693) · хранилище токенов

ИИ-агентГотово в FoxAuth Cloud
Управляйте FoxAuth через ИИ-агента

1Ваша проблема

ВыИИ-агент
Агент получает ключ со всеми правами.&rarr;
2С FoxAuth

FoxAuth
ВыИИ-агент
Агент действует только с вашими правами.&rarr;

3Что вы получите
Открыть инструменты MCP&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.foxauth.dev

Администрирование FoxAuth
Claudeпросит действовать от вашего имени
Видеть ваши проекты и приложения
Создавать и менять приложения

Не разрешать
Разрешить
Страница входа администратора
Страница, на которой назван агент, который хочет действовать от вашего имени
Агент делает в FoxAuth то же, что вы делаете в консоли: с теми же правами, с теми же проверками и без особого входа.

На своём сервере включите в разделе Settings: mcp.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Вы
ИИ-агент
FoxAuth

1«Создай приложение»

2Вход администратора

3client_create

4Те же проверки

5Запись в журнал

6Результат
FoxAuth
Сообщение
Внутри одного блока
1Вы просите агента обычными словами.
2Агент подключается к /mcp. Вы входите и разрешаете ему действовать.
3Агент вызывает инструмент. Это тот же инструмент, что стоит за кнопкой в консоли.
4Права, проверки и лимиты тарифа здесь те же, что в консоли.
5Журнал аудита записывает, кто дал разрешение и какой агент выполнил действие.
6Агент получает ответ и рассказывает вам, что сделано.

Полезно знать
Агент действует ровно с вашими правами.
Самые опасные действия, например удаление проекта, доступны только в консоли.
Эта возможность выключена, пока суперадминистратор не включит её в настройках сервера. В FoxAuth Cloud она включена.
Агент подключается через собственный MCP-клиент FoxAuth или как приложение, которое разрешил суперадминистратор; приложение, зарегистрировавшее себя само, не подключится никогда.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Connect to the FoxAuth administrative MCP of the server whose console is at https://auth.foxauth.dev/admin. The address is the /mcp path of that server, and sign-in goes through OAuth.
After signing in, call whoami and tell me which projects I can reach.
Before any high-risk action, ask me again.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: MCP · защищённый ресурс OAuth 2.1

ЧеловекГотово в FoxAuth Cloud
Вход через Google, GitHub, Apple или Microsoft

1Ваша проблема

ЧеловекВаше прило­жение
Людям приходится придумывать ещё один пароль.&rarr;
2С FoxAuth

ЧеловекВаше прило­жениеFoxAuthGoogle
Вход одной кнопкой, с аккаунтом, который уже есть.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
На странице входа есть кнопка для каждого провайдера
Кнопка «Войти через Google»
Затем страница самого Google и возврат
Человек входит с аккаунтом, который у него уже есть. Ваше приложение не меняется, потому что по-прежнему общается только с FoxAuth.

На своём сервере включите в разделе Settings: federation.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth
Google

1Нажимает «Войти»

2На страницу входа

3Войти через Google

4Запрос в Google

5Это anna@gmail.com

6Токены, как обычно
FoxAuth
Вне вашего контроля
Сообщение
Браузер переходит дальше
Передаёт токен
1Человек нажимает «Войти» в вашем приложении.
2Приложение, как и раньше, отправляет человека в FoxAuth.
3Человек выбирает «Войти через Google».
4FoxAuth отправляет человека в Google.
5Google подтверждает, кто это.
6Приложение получает те же токены, что и после входа по паролю.

Полезно знать
Все четыре провайдера доступны на тарифе Free.
Вам понадобятся ID и секрет из консоли провайдера.
Microsoft на тарифе Free принимает аккаунты любой организации. Как ограничить вход каталогом одной компании, рассказано в разделе для компаний.
Менять ваше приложение не нужно.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-in through Google to my FoxAuth project.
Tell me where in Google Cloud Console to create the OAuth client and which callback address to give it, then connect it in FoxAuth.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use federation_provider_create for Google. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · федерация

ЧеловекГотово в FoxAuth Cloud
Веб-приложение без собственного входа

1Ваша проблема

Браузер человекаВаш проксиВаше прило­жение
Войти может любой, кто знает адрес.&rarr;
2С FoxAuth

FoxAuth
Браузер человекаВаш проксиВаше прило­жение
Прокси пропускает только тех, кого вы выбрали.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа проекта, в первый раз
Потом ваше приложение, как раньше
Тот, кому нельзя, видит страницу с отказом
Поставьте приложение за свой прокси. Прокси спрашивает FoxAuth о каждом запросе, прежде чем пропустить его к приложению. Люди входят в ваш проект, а приложение менять не нужно.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Браузер человека
Ваш прокси
Ваше прило­жение
FoxAuth

1Открывает приложение

2Спрашивает проект

3Отправляет на вход

4Входит

5Обратно на /_foxauth/callback

6Да, это Анна

7С заголовками X-Auth-*
FoxAuth
Ваш обратный прокси
Сообщение
Браузер переходит дальше
1Человек открывает ваше приложение. Запрос сначала попадает на ваш прокси.
2Прокси спрашивает проект, можно ли пропустить этот запрос. Приложение его пока не видит.
3Человек ещё не вошёл, поэтому проект отправляет браузер на свою страницу входа.
4Человек входит в проект. Если он уже вошёл раньше, этот шаг проходит сам.
5Проект возвращает браузер на /_foxauth/callback по адресу вашего приложения. Там браузер получает cookie входа в приложение.
6При следующем запросе проект проверяет ваши правила для этого пути и отвечает «да». В ответе сказано, кто этот человек.
7Прокси пропускает запрос к приложению. Идентификатор человека, его email и группы приходят в заголовках X-Auth-*.

Полезно знать
Приложение должно быть доступно только через ваш прокси. Запрос, который дошёл до него в обход прокси, никто не проверяет.
Приложение менять не нужно. Кто перед ним, оно узнаёт из заголовков X-Auth-*.
На шаге Connect есть готовая конфигурация для Caddy, Traefik или nginx.
Каждый путь можно открыть участникам выбранных групп, всем в проекте, всем подряд или никому, а также добавить условия: сеть, часы, атрибут, недавний вход.
Включать ничего не нужно. Это доступно на любом тарифе.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Put sign-in in front of my web app at https://app.example.com, behind my reverse proxy (work out Caddy, Traefik or nginx from my configuration). Only members of the group I name may open it.
Create the app behind the proxy in FoxAuth, then add the configuration it gives to my proxy.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use behind_proxy_app_create. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Make sure the app is reachable only through the proxy, so nobody can reach it without the check.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · OpenID Connect · Authorization Code + PKCE

ИИ-агентГотово в FoxAuth Cloud
Защита MCP-сервера без кода авторизации

1Ваша проблема

ИИ-агентВаш проксиВаш MCP-сервер
MCP-сервер открыт, пока вы не напишете код авторизации.&rarr;
2С FoxAuth

FoxAuth
ЧеловекИИ-агентВаш проксиВаш MCP-сервер
Прокси проверяет каждый токен и каждый инструмент.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Claudeпросит разрешения действовать от вашего имени
Читать ваши заметки
Добавлять новые заметки

Не разрешать
Разрешить
Страница входа, затем экран согласия
На нём названы агент и ваш MCP-сервер
Человек разрешает доступ или отказывает
Поставьте MCP-сервер за свой прокси. О каждом запросе прокси просит FoxAuth проверить токен и права (scope), которые нужны инструменту. Самому серверу код авторизации не нужен.

На своём сервере включите в разделе Settings одну из настроек: clientIdMetadataDocument.enabled или registration.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
ИИ-агент
Ваш прокси
Ваш MCP-сервер
FoxAuth

1Вызывает инструмент

2Спрашивает проект

3401: войдите в FoxAuth

4Входит, разрешает

5Токен для вашего сервера

6Вызывает с токеном

7Да, инструмент разрешён

8С заголовками X-Auth-*
FoxAuth
Ваш обратный прокси
Сообщение
Передаёт токен
Отказ
1Агент обращается к вашему MCP-серверу. Запрос сначала попадает на ваш прокси.
2Прокси просит проект проверить запрос. MCP-сервер его пока не видит.
3Токена ещё нет. Проект отвечает 401 и называет себя, а прокси передаёт этот ответ агенту.
4Человек входит и видит, какой агент запрашивает доступ.
5Проект выдаёт токен, который работает только для вашего MCP-сервера.
6Агент снова вызывает инструмент, теперь с токеном.
7Проект проверяет токен и права, которые нужны этому инструменту, и отвечает «да».
8Прокси передаёт запрос дальше. Кто вызывает и какие у него права, сервер узнаёт из заголовков X-Auth-*.

Полезно знать
Когда объявляете API, на вопрос «Who checks tokens?» ответьте «Your proxy». В разделе Connect этого API будет готовая конфигурация для Caddy, Traefik или nginx.
Вкладка Access на странице API задаёт, какие права нужны каждому инструменту и кто вообще может вызывать API: некоторые группы, атрибут, сеть, часы. У отдельного инструмента могут быть ещё свои группы, сеть или часы. Клиент, которому не хватает права, получает в ответе точный список прав, которые нужно запросить.
Описание, которое ищут агенты (protected resource metadata), публикует сам проект. Вашему MCP-серверу не нужно ничего отдавать для входа.
Отозванный токен работает на прокси, пока не истечёт его срок, если только API не выдаёт непрозрачные (opaque) токены. Делайте срок жизни коротким.
Токены, привязанные к ключу (DPoP или сертификат), прокси отклоняет: проверить ключ он не может.
MCP-сервер должен быть доступен только через ваш прокси. Без условий токен для него может получить любой, кто может войти в проект. Это доступно на любом тарифе.
Чтобы перед подключением агента спрашивать код из приложения-аутентификатора или время от времени просить войти снова, настройте это на вкладке Access страницы API.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Check tokens for my MCP server at https://mcp.example.com/mcp in my reverse proxy (work out Caddy, Traefik or nginx from my configuration), so the server needs no auth code.
Declare it in FoxAuth as an API whose tokens the proxy checks (checkedBy proxy), with its scopes. Then set its tools table: each tool and the scopes it needs. Add the configuration its Connect gives to my proxy.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use resource_declare with checkedBy proxy, then resource_update with tools. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Make sure the MCP server is reachable only through the proxy, so nobody can reach it without the check.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · MCP Authorization · OAuth 2.1 · Protected Resource Metadata (RFC 9728)

ЧеловекГотово в FoxAuth Cloud
Пускать только из офисной сети

1Ваша проблема

БраузерВаш проксиВаше приложение
Украденный пароль работает откуда угодно.&rarr;
2С FoxAuth

×FoxAuth
БраузерВаш проксиВаше приложение
Пускают только из вашей сети.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Из другого места: страница о том, что из этой сети приложение не открыть
Из офиса: приложение, как раньшеДальше:Закрыть путь для Tor, VPN и других стран&rarr;
Добавьте к пути приложения за прокси условие: только с перечисленных адресов. Человека из другого места не пустят ещё до входа.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Браузер
Ваш прокси
Ваше приложение
FoxAuth

1Открывает приложение

2Спрашивает, передаёт адрес

3Не из этой сети

4Открывает в офисе

5Да, это Анна

6С заголовками X-Auth-*
FoxAuth
Ваш обратный прокси
Сообщение
Отказ
1Человек открывает приложение из кафе. Запрос сначала попадает на ваш прокси.
2Прокси спрашивает проект и передаёт адрес, который увидел, вместе с ключом прокси проекта.
3Этого адреса нет в списке, поэтому проект отказывает ещё до входа.
4В офисе тот же запрос приходит с адреса из списка.
5Проект проверяет адрес и остальные правила и отвечает «да».
6Прокси пропускает запрос к вашему приложению.

Полезно знать
Прокси должен передавать адрес, который увидел, и показывать ключ прокси проекта. Страница Connect приложения даёт строки для конфигурации и проверку, что браузер не может подставить свой адрес.
Условие по сети нельзя сохранить, пока не пришла проверка с ключом и публичным адресом, поэтому одно сохранение не запрёт всех.
Условия складываются вниз по путям: условие на / действует на все пути под ним.
VPN или резидентный прокси всё равно могут обойти список. Это замедляет злоумышленника, но не останавливает.
Когда суперадминистратор включает сведения о сетях от FoxTrust, в «From where» можно также не пускать Tor, коммерческие VPN, хостинг и другие страны. Адресу, который подходит под условие, отказывают или просят войти снова. Как это настроить, показывает следующий ответ.
Консоль FoxAuth никогда не стоит за этими условиями. Это доступно на любом тарифе.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Let people open my app behind the proxy only from my office network, 203.0.113.0/24.
Issue the project’s proxy key in the console, add the lines the app’s Connect page gives to my proxy, then add a network condition to the rule for /.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use behind_proxy_app_update with rules[].conditions. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Issue the proxy key in the console: an agent never receives it.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · X-Forwarded-For

ЧеловекГотово в FoxAuth Cloud
Закрыть путь для Tor, VPN и других стран

1Ваша проблема

БраузерВаш проксиВаше приложение
Страницы администратора можно пробовать открыть через Tor.&rarr;
2С FoxAuth

×
БраузерВаш проксиВаше приложениеFoxAuthFoxTrust
Tor, VPN и другие страны не проходят.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Из Tor, VPN из списка, с хостинга или из другой страны: страница о том, что отсюда эту страницу не открыть
Или, если вы так выбрали: новый вход, с кодом, если вы его требуете
С обычного адреса в разрешённой стране: приложение, как раньше
Добавьте в «From where» на пути приложения за прокси сведения о сети: не из Tor, коммерческого VPN или хостинга и только из выбранных стран. Что это за адрес, сервер узнаёт из подписанного снимка FoxTrust, а для такого условия сам адрес никуда не отправляет.

На своём сервере включите в разделе Settings: networkFacts.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Браузер
Ваш прокси
Ваше приложение
FoxAuth
FoxTrust

1Подписанный снимок

2Открывает /admin через Tor

3Спрашивает, передаёт адрес

4Ищет адрес

5Отсюда нельзя

6Открывает из дома

7Да, это Анна

8С заголовками X-Auth-*
FoxAuth
Вне вашего контроля
Ваш обратный прокси
Сообщение
Отказ
Внутри одного блока
1Ваш сервер скачивает у FoxTrust снимок того, что известно об адресах в интернете: полный файл раз в сутки и обновление каждый час. Перед использованием он проверяет подпись.
2Кто-то открывает /admin вашего приложения через Tor. Запрос сначала попадает на ваш прокси.
3Прокси спрашивает проект и передаёт адрес, который увидел, вместе с ключом прокси проекта.
4Проект ищет адрес в собственной копии снимка на сервере. Для этой проверки адрес никуда не отправляется.
5В снимке адрес отмечен как выход сети Tor, поэтому проект отказывает ещё до входа.
6Дома, в разрешённой стране, тот же запрос приходит с обычного адреса.
7Адрес проходит. Проект проверяет остальные правила и отвечает «да».
8Прокси пропускает запрос к вашему приложению.

Полезно знать
Суперадминистратор включает «Network facts from FoxTrust» в Settings → Integrations. После этого каждый сервер раз в сутки скачивает файл примерно на 13 МБ, а каждый час обновление к нему.
Адреса людей ищутся только внутри вашего сервера. FoxTrust узнаёт лишь то, что файл скачали.
Коммерческий VPN означает только VPN-сервисы из списка FoxTrust, а не VPN вашей компании. Хостинг или облако включает и сети доставки контента, и выходы в интернет некоторых компаний из облака. iCloud Private Relay проходит.
Страны берутся из DB-IP (IP Geolocation by DB-IP, CC BY 4.0). Адрес с неизвестной страной не проходит «Only from» и проходит «Not from».
Подходящему адресу отказывают или просят войти снова, если вход старше выбранного числа минут, а при отметке ещё и с кодом из приложения-аутентификатора. API, который проверяется на прокси, может только отказать.
Если загрузка выключена или снимку больше 26 часов, путь закрыт, пока не загрузится свежий снимок, и консоль это отмечает. Check access показывает, что снимок знает об адресе.
Прокси должен передавать увиденный адрес вместе с ключом прокси проекта, как и для списка сетей. Это доступно на любом тарифе.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Keep Tor, commercial VPNs and hosting away from /admin of my app behind the proxy, and let people open the whole app only from Germany and Austria.
Check that network facts are current for the app. Then add a network condition with a facts part to the rule for /admin (categories tor, vpn and hosting) and one to the rule for / (countries: only DE and AT), each refusing a matching address.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use behind_proxy_app_get (addresses.networkFacts says whether they are current), then behind_proxy_app_update with a facts part on a network condition in rules[].conditions. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Network facts are an instance setting for a super administrator: networkFacts.enabled. To explain a refusal, look the address up with network_facts_lookup.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · Подписанный снимок сведений об IP-адресах (FoxTrust) · Данные о странах от DB-IP

ЧеловекГотово в FoxAuth Cloud
Понять, почему человека не пускает

1Ваша проблема

Администратор
Человека не пускает, и никто не видит почему.&rarr;
2С FoxAuth

×FoxAuth
ЧеловекАдминистратор
Каждый отказ сохраняется вместе с причиной.&rarr;

3Что вы получите
Открыть вкладку Users&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Та же страница отказа, что и раньше: для человека ничего не меняется
Откройте человека в Users: на вкладке Activity видны все его входы, все неудачные попытки и каждый отказ приложения за вашим прокси или API, с причиной и с тем, что человек увидел.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth
Администратор

1Открывает вики

2Отказ

3Открывает Activity человека

4Причина и что человек увидел
FoxAuth
Сообщение
Отказ
1Анна открывает вики, приложение за вашим прокси, и входит.
2Правила вики не пускают её на /admin. Она видит страницу, что открыть её нельзя.
3Анна пишет в поддержку. Поддержка находит её в Users и открывает вкладку Activity.
4На вкладке видно отказ в 10:14, три раза, «Not in the groups that may open /admin», и ссылку, чтобы проверить его по сегодняшним правилам.

Полезно знать
Хранится для каждого проекта: входы с приложением, способом входа, сетевым адресом, страной и типом сети от FoxTrust, если сведения о сети включены, и с браузером и системой.
Рядом с адресом видно владельца сети, регион и город. Их сервер узнаёт через API FoxTrust, пока в Settings → Integrations включена настройка «Look up network owner and location at FoxTrust». По умолчанию она включена. FoxTrust ни один из этих адресов не хранит.
Неудачные входы хранятся, только если аккаунт найден: неверный пароль или код, заблокированный или деактивированный аккаунт, нет кода или не подтверждён адрес.
У вашего прокси адрес человека хранится, только если прокси доказывает его ключом прокси проекта. У строк API адреса нет никогда.
Всё хранится 90 дней, переживает блокировку и удаляется вместе с человеком и проектом. Чтение записывается в журнал аудита.
Запись отстаёт не больше чем на минуту. Суперадминистратор может выключить её в Settings.
Когда вы сужаете правила приложения или API, на его вкладке Access видно, кому оно отказало за последние 24 часа. Время сохранения разделяет тех, кому отказали до и после.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Why was anna@acme.com refused by the Wiki app today?
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_user_list to find her, then project_user_activity_list with outcome refused; after a rule change, behind_proxy_app_refusal_list or resource_refusal_list. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Sign-in decisions · Forward auth decisions

ЧеловекГотово в FoxAuth Cloud
Найти тех, кто больше не пользуется приложением

1Ваша проблема

Администратор
Никто не знает, кто ещё пользуется приложением, прежде чем отнять доступ.&rarr;
2С FoxAuth

АдминистраторFoxAuth
Каждый день работы сохраняется, без адреса.&rarr;

3Что вы получите
Открыть вкладку Users&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Ничего: люди этого не видят
Отфильтруйте Users по Last active. Он учитывает вход, обновление токенов и каждый запрос, который пропустил ваш прокси. Поэтому человек, который работает в открытой сессии, никогда не считается неактивным.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Администратор
FoxAuth

1Фильтрует Users

2Неактивные люди

3Открывает человека
FoxAuth
Сообщение
1Перед квартальной чисткой Кай фильтрует Users по «Last active: Not in the last 90 days».
2В списке те, кто за 90 дней не входил, не обновлял токены и кого не пропускал ваш прокси. Того, кто каждый день открывает вики в старой сессии, в списке нет.
3Кай открывает одного из них. На вкладке Profile видны приложения и API, которыми человек пользовался за 90 дней, а на вкладке Activity видны все дни.

Полезно знать
Last active учитывает вход, обновление токенов и запрос, который пропустил ваш прокси, один раз в день.
Для каждого приложения, или для каждого API и приложения, за каждый день хранится одна запись: первое и последнее время. В записи API указаны инструменты из его таблицы, которые человек вызывал. Адреса нет никогда.
«Not in the last 90 days» считается по месячным отметкам. Месяц, который хотя бы частично попадает в 90 дней, считается активным, так что из-за округления никто не станет неактивным.
Использование записывается с опозданием до пяти минут, хранится 90 дней и удаляется вместе с человеком и проектом.
Месячные активные люди теперь включают тех, кого пропустил ваш прокси, поэтому лимит плана на них тоже их учитывает.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Who in the Acme project has not been active in the last 90 days, and what did they last use?
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_user_list with lastActive not90, then project_user_activity_list for one of them. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Activity marks · Forward auth decisions

ЧеловекГотово в FoxAuth Cloud
Просить войти заново перед страницами администратора

1Ваша проблема

БраузерВаш проксиВаше приложение
Вход со вчерашнего дня открывает админку.&rarr;
2С FoxAuth

FoxAuth
БраузерВаш проксиВаше приложение
Админка просит недавний вход.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа с пояснением, что приложение просит войти снова
Затем открытая страница
Добавьте к пути, например /admin, условие: просить войти снова, если вход старше допустимого. Вход со вчерашнего дня такой путь больше не откроет.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Браузер
Ваш прокси
Ваше приложение
FoxAuth

1Открывает /admin

2Спрашивает проект

3Войдите снова

4Входит

5Да, вход свежий

6С заголовками X-Auth-*
FoxAuth
Ваш обратный прокси
Сообщение
Браузер переходит дальше
1Человек вошёл утром и теперь открывает /admin.
2Прокси спрашивает проект о запросе.
3Вход старше, чем разрешает /admin, поэтому проект отправляет браузер войти снова и объясняет зачем.
4Человек входит снова; у кого есть приложение-аутентификатор, тот вводит и код.
5Снова на /admin вход недавний, и проект отвечает «да».
6Прокси пропускает запрос к странице администратора.

Полезно знать
Выберите 15 минут, час, 8 часов или сутки. Страницы, которые подгружают данные в фоне, например дашборды, перестают работать, пока человек не обновит страницу, поэтому ставьте условие на пути администратора.
Кто настроил приложение-аутентификатор, вводит код и при повторном входе, требует его проект или нет.
Отметьте «with a code from an authenticator app», и путь откроет только недавний вход с кодом. Перед сохранением вы увидите, скольких людей это не пустит; тем, у кого кода нет, предложат его настроить, если проект это разрешает.
Без кода человека, который входит через внешний сервис, попросят войти там снова; насколько свежий тот вход, решает сервис. С кодом такой человек путь не откроет.
Это доступно на любом тарифе.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Ask people to sign in again before /admin of my app behind the proxy, when their sign-in is more than 15 minutes old, and to type a code from an authenticator app.
Add a fresh sign-in condition with withCode to the rule for /admin, and tell me first how many people that affects.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use behind_proxy_app_update with rules[].conditions. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Use it on admin paths: a dashboard that loads data in the background stops until it is reloaded.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · OpenID Connect max_age

ЧеловекГотово в FoxAuth Cloud
Люди создают аккаунт сами или приходят по приглашению

1Ваша проблема

Человек
Каждый аккаунт создают вручную.&rarr;
2С FoxAuth

FoxAuth
ЧеловекПочта
Люди регистрируются сами или принимают приглашение.&rarr;

3Что вы получите
Открыть вкладку Sign-in&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Регистрация
Электронная почта
Пароль
Создать аккаунт
Уже есть аккаунт? Войти
Ссылка «Зарегистрироваться» на странице входа
Форма для адреса и пароля
Письмо со ссылкой для подтверждения
Включите регистрацию, и на странице входа появится ссылка «Зарегистрироваться». Или приглашайте людей сами со страницы Users.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth
Почта

1Регистрируется

2Письмо со ссылкой

3Открывает письмо

4Подтверждает

5Адрес проверен
FoxAuth
Вне вашего контроля
Сообщение
Внутри одного блока
1Человек нажимает «Зарегистрироваться» и вводит адрес.
2FoxAuth отправляет письмо для подтверждения.
3Человек открывает письмо.
4Он переходит по ссылке.
5Адрес отмечается как подтверждённый: ваше приложение получает email_verified = true.

Полезно знать
Для писем нужен настроенный почтовый сервер (SMTP).
Адрес отмечается как подтверждённый, только если человек действительно его подтвердил.
Забытый пароль сбрасывается по почте, если проект это разрешает. Тогда на странице входа появляется ссылка.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Turn on self sign-up in my FoxAuth project and check that SMTP is set up.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_update (sign-up) and smtp_settings_get. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
If SMTP is not set up, tell me instead of turning sign-up on.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · email_verified

ЧеловекГотово в FoxAuth Cloud
Второй фактор при входе

1Ваша проблема

Человек
Чтобы войти, хватает украденного пароля.&rarr;
2С FoxAuth

FoxAuth
ЧеловекАутенти­фикатор
Нужен ещё и код с телефона.&rarr;

3Что вы получите
Открыть вкладку Sign-in&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница с паролем
Затем страница, которая просит шестизначный код
При первом входе: QR-код, который нужно отсканировать
После пароля человек вводит шестизначный код из приложения-аутентификатора. Один переключатель требует его от всех в проекте.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth
Аутенти­фикатор

1Пароль

2Нужен код

36 цифр

4Вводит код

5Вход выполнен
FoxAuth
Вне вашего контроля
Сообщение
Внутри одного блока
1Человек вводит пароль.
2FoxAuth просит код второго фактора.
3Приложение-аутентификатор показывает код, который меняется каждые 30 секунд.
4Человек вводит код.
5Вход завершён, и ваше приложение получает токены.

Полезно знать
Подойдёт любое приложение-аутентификатор.
Если человек потерял телефон, администратор удаляет приложение на странице этого пользователя.
И без переключателя люди могут включить его для себя сами, а приложение может потребовать его само.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Turn on the second factor (TOTP) in my FoxAuth project.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_update (second factor). Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Tell me how many users have not set it up yet.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: TOTP (RFC 6238)

ЧеловекГотово в FoxAuth Cloud
Пусть люди сами включают двухэтапную проверку

1Ваша проблема

Человек
Код есть только там, где его включили для всего проекта.&rarr;
2С FoxAuth

FoxAuth
ЧеловекПочтаАутенти­фикатор
Код может добавить любой, кто хочет.&rarr;

3Что вы получите
Открыть вкладку Sign-in&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница «Двухэтапная проверка» рядом с подключёнными приложениями
Письмо со ссылкой, затем QR-код
Потом страница с кодом при каждом входе по паролю
Каждый может добавить к своему аккаунту код из приложения-аутентификатора на странице своего аккаунта. После этого при каждом входе по паролю будет нужен и код.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth
Почта
Аутенти­фикатор

1Включает

2Ссылка

3Открывает

46 цифр

5Включено
FoxAuth
Вне вашего контроля
Сообщение
1На странице своего аккаунта человек выбирает двухэтапную проверку.
2FoxAuth присылает ему ссылку, которая работает только в этом браузере.
3Человек открывает ссылку и сканирует QR-код приложением.
4Приложение показывает код.
5Человек вводит код. Теперь его будут спрашивать при каждом входе по паролю.

Полезно знать
По умолчанию это включено. Нужны вход по паролю и почтовый сервер.
Если человек потерял телефон, администратор удаляет приложение на странице этого пользователя; для нового понадобится ссылка из письма.
При входе через Google или другого провайдера этот код не спрашивается, поэтому приложение, которое требует код, таких людей не пустит.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add a "Two-step verification" link to my app’s account settings that opens <your project's issuer, on its Overview>/account/security.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_update (totpSelfService). Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Tell me how many people have set one up.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: TOTP (RFC 6238)

ЧеловекГотово в FoxAuth Cloud
Спрашивать код только в тех приложениях, которым он нужен

1Ваша проблема

ЧеловекВаше прило­жение
Украденный пароль открывает и биллинг.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаше прило­жениеАутенти­фикатор
Биллинг принимает только вход с кодом.&rarr;

3Что вы получите
Открыть приложения&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Код из приложения-аутентификатора после пароля, один раз за вход
Если кода нет, страница, где его можно настроить и продолжить
При входе через провайдера человек узнаёт, что так в это приложение не войти
Одно приложение, например биллинг, никого не пускает без кода из приложения-аутентификатора. Остальные приложения проекта работают как раньше.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth
Аутенти­фикатор

1Открывает

2Вход

3Пароль и код

46 цифр

5Вход с кодом
FoxAuth
Вне вашего контроля
Сообщение
1Человек открывает приложение, и его отправляют войти.
2Приложение просит FoxAuth впустить человека.
3FoxAuth спрашивает пароль, а затем код из приложения. У кого его нет, может настроить его прямо там.
4Приложение показывает код.
5FoxAuth сообщает приложению, что при входе был введён код.

Полезно знать
Включается в настройках приложения, переключатель «Require a code from an authenticator app». Перед сохранением вы увидите, скольких людей это коснётся.
Код спрашивается один раз за вход, а не при каждом открытии приложения.
Токены обновления от входов без кода перестают работать, и люди входят заново, уже с кодом.
Те, кто входит через провайдера, так в приложение не попадут.
Для приложения за вашим прокси вместо этого отметьте «with a code from an authenticator app» у условия «Ask to sign in again» на нужном пути.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Make my billing application in FoxAuth require a code from an authenticator app, and tell me first how many people that affects.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_update (requireCode). Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Make my app show a helpful page when it receives unmet_authentication_requirements.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect acr

ИИ-агентГотово в FoxAuth Cloud
Спрашивать код при подключении к MCP-серверу или API

1Ваша проблема

ЧеловекВаш MCP-сервер
Украденный пароль подключает агента к вашему MCP-серверу.&rarr;
2С FoxAuth

FoxAuth
ЧеловекИИ-агентВаш MCP-сервер
Агента подключает только вход с кодом.&rarr;

3Что вы получите
Открыть список API&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Строка на странице входа, где назван ваш MCP-сервер
Код из приложения-аутентификатора после пароля
Если кода нет, страница, где его можно настроить и продолжить
Агент подключается к вашему MCP-серверу, только если человек, от имени которого он действует, вошёл с кодом из приложения-аутентификатора. Входить снова человеку придётся так часто, как вы выберете.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
ИИ-агент
FoxAuth
Ваш MCP-сервер

1Подключается

2Пароль и код

3Токен для вашего сервера

4Вызывает инструмент
FoxAuth
Сообщение
Передаёт токен
1Агент просит у FoxAuth токен для вашего MCP-сервера.
2FoxAuth спрашивает у человека пароль, а затем код из приложения-аутентификатора, что бы ни запросил агент.
3В токене сказано, что при входе был введён код.
4Ваш сервер или ваш прокси принимает только токен, при входе для которого был введён код.

Полезно знать
Включается на вкладке Access страницы API, переключатель «Require a code from an authenticator app». Настройка «Ask to sign in again every» просит людей подключаться заново не реже выбранного срока. Перед сохранением вы увидите, кого это коснётся.
Не каждое приложение само просит человека войти снова. В Claude Code человек заново подключает сервер в /mcp. В claude.ai появляется карточка Connect. ChatGPT и Codex могут только показать ошибку. Проверьте это в тех приложениях, которыми пользуются ваши люди.
Если после нового входа приложение не продолжает работу, человек просит его попробовать ещё раз.
Подключение, сделанное без кода, перестаёт работать при следующем продлении токена. Человек входит снова, уже с кодом.
Приложения, которые не действуют ни от чьего имени, и входы по утверждению (assertion) подключиться не могут. Люди, которые входят через провайдера, не могут ввести здесь код.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Make my MCP server in FoxAuth require a sign-in with a code from an authenticator app, and tell me first whom that affects.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use resource_update (requireCode, signInEveryMinutes). Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
If my MCP server checks its own tokens, make it refuse a token whose acr is not the multi-factor value FoxAuth names.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OAuth 2.0 Step Up Authentication Challenge (RFC 9470)

ИИ-агентГотово в FoxAuth Cloud
Разрешить один инструмент MCP только некоторым людям

1Ваша проблема

ИИ-агентВаш MCP-сервер
Кто может пользоваться вашим MCP-сервером, тот может вызвать любой инструмент.&rarr;
2С FoxAuth

×FoxAuth
ИИ-агентВаш проксиВаш MCP-сервер
Один инструмент отвечает только выбранным людям.&rarr;

3Что вы получите
Открыть список API&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Новой страницы никто не видит
Агент сообщает, что инструмент отказал
Один инструмент вашего MCP-сервера, например delete_files, смогут вызывать только выбранные группы, из выбранных сетей и в выбранные часы. Все остальные инструменты останутся открыты, как раньше.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

ИИ-агент
Ваш прокси
FoxAuth
Ваш MCP-сервер

1Вызывает delete_files

2Спрашивает проект

3403: не для этого инструмента

4Вызывает search_files
FoxAuth
Ваш обратный прокси
Сообщение
Отказ
1Агент вызывает один инструмент вашего MCP-сервера и называет его, как требует MCP 2026-07-28.
2Ваш прокси просит проект проверить токен и инструмент.
3Человек не входит в группы, которым можно вызывать delete_files, поэтому проект отказывает. Остальные инструменты у него работают.
4Тот же агент вызывает другой инструмент, и прокси пропускает запрос.

Полезно знать
Настраивается на вкладке Access страницы API: добавьте условия под инструментом. Они добавляются к условиям самого API и никогда их не заменяют.
Условие на инструмент останавливает приложение, которое честно называет вызываемый инструмент. Украденный токен в приложении, которое называет не тот инструмент, остановит только ваш MCP-сервер, если он сверяет заголовки с телом запроса. Серверы MCP 2026-07-28 обязаны это делать. Чтобы не пустить человека ко всему API, используйте условия самого API или требование входа.
Когда у инструмента есть условия, приложения, которые слишком стары, чтобы называть вызываемый инструмент, получают отказ. Сейчас таких приложений много. Какие именно, сказано в таблице клиентов на сайте.
Новый или переименованный инструмент на вашем сервере получает ответ «Any other tool», пока вы не добавите его в таблицу.
Check access внизу той же вкладки показывает, что ответит проверка для человека, инструмента, адреса и времени.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
In FoxAuth, let only the Ops group call the delete_files tool of my MCP server, which my proxy checks. Keep every other tool as it is, and refuse apps too old to say which tool they call.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use resource_update (tools: a row with conditions, withoutMethod refuse). Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Make sure my MCP server refuses a request whose Mcp-Method or Mcp-Name header differs from its body.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Forward auth · заголовки запроса MCP 2026-07-28

ЧеловекГотово в FoxAuth Cloud
Остановить подбор паролей с известных адресов

1Ваша проблема

Подбор­щик паролей
Один адрес перебирает тысячи паролей.&rarr;
2С FoxAuth

×
FoxTrustПодбор­щик паролейFoxAuthЧеловек
Известному подборщику три попытки, а не тысячи.&rarr;

3Что вы получите
Открыть вкладку Sign-in&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
С адреса из списка после трёх неверных паролей: «Вход по паролю из этой сети сейчас недоступен», что делать сейчас и строка, которую нужно отправить вам
С верным паролем с первой попытки: вход, как раньше
Другие способы входа остаются на странице
Используйте список FoxTrust: в нём адреса, с которых подбирали пароли. Адрес из списка может трижды ошибиться в пароле здесь, а потом его входы по паролю отклоняются.

На своём сервере включите в разделе Settings: attackReports.enabled и attackerList.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

FoxTrust
Подбор­щик паролей
FoxAuth
Человек

1Подписанный список

2Подбирает пароли

3Не из этой сети

4Верный пароль

5Вход выполнен
FoxAuth
Вне вашего контроля
Сообщение
Отказ
Внутри одного блока
1Каждый час ваш сервер скачивает у FoxTrust список адресов, с которых подбирали пароли, и проверяет его подпись.
2Адрес из списка пробует пароли ко многим учётным записям. Первые три неверных пароля проверяются как обычно.
3После трёх неудач за час проект отклоняет следующий пароль, не проверяя его. Так продолжается, пока адрес не прекратит попытки.
4Другой человек с адреса из списка, например из общей сети Wi-Fi, с первого раза вводит свой пароль верно.
5Он входит, как раньше, и ваше приложение получает токены.

Полезно знать
Список включает суперадминистратор: Settings → Integrations, раздел Attack reporting. Для этого должны быть включены отчёты об атаках, потому что список строится из того, что присылают серверы.
Каждый проект начинает с режима Count only. Ни для кого ничего не меняется, а вкладка Sign-in показывает числа за 7 дней. Выберите Refuse password sign-in, когда числа покажут, что это безопасно.
Человек, которому отказали, видит строку для вас, и в ней его адрес. Добавьте этот адрес в Never check these networks, и он сразу сможет войти.
FoxTrust никогда не узнаёт, кто входит. Список старше 3 часов не используется, поэтому из-за него никому не отказывают.
Затронут только вход по паролю. Вход через провайдера удостоверений, сброс пароля и регистрация не затронуты. Это доступно на любом тарифе.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Protect password sign-in in my FoxAuth project from addresses FoxTrust has seen guessing passwords.
Check that FoxTrust’s list is on and current, read the project’s numbers for the last 7 days, and tell me how many sign-ins from listed addresses had the right password. If I agree, set the project to refuse password sign-in from listed addresses.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_password_guessing_get, then project_update with passwordGuessing. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Turning the list on is an instance setting for a super administrator: attackerList.enabled, which needs attackReports.enabled.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Подписанный список репутации IP-адресов (FoxTrust)

ЧеловекГотово в FoxAuth Cloud
Вход на вашем собственном адресе

1Ваша проблема

ЧеловекВаш адрес
Вход проходит на чужом адресе.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаш адрес
Вход проходит на вашем собственном адресе.&rarr;

3Что вы получите
Открыть вкладку Settings&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа, а в адресной строке ваш адрес
Страница входа находится на собственном адресе проекта. Это путь вроде /yourshop или поддомен вроде yourshop на этом сервере. Суперадминистратор может вместо этого разместить её на вашем домене, например login.yourshop.com, и для человека это будет ваш сайт.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваш адрес
FoxAuth

1Открывает ваш адрес

2Попадает в FoxAuth

3Находит проект

4Ваша страница входа
FoxAuth
Сообщение
Внутри одного блока
1Человек открывает адрес проекта: путь, поддомен или собственный домен.
2Адрес ведёт в FoxAuth. Для собственного домена нужна DNS-запись, которая указывает на FoxAuth.
3FoxAuth находит проект по адресу. У проекта свой издатель (issuer) и свои ключи подписи.
4Человек входит на странице с вашим адресом.

Полезно знать
У проекта ровно один из трёх адресов: путь, поддомен или собственный домен.
Путь или поддомен меняет владелец команды проекта, и только пока в проекте нет ни приложений, ни провайдеров входа, ни подключений SCIM, ни подключённых сервисов.
После этого адрес меняет суперадминистратор. Собственный домен всегда задаёт суперадминистратор.
Для собственного домена нужны DNS-запись и сертификат https.
Смена адреса меняет issuer, поэтому обновите его в своих приложениях.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Give my FoxAuth project the address name yourshop, as a path or a subdomain, and tell me what changes for my apps.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_address_change. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Remind me to update the issuer address in my apps.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Свой issuer у каждого проекта

ЧеловекГотово в FoxAuth Cloud
Выход из одного приложения и сразу из всех

1Ваша проблема

ЧеловекВаше прило­жениеВаши прило­жения
После выхода другие приложения остаются открытыми.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаше прило­жениеВаши прило­жения
Один выход доходит до каждого приложения.&rarr;

3Что вы получите
Открыть вкладку Applications&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Ваша собственная страница «Вы вышли»
Другие приложения выполняют выход без всякой страницы
Когда человек выходит из одного вашего приложения, FoxAuth завершает его сессию. Затем FoxAuth сообщает об этом всем остальным приложениям, где был человек, чтобы они тоже выполнили выход.

На своём сервере включите в разделе Settings: rpInitiatedLogout.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth
Ваши прило­жения

1Нажимает «Выйти»

2Завершить сессию

3Сессия закрыта

4Уведомление о выходе

5Выход выполнен
FoxAuth
Сообщение
Браузер переходит дальше
Внутри одного блока
1Человек нажимает «Выйти» в одном из ваших приложений.
2Приложение отправляет человека на адрес выхода FoxAuth.
3FoxAuth завершает сессию человека.
4FoxAuth отправляет уведомление о выходе каждому другому приложению, которым пользовался человек. Уведомление идёт от сервера к серверу.
5Человек попадает на вашу страницу «Вы вышли».

Полезно знать
Каждое приложение, которое должно узнать о выходе, сообщает FoxAuth адрес для уведомлений о выходе.
Уведомление идёт от сервера к серверу, поэтому работает даже при закрытой вкладке приложения.
Уведомления о выходе отправляются, только пока суперадминистратор держит back-channel logout включённым в настройках сервера.
Перед завершением сессии проверьте подпись logout token, iss, aud и claim events.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add sign-out through FoxAuth to my app: send the person to the end_session_endpoint from discovery with id_token_hint and post_logout_redirect_uri, and add a back-channel logout endpoint that validates the logout token and ends the local session.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_update with postLogoutRedirectUris and backchannelLogoutUri. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OIDC RP-Initiated Logout · OIDC Back-Channel Logout

ЧеловекГотово в FoxAuth Cloud
Вход в стиле вашего продукта

1Ваша проблема

ЧеловекВаше прило­жение
Страница входа выглядит как чужая.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаше прило­жение
Ваш логотип, ваш цвет и язык самого человека.&rarr;

3Что вы получите
Открыть вкладку Applications&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

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

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth

1Нажимает «Войти»

2Вход, ui_locales=ru

3Логотип, цвет, язык

4Ваш стиль, его язык
FoxAuth
Сообщение
Браузер переходит дальше
Внутри одного блока
1Человек нажимает «Войти» в вашем приложении.
2Приложение отправляет человека на вход и может указать, какой язык оно предпочитает.
3FoxAuth берёт ваш цвет, ваш логотип для экрана согласия и язык человека.
4Человек входит на странице, которая выглядит как ваш продукт.

Полезно знать
Логотип загружается как изображение: PNG, JPEG или WebP, до 64 КиБ.
Логотип и цвет показываются для приложения вашей собственной организации. Их нет при входе с устройства и когда все адреса возврата локальные.
FoxAuth сдвигает цвет к ближайшему читаемому оттенку, в светлой и в тёмной теме.
Язык выбирается так: сначала собственный выбор человека, затем ui_locales вашего приложения, затем язык браузера. Консоль и письма администраторам остаются на английском.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Give my FoxAuth application its logo and primary colour, and pass ui_locales from my app’s current language when it sends people to sign in.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_update with logo and primaryColor. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect ui_locales · логотип · основной цвет

ЧеловекГотово в FoxAuth Cloud
Люди видят и удаляют приложения, у которых есть доступ к их аккаунту

1Ваша проблема

Человек
Люди не видят, каким приложениям открыт их аккаунт.&rarr;
2С FoxAuth

ЧеловекFoxAuth
Люди видят каждое приложение и удаляют любое из них.&rarr;

3Что вы получите
Открыть страницу аккаунта&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

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

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth

1Открывает /account/apps

2Приложения с доступом

3Удаляет приложение

4Доступ закрыт
FoxAuth
Сообщение
Внутри одного блока
1Человек открывает страницу аккаунта в вашем проекте.
2FoxAuth показывает приложения, у которых есть доступ к его аккаунту.
3Человек удаляет приложение.
4FoxAuth закрывает этому приложению доступ. Когда приложение обратится в следующий раз, ему откажут.

Полезно знать
Ничего включать не нужно.
Страница находится на собственном адресе проекта, по пути /account/apps.
Поставьте на неё ссылку в настройках аккаунта в вашем приложении.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add a “Connected apps” link to my app’s account settings that opens <your project's issuer, on its Overview>/account/apps.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
Ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Управление выданными разрешениями для конечных пользователей

ЧеловекГотово в FoxAuth Cloud
Люди видят свои входы и выходят везде

1Ваша проблема

Человек
Человеку, который думает, что его аккаунтом пользуется кто-то ещё, некуда посмотреть.&rarr;
2С FoxAuth

ЧеловекFoxAuth
Люди проверяют свои входы и закрывают доступ тому, кто входил вместо них.&rarr;

3Что вы получите
Открыть «Недавние входы»&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Десять последних входов: приложение, время, способ, браузер и страна
Кнопка, чтобы выйти везде
На странице аккаунта видны последние десять входов человека, без адреса. Если какой-то вход был не его, он выходит из всех приложений сразу и получает ссылку, чтобы задать новый пароль.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
FoxAuth

1Открывает «Недавние входы»

2Десять последних входов

3Выходит везде

4Все пути в аккаунт закрыты
FoxAuth
Сообщение
Внутри одного блока
1Человек открывает «Недавние входы» на странице аккаунта и входит заново, если его вход старше 15 минут.
2FoxAuth показывает каждый вход: приложение, когда, как, браузер и страну.
3Один из входов был не его, поэтому он выходит везде.
4FoxAuth завершает все сессии и токены аккаунта и присылает письмо со ссылкой, чтобы задать новый пароль.

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

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Add a “Recent sign-ins” link to my app’s account settings that opens <your project's issuer, on its Overview>/account/sign-ins.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
Ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Управление сессиями для конечных пользователей

ПрограммаГотово в FoxAuth Cloud
Украденный токен бесполезен

1Ваша проблема

Ваше прило­жениеВаш APIТот, у кого копия
Скопированный токен работает у кого угодно.&rarr;
2С FoxAuth

×FoxAuth
Ваше прило­жениеВаш APIТот, у кого копия
Токен работает только с ключом вашего приложения.&rarr;

3Что вы получите
Открыть вкладку Applications&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

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

На своём сервере включите в разделе Settings: dpop.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Ваше прило­жение
FoxAuth
Ваш API
Тот, у кого копия

1Токен + доказательство ключа

2Токен привязан к ключу

3Токен + новое доказательство

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

Полезно знать
Ваш API проверяет доказательство DPoP вместе с токеном.
Клиентские сертификаты (mTLS) делают то же самое, но только на вашем собственном сервере.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Make my app use DPoP with FoxAuth: generate a key pair kept in memory, send a DPoP proof with every token request and every API call, and make my API verify the proof (htm, htu, ath, jti) as well as the token’s cnf.jkt.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use client_update with dpopBoundAccessTokens true. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: DPoP (RFC 9449) · токены с привязкой к сертификату mTLS (RFC 8705)

Для компанийГотово в FoxAuth Cloud
Корпоративный вход

1Ваша проблема

Сотруд­никВаше прило­жение
Ваше приложение хранит пароли, которые ИТ-отдел компании не может отозвать.&rarr;
2С FoxAuth

Сотруд­никВаше прило­жениеFoxAuthOkta или Entra ID
Сотрудники входят через аккаунт своей компании.&rarr;

3Что вы получите
Настроить&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

auth.acme-notes.app

AAcme Notes
Вход
Войти через Acme Corp
или
Электронная почта
Пароль
На странице входа кнопка с названием компании
Затем страница входа самой компании и возвратДальше:Люди появляются и уходят сами&rarr;
Добавьте провайдера входа компании: любой провайдер OpenID или каталог Microsoft одной организации. Ваше приложение при этом не меняется.

На своём сервере включите в разделе Settings: federation.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Сотруд­ник
Ваше прило­жение
FoxAuth
Okta или Entra ID

1Входит

2На страницу входа

3В Okta компании

4Сотрудник подтверждён

5Токены
FoxAuth
Вне вашего контроля
Сообщение
Браузер переходит дальше
Передаёт токен
1Сотрудник нажимает «Войти».
2Приложение, как обычно, отправляет его в FoxAuth.
3FoxAuth отправляет сотрудника к провайдеру его компании.
4Провайдер компании подтверждает, кто это.
5Приложение получает обычные токены.

Полезно знать
Что попросить у ИТ-отдела компании: адрес провайдера, ID и секрет.
Обычно вместе с этим просят и следующее: компания хочет, чтобы её каталог сам создавал и удалял людей.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Connect company sign-in through the customer’s OpenID provider (Okta) to my FoxAuth project. Tell me what to ask the customer’s IT department for.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use federation_provider_create with kind oidc. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · федерация

Для компанийНа своём сервере
Люди появляются и уходят сами

1Ваша проблема

Каталог компанииСотруд­ник
Каждого человека добавляют и удаляют вручную.&rarr;
2С FoxAuth

×
Каталог компанииFoxAuthСотруд­ник
Каталог компании сам добавляет и удаляет людей.&rarr;

3Что вы получите
Запустить свой сервер
В FoxAuth Cloud эта возможность выключена. На своём сервере она есть.

ИТ-отдел компании видит подключение в своём каталоге
Ушедший человек получает отказ при входеДальше:Корпоративный вход&rarr;
Подключение SCIM позволяет каталогу компании создавать, изменять и деактивировать людей в вашем проекте. Ваши приложения по-прежнему спрашивают FoxAuth, кому можно войти.

Включите в разделе Settings: scim.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Каталог компании
FoxAuth
Сотруд­ник

1Пришёл: создать

2Перешёл: изменить

3Ушёл: деактивировать

4Пытается войти

5Отказ
FoxAuth
Вне вашего контроля
Сообщение
Отказ
1В компанию приходит новый человек. Каталог создаёт его в FoxAuth.
2Он переходит в другой отдел. Каталог обновляет запись.
3Он уходит. Каталог деактивирует его.
4Позже он пытается войти в одно из ваших приложений.
5FoxAuth отказывает. Вашему приложению ничего не отправляется: оно просто никогда не получит для него токен.

Полезно знать
Вы даёте ИТ-отделу компании адрес SCIM и токен. Они работают с Entra ID или Okta.
Человек из каталога в консоли доступен только для чтения. Исключение составляет локальная блокировка.
Обычно его просят вместе с корпоративным входом, и он работает с уже добавленным провайдером входа.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Create a SCIM connection for Entra ID in my FoxAuth project, and tell me what the customer’s IT department enters on their side.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use provisioning_connection_create. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: SCIM 2.0 (RFC 7644)

Для компанийГотово в FoxAuth Cloud
Отдел и роль в токене

1Ваша проблема

ЧеловекВаше прило­жение
Ваше приложение не знает, в каком отделе работает человек.&rarr;
2С FoxAuth

FoxAuth
ЧеловекВаше прило­жение
Отдел уже указан в токене.&rarr;

3Что вы получите
Открыть вкладку Groups&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Экрана никто не видит: группы приходят в токене
Распределите людей по группам проекта, и ваше приложение получит их в поле groups токена. По ним оно решит, что показать.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Человек
Ваше прило­жение
FoxAuth

1Входит

2Анна в группе «Финансы»

3groups: Финансы

4Показывает нужное
FoxAuth
Сообщение
Передаёт токен
Внутри одного блока
1Анна входит в ваше приложение.
2В проекте Анна состоит в группе «Финансы».
3Приложение получает её группы в токене.
4Приложение открывает Анне раздел финансов.

Полезно знать
Каталог компании тоже может передавать группы, через SCIM.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Create a Finance group in my FoxAuth project, and show me how to read the groups field in my app.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_group_create. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · claim groups

Для компанийГотово в FoxAuth Cloud
Человек ушёл: доступ закрыт везде

1Ваша проблема

ИТ-отделOkta или Entra IDВаши прило­жения
Человек ушёл, а доступ у него остался.&rarr;
2С FoxAuth

ИТ-отделOkta или Entra IDFoxAuthВаши прило­жения
Одно изменение закрывает доступ везде.&rarr;

3Что вы получите
Открыть вкладку Users&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

Человек выходит из всех приложений, и никакой страницы он не видит
Деактивируйте человека в FoxAuth или позвольте провайдеру компании самому завершить все его сессии.

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

ИТ-отдел
Okta или Entra ID
FoxAuth
Ваши прило­жения

1Деактивирует

2Выход отовсюду

3Сессии закрыты

4Уведомление о выходе
FoxAuth
Вне вашего контроля
Сообщение
Внутри одного блока
1ИТ-отдел деактивирует сотрудника на своей стороне.
2Провайдер компании просит FoxAuth выполнить выход этого человека.
3FoxAuth завершает сессии и отзывает токены.
4Ваши приложения получают уведомление о выходе.

Полезно знать
Это можно сделать вручную: Users, нужный человек, Deactivate.
Его активность хранится ещё 90 дней после деактивации, так что видно, чем он пользовался.
Провайдер компании сделает это за вас, только когда вы добавите его как провайдера входа, а суперадминистратор включит в настройках сервера сигналы, которые этот провайдер отправляет.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Deactivate the user anna@acme.com in my FoxAuth project and end all of their sessions.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use project_user_update and project_user_sign_out. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Okta Universal Logout · OIDC Back-Channel Logout

Для компанийНа своём сервере
Агенты компании без экрана согласия

1Ваша проблема

ИИ-агентВаш API
Нажать «Разрешить» некому.&rarr;
2С FoxAuth

FoxAuth
ИИ-агентOkta или Entra IDВаш API
Компания сама ручается за своих агентов.&rarr;

3Что вы получите
Запустить свой сервер
В FoxAuth Cloud эта возможность выключена. На своём сервере она есть.

Экрана согласия никто не видит: компания уже всё решила
Провайдер компании выдаёт агенту утверждение (assertion), а FoxAuth обменивает его на токен. Так доступ остаётся под контролем компании.

Включите в разделе Settings: jwtBearer.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

ИИ-агент
Okta или Entra ID
FoxAuth
Ваш API

1Просит доступ

2Утверждение

3Обменивает его

4Токен

5Работает
FoxAuth
Вне вашего контроля
Сообщение
Передаёт токен
1Агент просит у провайдера компании доступ к вашему приложению.
2Провайдер выдаёт утверждение (ID-JAG).
3Агент предъявляет утверждение FoxAuth.
4FoxAuth выдаёт токен без экрана согласия.
5Агент вызывает ваш API.

Полезно знать
Доверие включается у провайдера входа, настройкой «Accept assertions».
Такие токены выдаются без refresh-токена.
Утверждения никогда не попадают в административный MCP или SCIM.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Turn on accepting ID-JAG assertions from the company sign-in provider in my FoxAuth project, and explain how an agent trades an assertion for a token.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use federation_provider_update. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: ID-JAG · OAuth 2.0 Token Exchange (RFC 8693) · JWT bearer

Для компанийНа своём сервере
Человек одобряет одно конкретное действие

1Ваша проблема

Ваше прило­жениеЧеловекВаш API
Одно «да» разрешает гораздо больше, чем имелось в виду.&rarr;
2С FoxAuth

FoxAuth
Ваше прило­жениеЧеловекВаш API
Человек одобряет одно конкретное действие.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

Подтвердить запрос?
Кто запрашивает и что именно.

Отклонить
Подтвердить
Экран согласия показывает платёж: сумму и счёт
Человек одобряет этот платёж и ничего другого
Ваше приложение запрашивает одно подробно описанное действие. Экран согласия показывает именно его, а токен несёт это действие и ничего больше.

Включите в разделе Settings: richAuthorizationRequests.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Ваше прило­жение
FoxAuth
Человек
Ваш API

1Одобрить: оплата 100 €

2Показывает платёж

3Одобряет

4Токен для этого платежа

5Платит 100 €
FoxAuth
Сообщение
Передаёт токен
1Приложение запрашивает токен для одного платежа и подробно его описывает.
2FoxAuth показывает человеку сам платёж.
3Человек одобряет его.
4FoxAuth выдаёт токен, который несёт этот платёж и ничего больше.
5Ваш платёжный API читает подробности из токена и выполняет платёж.

Полезно знать
Каждый вид действия объявляется один раз в настройках сервера, вместе с подписью, которую показывает экран согласия.
Подробности попадают только в токен для одного объявленного API.
Это работает с кодами авторизации и refresh-токенами, но не с другими схемами.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Make my app request a payment with authorization_details of type https://scheme.example/payment (actions: initiate, amount, currency, creditor account) and resource set to my payment API, and make the API read authorization_details from the token.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
Ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Rich Authorization Requests (RFC 9396) · authorization_details

Для компанийНа своём сервере
Подтверждение на телефоне

1Ваша проблема

Система колл-центраТелефон клиента
Клиенты называют свой пароль вслух.&rarr;
2С FoxAuth

FoxAuth
Система колл-центраТелефон клиента
Клиент подтверждает на своём телефоне.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

Подтвердить запрос?
Кто запрашивает и что именно.

Отклонить
Подтвердить
На телефоне человека: кто запрашивает и что именно
Подтвердить или отклонить
Запрос приходит человеку на телефон, а токен получает система, которая этот запрос отправила.

Включите в разделе Settings: ciba.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Система колл-центра
FoxAuth
Телефон клиента

1Подтвердить для Анны

2Запрос на телефон

3Подтверждает

4Токены
FoxAuth
Сообщение
Передаёт токен
1Система колл-центра запрашивает подтверждение у Анны.
2Анна получает запрос на телефон.
3Анна подтверждает.
4Система получает токены и продолжает работу.

Полезно знать
Это настройка всего сервера. Её включает суперадминистратор.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Explain how to switch CIBA on in FoxAuth, and how a call centre system sends an approval request.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
Ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect CIBA

Для компанийНа своём сервере
Самый строгий профиль

1Ваша проблема

Служба безопасности
Никто не знает, какие правила действуют на самом деле.&rarr;
2С FoxAuth

Служба безопасностиFoxAuth
Сначала проверка готовности, потом один строгий переключатель.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

Отчёт о готовности в консоли, ещё до каких-либо изменений
Профиль IPSIE SL1 включается одним переключателем, а проверка готовности заранее показывает, что изменится.

Включите в разделе Settings: ipsieSl1.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Служба безопасности
FoxAuth

1Проверка готовности

2Что изменится

3Включить

4Строгие правила
FoxAuth
Сообщение
Внутри одного блока
1Вы запускаете проверку готовности.
2FoxAuth перечисляет приложения, которые перестанут работать.
3Вы включаете профиль.
4Теперь правила действуют для каждого приложения.

Полезно знать
Сначала запустите проверку готовности: она назовёт приложения, которые перестанут работать.
Каждый токен привязан к ключу приложения через DPoP, поэтому украденный токен бесполезен.
PKCE обязателен при каждом входе, и входить могут только заранее зарегистрированные приложения.
Подписи используют PS256, ES256 или EdDSA.
Отдельная настройка, FAPI behaviours, также требует, чтобы подписанное утверждение приложения называло этот сервер единственной аудиторией.
Второй фактор по запросу есть у людей с паролем и приложением-аутентификатором, но не у тех, кто входит через провайдера; проверка готовности называет проекты, где его не сможет дать никто новый.
Это настройка всего сервера.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Check whether my FoxAuth server is ready for the IPSIE SL1 profile, and list what needs fixing.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use settings_ipsie_profile_readiness_get. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: IPSIE SL1 · DPoP (RFC 9449) · PKCE

Для компанийГотово в FoxAuth Cloud
Команды и журнал аудита

1Ваша проблема

Команда
Все работают под одной учётной записью администратора.&rarr;
2С FoxAuth

КомандаПроектЖурнал аудита
Каждой команде доступны только её проекты.&rarr;

3Что вы получите
Открыть раздел Teams&rarr;
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.

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

На своём сервере для этого ничего включать не нужно.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Команда
Проект
Журнал аудита

1Владеет

2Участники работают

3Каждое изменение

4Нельзя изменить
FoxAuth
Сообщение
Внутри одного блока
1Команда «Платежи» владеет своими проектами.
2Попасть в проект могут только участники команды.
3Каждое изменение записывается в журнал.
4Никто не может изменить или удалить запись.

Полезно знать
Ролей нет: доступ даёт членство в команде.
Журнал находится в меню, в разделе Audit.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Create a Payments team in FoxAuth and show me the latest entries in the audit trail.
The server’s issuer is <your project's issuer, on its Overview> and its discovery document is <issuer>/.well-known/openid-configuration.
If the FoxAuth administrative MCP is connected, use team_create and audit_list. Otherwise ask me to press the button for this in the console at https://auth.foxauth.dev/admin.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: Неизменяемый журнал аудита

Для компанийНа своём сервере
Инструмент только для ваших администраторов

1Ваша проблема

Админи­страторВнутренний инструмент
Внутренний инструмент может открыть кто угодно.&rarr;
2С FoxAuth

FoxAuth
Админи­страторВнутренний инструмент
Войти могут только ваши администраторы.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

auth.acme-notes.app

AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа для администраторов, затем возврат в инструмент
Зарегистрируйте инструмент как приложение в проекте администраторов, и поле groups назовёт команды администратора.

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Админи­стратор
Внутренний инструмент
FoxAuth

1Открывает его

2Вход администратора

3groups: его команды

4Пускает нужные команды
FoxAuth
Сообщение
Браузер переходит дальше
Передаёт токен
Внутри одного блока
1Администратор открывает внутренний инструмент.
2Инструмент отправляет его на вход для администраторов.
3Инструмент получает команды администратора.
4Инструмент открывает доступ командам, которым доверяет.

Полезно знать
Его регистрирует суперадминистратор, и только в консоли.
Только вход: такие приложения не получают токенов для API.Промпт для вашего агента

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Explain how a super administrator registers an internal tool as an application in the administrators’ project, in the console at https://auth.foxauth.dev/admin. An agent cannot do this: it is withheld from agents.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · claim groups

Для компанийНа своём сервере
Ваши администраторы входят в консоль через корпоративный SSO

1Ваша проблема

Админи­страторOkta или Entra ID
Для консоли нужен отдельный пароль.&rarr;
2С FoxAuth

Админи­страторFoxAuthOkta или Entra ID
Администраторы входят через SSO своей компании.&rarr;

3Что вы получите
Запустить свой сервер
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.

auth.acme-notes.app

AAcme Notes
Вход
Войти через Acme Corp
или
Электронная почта
Пароль
Страница входа в консоль с кнопкой компании
Затем страница входа самой компании и возврат
Добавьте провайдера компании в проект администраторов, и страница входа в консоль предложит его. FoxAuth при этом следит, чтобы консоль никогда не закрыла вход сама себе.

Включите в разделе Settings: federation.enabled

Как это работает, шаг за шагом
&larr;&rarr;↻Показать снова

Админи­стратор
FoxAuth
Okta или Entra ID

1Открывает консоль

2В Okta компании

3Администратор подтверждён

4Находит админи­стратора

5В консоли
FoxAuth
Вне вашего контроля
Сообщение
Браузер переходит дальше
Внутри одного блока
1Администратор открывает консоль и выбирает провайдера компании.
2FoxAuth отправляет его к провайдеру компании.
3Провайдер подтверждает, кто это.
4FoxAuth связывает его с существующей учётной записью администратора.
5Администратор попадает в консоль.

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

Вставьте его в Claude, Cursor или другого агента для программирования. Промпт охватывает ваш код и настройку в консоли. Он написан на английском.
Explain how a super administrator adds the company’s sign-in provider to the administrators’ project, in the console at https://auth.foxauth.dev/admin, so administrators can sign in with company SSO.
Скопировать промптБраузер не разрешил копирование. Выделите текст и скопируйте его.
Под капотом: OpenID Connect · федерация для входа в консоль

Ничего не подошло? Настройте всё сами
Любое приложение можно настроить вручную. Полная форма в консоли называет каждое поле так же, как протокол, и ничего не заполняет заранее.
Зарегистрировать первое приложениеОткрыть справочник настроек

Все ситуации
Все ситуации из руководства, протокол, на котором держится каждая, и можно ли настроить её в FoxAuth Cloud.Показать все ситуации (42)

СитуацияПод капотомВ FoxAuth Cloud
Ваш продукт
Сайт со своим серверомOpenID Connect · Authorization Code + PKCE · client_secret_basic · refresh-токеныГотово в Cloud
Одностраничное приложение в браузереOpenID Connect · Authorization Code + PKCE · публичное приложение · refresh-токеныГотово в Cloud
Приложение на телефоне, компьютере или в терминалеOpenID Connect · Authorization Code + PKCE · возврат на loopback-адрес (RFC 8252)Готово в Cloud
Телевизор или устройство без клавиатурыOAuth 2.0 Device Authorization Grant (RFC 8628)Готово в Cloud
Программа вызывает ваш API без участия человекаOAuth 2.1 · Client CredentialsГотово в Cloud
Ваш API принимает только ваши приложенияOAuth 2.0 Resource Indicators (RFC 8707) · токены с привязкой к аудитории · интроспекция (RFC 7662) · отзыв (RFC 7009)Готово в Cloud
Другие разработчики сами регистрируют приложения на вашей платформеDynamic Client Registration (RFC 7591) · Registration Management (RFC 7592)Свой сервер
Claude, Cursor или ChatGPT подключаются к вашему MCP-серверуMCP Authorization · OAuth 2.1 · Protected Resource Metadata · Client ID Metadata DocumentГотово в Cloud
Ваш агент работает в Google, GitHub или Slack человекаOAuth 2.0 Token Exchange (RFC 8693) · хранилище токеновГотово в Cloud
Управляйте FoxAuth через ИИ-агентаMCP · защищённый ресурс OAuth 2.1Готово в Cloud
Вход через Google, GitHub, Apple или MicrosoftOpenID Connect · федерацияГотово в Cloud
Веб-приложение без собственного входаForward auth · OpenID Connect · Authorization Code + PKCEГотово в Cloud
Защита MCP-сервера без кода авторизацииForward auth · MCP Authorization · OAuth 2.1 · Protected Resource Metadata (RFC 9728)Готово в Cloud
Пускать только из офисной сетиForward auth · X-Forwarded-ForГотово в Cloud
Закрыть путь для Tor, VPN и других странForward auth · Подписанный снимок сведений об IP-адресах (FoxTrust) · Данные о странах от DB-IPГотово в Cloud
Понять, почему человека не пускаетSign-in decisions · Forward auth decisionsГотово в Cloud
Найти тех, кто больше не пользуется приложениемActivity marks · Forward auth decisionsГотово в Cloud
Просить войти заново перед страницами администратораForward auth · OpenID Connect max_ageГотово в Cloud
Люди создают аккаунт сами или приходят по приглашениюOpenID Connect · email_verifiedГотово в Cloud
Второй фактор при входеTOTP (RFC 6238)Готово в Cloud
Пусть люди сами включают двухэтапную проверкуTOTP (RFC 6238)Готово в Cloud
Спрашивать код только в тех приложениях, которым он нуженOpenID Connect acrГотово в Cloud
Спрашивать код при подключении к MCP-серверу или APIOAuth 2.0 Step Up Authentication Challenge (RFC 9470)Готово в Cloud
Разрешить один инструмент MCP только некоторым людямForward auth · заголовки запроса MCP 2026-07-28Готово в Cloud
Остановить подбор паролей с известных адресовПодписанный список репутации IP-адресов (FoxTrust)Готово в Cloud
Вход на вашем собственном адресеСвой issuer у каждого проектаГотово в Cloud
Выход из одного приложения и сразу из всехOIDC RP-Initiated Logout · OIDC Back-Channel LogoutГотово в Cloud
Вход в стиле вашего продуктаOpenID Connect ui_locales · логотип · основной цветГотово в Cloud
Люди видят и удаляют приложения, у которых есть доступ к их аккаунтуУправление выданными разрешениями для конечных пользователейГотово в Cloud
Люди видят свои входы и выходят вездеУправление сессиями для конечных пользователейГотово в Cloud
Украденный токен бесполезенDPoP (RFC 9449) · токены с привязкой к сертификату mTLS (RFC 8705)Готово в Cloud
Для компаний
Корпоративный входOpenID Connect · федерацияГотово в Cloud
Люди появляются и уходят самиSCIM 2.0 (RFC 7644)Свой сервер
Отдел и роль в токенеOpenID Connect · claim groupsГотово в Cloud
Человек ушёл: доступ закрыт вездеOkta Universal Logout · OIDC Back-Channel LogoutГотово в Cloud
Агенты компании без экрана согласияID-JAG · OAuth 2.0 Token Exchange (RFC 8693) · JWT bearerСвой сервер
Человек одобряет одно конкретное действиеRich Authorization Requests (RFC 9396) · authorization_detailsСвой сервер
Подтверждение на телефонеOpenID Connect CIBAСвой сервер
Самый строгий профильIPSIE SL1 · DPoP (RFC 9449) · PKCEСвой сервер
Команды и журнал аудитаНеизменяемый журнал аудитаГотово в Cloud
Инструмент только для ваших администраторовOpenID Connect · claim groupsСвой сервер
Ваши администраторы входят в консоль через корпоративный SSOOpenID Connect · федерация для входа в консольСвой сервер
