Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth
Пароль или кнопка провайдера
Затем возврат на ваш сайт, уже после входа
Ваш сервер хранит секрет и обменивает одноразовый код на токены. Поэтому такой вход самый простой и самый безопасный.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашсервер
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth
Пароль или кнопка провайдера
Затем возврат в ваше приложение, уже после входа
Секрет здесь хранить негде, поэтому вход защищает PKCE. Это одноразовая проверочная строка, которую знает только эта вкладка браузера.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Приложениевбраузере
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа FoxAuth в системном браузере
Затем сообщение от вашего приложения: «эту вкладку можно закрыть»
Вход открывается в системном браузере, а код возвращается в ваше приложение на локальный адрес, на любой порт.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашеприложение
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)
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)
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Экрана никто не видит: это общение между программами
Объявите API в своём проекте, и FoxAuth впишет его в каждый токен как получателя. Токен, выданный для другого API, будет отклонён.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Вашеприложение
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Приложение разработчика отправляет свои данные на адрес регистрации.
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
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 человека
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
GoogleПодключите свой аккаунт
Тогда ваш агент сможет пользоваться им от вашего имени через FoxAuth.
Отмена
Подключить
Страница, на которой назван сервис, например Google
Человек подключает аккаунт и даёт согласие
Позже: список подключённых аккаунтов
Человек один раз подключает свой аккаунт. После этого агент получает доступ через FoxAuth и сам ничьих токенов не хранит.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
ИИ-агент
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.foxauth.dev
Администрирование FoxAuth
Claudeпросит действовать от вашего имени
Видеть ваши проекты и приложения
Создавать и менять приложения
Не разрешать
Разрешить
Страница входа администратора
Страница, на которой назван агент, который хочет действовать от вашего имени
Агент делает в FoxAuth то же, что вы делаете в консоли: с теми же правами, с теми же проверками и без особого входа.
На своём сервере включите в разделе Settings: mcp.enabled
Как это работает, шаг за шагом
Вы
ИИ-агент
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Ваша проблема
ЧеловекВашеприложение
Людям приходится придумывать ещё один пароль.→
2С FoxAuth
ЧеловекВашеприложениеFoxAuthGoogle
Вход одной кнопкой, с аккаунтом, который уже есть.→
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа проекта, в первый раз
Потом ваше приложение, как раньше
Тот, кому нельзя, видит страницу с отказом
Поставьте приложение за свой прокси. Прокси спрашивает FoxAuth о каждом запросе, прежде чем пропустить его к приложению. Люди входят в ваш проект, а приложение менять не нужно.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Браузерчеловека
Вашпрокси
Вашеприложение
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Claudeпросит разрешения действовать от вашего имени
Читать ваши заметки
Добавлять новые заметки
Не разрешать
Разрешить
Страница входа, затем экран согласия
На нём названы агент и ваш MCP-сервер
Человек разрешает доступ или отказывает
Поставьте MCP-сервер за свой прокси. О каждом запросе прокси просит FoxAuth проверить токен и права (scope), которые нужны инструменту. Самому серверу код авторизации не нужен.
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Добавьте к пути приложения за прокси условие: только с перечисленных адресов. Человека из другого места не пустят ещё до входа.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Браузер
Вашпрокси
Вашеприложение
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.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Из Tor, VPN из списка, с хостинга или из другой страны: страница о том, что отсюда эту страницу не открыть
Или, если вы так выбрали: новый вход, с кодом, если вы его требуете
С обычного адреса в разрешённой стране: приложение, как раньше
Добавьте в «From where» на пути приложения за прокси сведения о сети: не из Tor, коммерческого VPN или хостинга и только из выбранных стран. Что это за адрес, сервер узнаёт из подписанного снимка FoxTrust, а для такого условия сам адрес никуда не отправляет.
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. Сначала войдите или создайте бесплатную учётную запись.
Та же страница отказа, что и раньше: для человека ничего не меняется
Откройте человека в Users: на вкладке Activity видны все его входы, все неудачные попытки и каждый отказ приложения за вашим прокси или API, с причиной и с тем, что человек увидел.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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Ваша проблема
Администратор
Никто не знает, кто ещё пользуется приложением, прежде чем отнять доступ.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Ничего: люди этого не видят
Отфильтруйте Users по Last active. Он учитывает вход, обновление токенов и каждый запрос, который пропустил ваш прокси. Поэтому человек, который работает в открытой сессии, никогда не считается неактивным.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Администратор
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
Просить войти заново перед страницами администратора
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа с пояснением, что приложение просит войти снова
Затем открытая страница
Добавьте к пути, например /admin, условие: просить войти снова, если вход старше допустимого. Вход со вчерашнего дня такой путь больше не откроет.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Браузер
Вашпрокси
Вашеприложение
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Ваша проблема
Человек
Каждый аккаунт создают вручную.→
2С FoxAuth
FoxAuth
ЧеловекПочта
Люди регистрируются сами или принимают приглашение.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Регистрация
Электронная почта
Пароль
Создать аккаунт
Уже есть аккаунт? Войти
Ссылка «Зарегистрироваться» на странице входа
Форма для адреса и пароля
Письмо со ссылкой для подтверждения
Включите регистрацию, и на странице входа появится ссылка «Зарегистрироваться». Или приглашайте людей сами со страницы Users.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница с паролем
Затем страница, которая просит шестизначный код
При первом входе: QR-код, который нужно отсканировать
После пароля человек вводит шестизначный код из приложения-аутентификатора. Один переключатель требует его от всех в проекте.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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Ваша проблема
Человек
Код есть только там, где его включили для всего проекта.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница «Двухэтапная проверка» рядом с подключёнными приложениями
Письмо со ссылкой, затем QR-код
Потом страница с кодом при каждом входе по паролю
Каждый может добавить к своему аккаунту код из приложения-аутентификатора на странице своего аккаунта. После этого при каждом входе по паролю будет нужен и код.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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
Спрашивать код только в тех приложениях, которым он нужен
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Код из приложения-аутентификатора после пароля, один раз за вход
Если кода нет, страница, где его можно настроить и продолжить
При входе через провайдера человек узнаёт, что так в это приложение не войти
Одно приложение, например биллинг, никого не пускает без кода из приложения-аутентификатора. Остальные приложения проекта работают как раньше.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашеприложение
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-серверу.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Строка на странице входа, где назван ваш MCP-сервер
Код из приложения-аутентификатора после пароля
Если кода нет, страница, где его можно настроить и продолжить
Агент подключается к вашему MCP-серверу, только если человек, от имени которого он действует, вошёл с кодом из приложения-аутентификатора. Входить снова человеку придётся так часто, как вы выберете.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
ИИ-агент
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-сервером, тот может вызвать любой инструмент.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Новой страницы никто не видит
Агент сообщает, что инструмент отказал
Один инструмент вашего MCP-сервера, например delete_files, смогут вызывать только выбранные группы, из выбранных сетей и в выбранные часы. Все остальные инструменты останутся открыты, как раньше.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
ИИ-агент
Вашпрокси
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. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
С адреса из списка после трёх неверных паролей: «Вход по паролю из этой сети сейчас недоступен», что делать сейчас и строка, которую нужно отправить вам
С верным паролем с первой попытки: вход, как раньше
Другие способы входа остаются на странице
Используйте список FoxTrust: в нём адреса, с которых подбирали пароли. Адрес из списка может трижды ошибиться в пароле здесь, а потом его входы по паролю отклоняются.
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. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа, а в адресной строке ваш адрес
Страница входа находится на собственном адресе проекта. Это путь вроде /yourshop или поддомен вроде yourshop на этом сервере. Суперадминистратор может вместо этого разместить её на вашем домене, например login.yourshop.com, и для человека это будет ваш сайт.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашадрес
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Ваша проблема
ЧеловекВашеприложениеВашиприложения
После выхода другие приложения остаются открытыми.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Ваша собственная страница «Вы вышли»
Другие приложения выполняют выход без всякой страницы
Когда человек выходит из одного вашего приложения, FoxAuth завершает его сессию. Затем 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. Сначала войдите или создайте бесплатную учётную запись.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Ваш основной цвет на каждой странице входа
Ваш логотип и название на экране согласия
Язык человека
Задайте приложению логотип и основной цвет, и страницы входа покажут их. Страницы бывают на английском, русском или упрощённом китайском.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашеприложение
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Ваша проблема
Человек
Люди не видят, каким приложениям открыт их аккаунт.→
2С FoxAuth
ЧеловекFoxAuth
Люди видят каждое приложение и удаляют любое из них.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Список приложений, у которых есть доступ к аккаунту
Кнопка, чтобы удалить каждое из них
У каждого проекта есть страница аккаунта. На ней перечислены приложения, у которых есть доступ к аккаунту вошедшего человека, и любое из них можно удалить.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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Ваша проблема
Человек
Человеку, который думает, что его аккаунтом пользуется кто-то ещё, некуда посмотреть.→
2С FoxAuth
ЧеловекFoxAuth
Люди проверяют свои входы и закрывают доступ тому, кто входил вместо них.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Десять последних входов: приложение, время, способ, браузер и страна
Кнопка, чтобы выйти везде
На странице аккаунта видны последние десять входов человека, без адреса. Если какой-то вход был не его, он выходит из всех приложений сразу и получает ссылку, чтобы задать новый пароль.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
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Тот,укогокопия
Скопированный токен работает у кого угодно.→
2С FoxAuth
×FoxAuth
ВашеприложениеВашAPIТот,укогокопия
Токен работает только с ключом вашего приложения.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Экрана никто не видит: это общение вашего приложения и вашего API
С DPoP каждый токен работает только вместе со свежим доказательством, подписанным ключом, который никогда не покидает ваше приложение. Поэтому одну лишь копию токена отклонят.
На своём сервере включите в разделе Settings: dpop.enabled
Как это работает, шаг за шагом
Вашеприложение
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Ваша проблема
СотрудникВашеприложение
Ваше приложение хранит пароли, которые ИТ-отдел компании не может отозвать.→
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Подключение SCIM позволяет каталогу компании создавать, изменять и деактивировать людей в вашем проекте. Ваши приложения по-прежнему спрашивают 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Ваша проблема
ЧеловекВашеприложение
Ваше приложение не знает, в каком отделе работает человек.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Экрана никто не видит: группы приходят в токене
Распределите людей по группам проекта, и ваше приложение получит их в поле groups токена. По ним оно решит, что показать.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Человек
Вашеприложение
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Человек выходит из всех приложений, и никакой страницы он не видит
Деактивируйте человека в FoxAuth или позвольте провайдеру компании самому завершить все его сессии.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
ИТ-отдел
OktaилиEntraID
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Агент просит у провайдера компании доступ к вашему приложению.
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
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Система колл-центра запрашивает подтверждение у Анны.
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Ваша проблема
Службабезопасности
Никто не знает, какие правила действуют на самом деле.→
2С FoxAuth
СлужбабезопасностиFoxAuth
Сначала проверка готовности, потом один строгий переключатель.→
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Ваша проблема
Команда
Все работают под одной учётной записью администратора.→
Откроется ваш проект в FoxAuth Cloud. Сначала войдите или создайте бесплатную учётную запись.
Журнал в консоли: кто, что и когда изменил
Проектами владеют команды, и доступ даёт только членство в команде. Каждое изменение попадает в журнал, который никто не может отредактировать.
На своём сервере для этого ничего включать не нужно.
Как это работает, шаг за шагом
Команда
Проект
Журналаудита
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.
Браузер не разрешил копирование. Выделите текст и скопируйте его.
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.
auth.acme-notes.app
AAcme Notes
Вход
Электронная почта
Пароль
Войти
или
Войти через Google
Страница входа для администраторов, затем возврат в инструмент
Зарегистрируйте инструмент как приложение в проекте администраторов, и поле groups назовёт команды администратора.
Как это работает, шаг за шагом
Администратор
Внутреннийинструмент
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
Это настраивает суперадминистратор, а в FoxAuth Cloud таких прав нет ни у кого. На своём сервере это сделает ваш суперадминистратор.
auth.acme-notes.app
AAcme Notes
Вход
Войти через Acme Corp
или
Электронная почта
Пароль
Страница входа в консоль с кнопкой компании
Затем страница входа самой компании и возврат
Добавьте провайдера компании в проект администраторов, и страница входа в консоль предложит его. 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 · федерация для входа в консоль
Ничего не подошло? Настройте всё сами
Любое приложение можно настроить вручную. Полная форма в консоли называет каждое поле так же, как протокол, и ничего не заполняет заранее.