跳到正文
FoxAuth

你需要什么?

两个问题,一张图,一个按钮帮你完成设置。

指南的哪一部分
谁在操作?
你的代码运行在哪里?
你在构建什么?
智能体需要做什么?

智能体是否运行在用户的电脑上,并以用户的身份登录?这和桌面或终端里的应用是同一种情况。

当你的客户是一家公司:他们的 IT 部门会提出什么要求

普通应用完全不需要这些。选出这家公司提出的要求。

这家公司要求什么?

公司登录和 SCIM 排在最前面。它们通常一起出现。

在第 2 个问题中选一个答案,它就会显示在这里。

用户FoxAuth Cloud 上已可用

有自己服务器的网站

你的问题
你的服务器保存着所有人的密码。
用上 FoxAuth
只有 FoxAuth 能看到密码。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • FoxAuth 的登录页面
  • 密码,或身份提供商的按钮
  • 然后回到你的网站,已经登录

你的服务器保存一个密钥,并用一次性授权码换取令牌,所以这是最简单也最安全的登录方式。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户在你的网站上点击“登录”。
  2. 2你的服务器把浏览器转到 FoxAuth 的登录页面。
  3. 3用户输入密码,或者使用 Google 登录。只有 FoxAuth 能看到密码。
  4. 4FoxAuth 把用户送回你的回调地址,并附上一个一次性授权码。
  5. 5你的服务器出示自己的密钥,用授权码换取令牌。浏览器始终看不到这一步。
  6. 6你的服务器建立会话,用户登录成功。

注意事项

  • 只有 localhost 可以使用普通 http。其他地址都需要 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 · 刷新令牌

用户FoxAuth Cloud 上已可用

浏览器中的单页应用

你的问题
浏览器代码里的密钥谁都能看到。
用上 FoxAuth
一次性校验取代了密钥。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • FoxAuth 的登录页面
  • 密码,或身份提供商的按钮
  • 然后回到你的应用,已经登录

浏览器里没有地方保存密钥,所以由 PKCE 保护登录:它是一个只有当前浏览器标签页知道的一次性校验字符串。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户在你的应用中点击“登录”。
  2. 2你的应用把浏览器转去登录,并附上校验字符串的指纹。
  3. 3用户在 FoxAuth 的页面上登录。
  4. 4FoxAuth 把用户送回你的应用,并附上一个一次性授权码。
  5. 5你的应用出示校验字符串本身,用授权码换取令牌。没有校验字符串,被盗的授权码毫无用处。
  6. 6你的应用带着访问令牌调用你的 API。

注意事项

  • 没有密钥也没关系:由 PKCE 负责保护。
  • 在浏览器中,刷新令牌的有效期比在服务器上更短。
  • 只有 localhost 可以使用普通 http。
  • 如果库能把令牌保存在内存中,就不要把令牌放进 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 · 公开应用 · 刷新令牌

用户FoxAuth Cloud 上已可用

手机、桌面或终端中的应用

你的问题
应用能看到用户的密码。
用上 FoxAuth
登录在用户信任的浏览器中打开。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 系统浏览器中的 FoxAuth 登录页面
  • 然后是你的应用显示的“可以关闭此标签页”

登录在系统浏览器中打开,授权码通过一个本地地址回到你的应用,任何端口都可以。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户点击“登录”,或者运行你的登录命令。
  2. 2你的应用在系统浏览器中打开登录页面,并带上 PKCE。
  3. 3用户在自己信任的浏览器中登录。
  4. 4FoxAuth 把授权码发送到 http://127.0.0.1,端口就是你的应用此刻监听的那个。
  5. 5你的应用用授权码换取令牌。

注意事项

  • 一个回调地址覆盖所有端口,所以你不必为每次运行单独登记。
  • 没有密钥:应用在用户手中,可以被拆开分析。
  • 运行在用户电脑上、以用户身份登录的 AI 智能体,设置方式完全相同。
  • 不要用嵌入式 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 · 回环重定向(RFC 8252)

用户FoxAuth Cloud 上已可用

电视或没有键盘的设备

你的问题
要用电视遥控器输入密码。
用上 FoxAuth
一个简短的代码,在手机上确认。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 设备上:一个简短的代码和一个地址
  • 手机上:一个输入代码的框,然后是常规登录

设备显示一个简短的代码,用户在手机上登录。

在你自己的服务器上,请在 Settings 中开启: deviceFlow.enabled

逐步了解它如何运作

  1. 1设备向 FoxAuth 请求一个登录代码。
  2. 2FoxAuth 返回一个简短的代码和一个地址。设备把两者都显示出来。
  3. 3用户在手机上打开这个地址,输入代码,然后照常登录。
  4. 4与此同时,设备每隔几秒就询问一次代码是否已确认。
  5. 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,没有人参与

你的问题
一把永不过期的共享密钥。
用上 FoxAuth
短期令牌取代了共享密钥。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有人看到任何界面:没有用户登录

程序用自己的 ID 和密钥自行登录,并以自己的名义获得令牌。

在你自己的服务器上,请在 Settings 中开启: clientCredentials.enabled

逐步了解它如何运作

  1. 1程序出示自己的 ID 和密钥。
  2. 2FoxAuth 签发一个访问令牌。
  3. 3程序带着这个令牌调用你的 API。
  4. 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 只接受你自己的应用

你的问题
你的 API 接受任何令牌。
用上 FoxAuth
你的 API 只接受发给自己的令牌。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有人看到任何界面:这是程序之间的事

在项目中声明这个 API,FoxAuth 就会把它作为接收方写进每个令牌,因此发给其他 API 的令牌会被拒绝。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1你的应用申请令牌,并指明它用于哪个 API。
  2. 2FoxAuth 签发令牌,并在其中写明接收方。
  3. 3你的 API 看到接收方是自己,于是接受调用。
  4. 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)

程序在你自己的服务器上

其他开发者在你的平台上注册自己的应用

你的问题
你要亲手给每个开发者发密钥。
用上 FoxAuth
开发者自己注册应用。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 授权同意页面写出了应用的名称
  • 页面说明这个应用是自行注册的

外部开发者用一个请求自行注册应用,之后用返回的令牌修改或删除它。

请在 Settings 中开启: registration.enabled

逐步了解它如何运作

  1. 1开发者的应用把自己的信息发送到注册地址。
  2. 2FoxAuth 把它保存为一个应用,并返回它的 ID 和一个管理令牌。
  3. 3用户像登录其他应用一样登录它。授权同意页面会说明这个应用是自行注册的。
  4. 4之后,应用用管理令牌修改或删除自己的注册信息。

注意事项

  • 这是整个服务器的设置,由超级管理员开启。
  • 对于 MCP 客户端,优先使用描述文档地址(metadata URL):MCP 规范已弃用 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)

AI 智能体FoxAuth Cloud 上已可用

Claude、Cursor 或 ChatGPT 连接到你的 MCP 服务器

你的问题
你的 MCP 服务器谁都能访问。
用上 FoxAuth
令牌只在你的服务器上有效。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面,然后是授权同意页面
  • 页面写出了智能体和你的 MCP 服务器
  • 用户选择允许或拒绝

在项目中声明你的 MCP 服务器,用户登录后智能体就能连接,无需注册:智能体用自己描述文档的地址来介绍自己。

在你自己的服务器上,请在 Settings 中开启以下任意一项: clientIdMetadataDocument.enabled 或 registration.enabled

逐步了解它如何运作

  1. 1智能体尝试连接你的服务器。
  2. 2你的服务器回答需要登录,并指明 FoxAuth。
  3. 3智能体给出它的描述文档地址(metadata URL)。它事先不注册任何东西。
  4. 4用户登录,并看到是哪个智能体在请求访问。
  5. 5FoxAuth 签发一个只对你的服务器有效的令牌。
  6. 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

AI 智能体FoxAuth Cloud 上已可用

你的智能体在用户的 Google、GitHub 或 Slack 中操作

你的问题
智能体握着用户的 Google 钥匙。
用上 FoxAuth
令牌由 FoxAuth 保管,而不是智能体。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 一个写明服务名称的页面,例如 Google
  • 用户连接账户并表示同意
  • 之后,用户能看到自己已连接账户的列表

用户只需连接一次自己的账户。之后智能体通过 FoxAuth 获得访问权限,自己不保存任何人的令牌。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户连接一次自己的账户,并表示同意。
  2. 2Google 授予访问权限。FoxAuth 把它加密保存。
  3. 3智能体出示自己的令牌,请求这位用户的 Google 访问权限。
  4. 4FoxAuth 交出一个只属于这位用户的 Google 令牌。
  5. 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) · 令牌保管库

AI 智能体FoxAuth Cloud 上已可用

用 AI 智能体管理 FoxAuth

你的问题
智能体拿到一把拥有全部权限的密钥。
用上 FoxAuth
智能体只拥有你的权限。
你会得到什么
打开 MCP 工具

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 管理员登录页面
  • 一个写明哪个智能体请求以你的身份操作的页面

智能体在 FoxAuth 中做的事和你在控制台中做的一样,权限相同,检查相同,没有任何特殊入口。

在你自己的服务器上,请在 Settings 中开启: mcp.enabled

逐步了解它如何运作

  1. 1你用日常语言向智能体提出要求。
  2. 2智能体连接到 /mcp。你登录并允许它代你操作。
  3. 3智能体调用一个工具:控制台按钮背后也是这个工具。
  4. 4权限、检查和方案限额都是控制台自己的那一套。
  5. 5审计日志记录是谁允许的,以及是哪个智能体执行的。
  6. 6智能体得到回应,并告诉你完成了什么。

注意事项

  • 智能体的权限与你的完全相同。
  • 最危险的操作,例如删除项目,仍然只能在控制台中进行。
  • 在超级管理员于服务器设置中开启之前,它处于关闭状态。FoxAuth Cloud 上已经开启。
  • 智能体通过 FoxAuth 自带的 MCP 客户端连接,或者作为超级管理员许可的应用连接;自行注册的应用永远无法连接。
给你的智能体的提示词

把它粘贴到 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 登录

你的问题
用户又得想一个新密码。
用上 FoxAuth
点一个按钮,用已有的账户登录。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面为每个提供商显示一个按钮
  • “使用 Google 登录”
  • 然后是 Google 自己的页面,再返回

用户用已有的账户登录。你的应用无需任何改动,因为它仍然只与 FoxAuth 通信。

在你自己的服务器上,请在 Settings 中开启: federation.enabled

逐步了解它如何运作

  1. 1用户在你的应用中点击“登录”。
  2. 2你的应用像以前一样把用户转到 FoxAuth。
  3. 3用户选择“使用 Google 登录”。
  4. 4FoxAuth 把用户转到 Google。
  5. 5Google 确认用户的身份。
  6. 6你的应用拿到的令牌与密码登录后的一样。

注意事项

  • 这四个提供商在 Free 方案中都可以使用。
  • 你需要从提供商的控制台获取一个 ID 和一个密钥。
  • Free 方案中的 Microsoft 登录接受任何组织的账户。如果只允许某一家公司目录中的账户登录,请看面向企业的部分。
  • 你的应用不需要任何改动。
给你的智能体的提示词

把它粘贴到 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 上已可用

没有自带登录的 Web 应用

你的问题
任何知道地址的人都能进入。
用上 FoxAuth
你的代理只放行你选定的人。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 第一次时,显示项目的登录页面
  • 之后照常打开你的应用
  • 没有权限的人会看到一个说明原因的页面

把应用放在你的代理后面。每个请求到达应用之前,代理都会先询问 FoxAuth。用户登录你的项目,应用本身不需要改动。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户打开你的应用。请求先到达你的代理。
  2. 2在应用看到请求之前,你的代理先询问项目这个请求能否通过。
  3. 3用户还没有登录,所以项目把浏览器转到它的登录页面。
  4. 4用户登录项目。如果之前已经登录过,这一步会自动完成。
  5. 5项目把浏览器送回你的应用地址上的 /_foxauth/callback,并在那里设置应用的登录 cookie。
  6. 6在下一个请求中,项目按你为这个路径设置的规则进行检查,然后回答“可以”,并说明这个人是谁。
  7. 7你的代理把请求放行到应用,并在 X-Auth-* 请求头中带上用户的 ID、邮箱和用户组。

注意事项

  • 确保只能通过你的代理访问应用。绕过代理到达应用的请求不会经过检查。
  • 你的应用不需要改动。它可以从 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

AI 智能体FoxAuth Cloud 上已可用

无需授权代码即可保护 MCP 服务器

你的问题
在你写好授权代码之前,MCP 服务器谁都能访问。
用上 FoxAuth
你的代理检查每个令牌和每个工具。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面,然后是授权同意页面
  • 页面写出了智能体和你的 MCP 服务器
  • 用户选择允许或拒绝

把你的 MCP 服务器放在你的代理后面。对于每个请求,代理都会请 FoxAuth 检查令牌以及该工具需要的权限(scope),所以服务器本身不需要任何授权代码。

在你自己的服务器上,请在 Settings 中开启以下任意一项: clientIdMetadataDocument.enabled 或 registration.enabled

逐步了解它如何运作

  1. 1智能体调用你的 MCP 服务器。请求先到达你的代理。
  2. 2在 MCP 服务器看到请求之前,你的代理先请项目检查这个请求。
  3. 3现在还没有令牌。项目回答 401 并指明自己,你的代理把这个回答转给智能体。
  4. 4用户登录,并看到是哪个智能体在请求访问。
  5. 5项目签发一个只对你的 MCP 服务器有效的令牌。
  6. 6智能体带着令牌再次调用这个工具。
  7. 7项目检查令牌以及这个工具需要的权限,然后回答“可以”。
  8. 8你的代理把请求转给 MCP 服务器,并在 X-Auth-* 请求头中说明调用者是谁、拥有哪些权限。

注意事项

  • 声明 API 时,在“Who checks tokens?”处选择“Your proxy”。这个 API 的 Connect 会给出 Caddy、Traefik 或 nginx 的配置,可以直接粘贴。
  • API 页面上的 Access 选项卡用来设置每个工具需要哪些权限,以及谁可以调用这个 API:某些用户组、某个属性、某个网络、某些时间段。单个工具还可以再加上自己的用户组、网络或时间段。缺少权限的客户端会被准确告知需要申请哪些权限。
  • 智能体要查找的描述文档(protected resource metadata)由项目自己发布,所以你的 MCP 服务器不需要为登录提供任何东西。
  • 被撤销的令牌在代理处仍然有效,直到它过期,除非这个 API 签发的是不透明(opaque)令牌。请把令牌有效期设得短一些。
  • 绑定到密钥的令牌(DPoP 或证书)会被代理拒绝,因为代理无法检查这个密钥。
  • 确保只能通过你的代理访问 MCP 服务器。没有条件时,任何能登录这个项目的人都能获得它的令牌。所有方案都可以使用。
  • 如果要在智能体连接之前要求输入身份验证器应用中的验证码,或者定期要求重新登录,请在该 API 页面的 Access 选项卡中设置。
给你的智能体的提示词

把它粘贴到 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 上已可用

只允许从办公网络访问

你的问题
被盗的密码在任何地方都能用。
用上 FoxAuth
只有您的网络能进入。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 从其他地方:一个说明无法从此网络打开应用的页面
  • 从办公室:应用,和以前一样
下一步:不让 Tor、VPN 和其他国家访问某个路径

为代理后应用的某个路径添加条件:只允许来自您列出的地址。来自其他地方的人在登录之前就会被拒绝。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1某人在咖啡馆打开您的应用。请求先到达您的代理。
  2. 2您的代理询问项目,并附上它看到的地址和项目的代理密钥。
  3. 3该地址不在您的列表中,因此项目在登录之前就拒绝。
  4. 4在办公室,同样的请求来自您列出的地址。
  5. 5项目检查地址和其余规则,并回答“是”。
  6. 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 和其他国家访问某个路径

你的问题
任何人都可以通过 Tor 尝试打开您的管理页面。
用上 FoxAuth
Tor、VPN 和其他国家进不来。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 来自 Tor、列表中的 VPN、托管服务或其他国家:一个说明无法从所在位置打开该页面的页面
  • 或者,如果您这样选择:重新登录,如果您要求,还需要输入验证码
  • 来自允许国家的普通地址:应用,和以前一样

在代理后应用某个路径的“From where”中加入网络信息:不允许来自 Tor、商业 VPN 或托管服务,并且只允许来自您选择的国家。服务器从 FoxTrust 签名的快照中得知一个地址是什么,这类条件从不把地址发送到任何地方。

在你自己的服务器上,请在 Settings 中开启: networkFacts.enabled

逐步了解它如何运作

  1. 1您的服务器从 FoxTrust 下载关于互联网地址的快照:每天一个完整文件,每小时一次更新。使用之前,服务器会验证签名。
  2. 2某人通过 Tor 打开您应用的 /admin。请求先到达您的代理。
  3. 3您的代理询问项目,并附上它看到的地址和项目的代理密钥。
  4. 4项目在服务器自己的快照副本中查找这个地址。这次检查不会把地址发送到任何地方。
  5. 5快照把这个地址标记为 Tor 出口,因此项目在登录之前就拒绝。
  6. 6在家里,在您允许的国家,同样的请求来自一个普通地址。
  7. 7地址通过了。项目检查其余规则,并回答“是”。
  8. 8您的代理把请求转给您的应用。

注意事项

  • 由超级管理员在 Settings → Integrations 中开启“Network facts from FoxTrust”。之后每台服务器每天下载一个约 13 MB 的文件,每小时下载一次更新。
  • 用户的地址只在您的服务器内部查找。FoxTrust 只知道文件被下载了。
  • 商业 VPN 只包括 FoxTrust 列出的 VPN 服务,不包括公司自己的 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 上已可用

查明某人为什么进不去

你的问题
有人进不去,却没人知道原因。
用上 FoxAuth
每次拒绝都会连同原因一起保留。
你会得到什么
打开 Users

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 和以前一样的拒绝页面:对此人来说什么都没变

在 Users 中打开此人:Activity 标签页列出他的每次登录、每次失败的登录,以及代理后面的应用或 API 每次拒绝他的情况,附带原因和他看到的内容。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1Anna 打开 Wiki,这是你代理后面的一个应用,并完成登录。
  2. 2Wiki 的规则不允许她打开 /admin。她看到一个页面,说无法打开。
  3. 3Anna 联系支持人员。支持人员在 Users 中找到她,打开 Activity 标签页。
  4. 4标签页显示 10:14 的拒绝,共三次,“Not in the groups that may open /admin”,以及一个按今天的规则重新检查的链接。

注意事项

  • 每个项目都会保留:登录的应用、方式、网络地址,开启网络信息时还有 FoxTrust 提供的国家和网络类型,以及浏览器和系统。
  • 地址旁边会显示网络所有者、地区和城市。只要在 Settings → Integrations 中开启“Look up network owner and location at FoxTrust”,服务器就通过 FoxTrust 的 API 查到它们。这项设置默认开启。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 上已可用

找出不再使用某个应用的人

你的问题
在收回访问权限之前,没人知道谁还在使用某个应用。
用上 FoxAuth
每天的使用都会保留,不带地址。
你会得到什么
打开 Users

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有:用户看不到这些

按 Last active 筛选 Users。它把登录、令牌续期以及你的代理放行的每个请求都算在内,所以在已打开的会话中工作的人不会被当作不活跃。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1在季度清理之前,Kai 按“Last active: Not in the last 90 days”筛选 Users。
  2. 2列表显示 90 天内没有登录、没有续期令牌、也没有被你的代理放行过的人。每天在旧会话中打开 Wiki 的人不在列表中。
  3. 3Kai 打开其中一人。Profile 列出此人在过去 90 天里使用过的应用和 API,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
管理页面要求近期登录。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面,并说明应用要求重新登录
  • 然后是所打开的页面

为 /admin 等路径添加条件:当登录时间超过您允许的范围时,要求重新登录。昨天的登录将无法再打开它。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1此人今天早上登录过,现在打开 /admin。
  2. 2您的代理就该请求询问项目。
  3. 3登录时间超过 /admin 允许的范围,因此项目将浏览器转去重新登录,并说明原因。
  4. 4此人重新登录;设置了身份验证器应用的人还要输入验证码。
  5. 5回到 /admin 时登录是近期的,项目回答“是”。
  6. 6您的代理把请求转给管理页面。

注意事项

  • 可选择 15 分钟、1 小时、8 小时或 1 天。在后台加载数据的页面(例如仪表板)会停止工作,直到用户重新加载,因此请将其用于管理路径。
  • 设置了身份验证器应用的人重新登录时也要输入验证码,无论项目是否要求。
  • 勾选 “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 上已可用

用户自己创建账户,或通过邀请加入

你的问题
每个账户都要手工创建。
用上 FoxAuth
用户自己注册,或者接受邀请。
你会得到什么
打开 Sign-in

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面上的“立即注册”链接
  • 填写电子邮件地址和密码的表单
  • 一封带确认链接的邮件

开启注册后,登录页面会出现“立即注册”链接。你也可以在 Users 页面亲自邀请用户。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户点击“立即注册”,并输入电子邮件地址。
  2. 2FoxAuth 发送一封确认邮件。
  3. 3用户打开这封邮件。
  4. 4用户点击其中的链接。
  5. 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 上已可用

登录时的第二因素

你的问题
偷到密码就能登录。
用上 FoxAuth
还需要手机上的验证码。
你会得到什么
打开 Sign-in

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 密码页面
  • 然后是一个要求输入六位验证码的页面
  • 首次使用时,会出现一个需要扫描的二维码

输入密码后,用户还要输入身份验证器应用中的六位验证码。一个开关就能要求项目中的所有人输入。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户输入密码。
  2. 2FoxAuth 要求输入第二因素验证码。
  3. 3身份验证器应用显示一个每 30 秒变化一次的验证码。
  4. 4用户输入验证码。
  5. 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 上已可用

让用户自己开启两步验证

你的问题
只有整个项目开启了开关,才会有人用上验证码。
用上 FoxAuth
想要验证码的人都可以自己添加。
你会得到什么
打开 Sign-in

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 在已连接的应用旁边有一个“两步验证”页面
  • 一封带链接的邮件,然后是一个二维码
  • 之后每次用密码登录时都有一个要求输入验证码的页面

每个人都可以在自己的账号页面上,为账号添加身份验证器应用中的验证码。此后每次用密码登录都会要求输入验证码。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户在自己的账号页面上选择两步验证。
  2. 2FoxAuth 给用户发送一个只在该浏览器中有效的链接。
  3. 3用户打开链接,并用应用扫描二维码。
  4. 4应用显示一个验证码。
  5. 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
账单应用只接受带验证码的登录。
你会得到什么
打开应用

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 输入密码后再输入身份验证器应用中的验证码,每次登录一次
  • 如果没有,会看到一个可以设置并继续的页面
  • 通过身份提供方登录的人会被告知无法以这种方式打开此应用

某个应用(例如账单)不接受没有身份验证器应用验证码的登录。项目中的其他应用保持不变。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户打开应用,被引导去登录。
  2. 2应用请 FoxAuth 让用户登录。
  3. 3FoxAuth 先要求输入密码,再要求输入应用中的验证码。没有设置的人可以当场设置。
  4. 4应用显示一个验证码。
  5. 5FoxAuth 告诉应用,这次登录包含了验证码。

注意事项

  • 在应用的设置中打开 “Require a code from an authenticator app”。保存前,你会看到这会影响多少人。
  • 每次登录只要求一次验证码,而不是每次打开应用都要。
  • 没有验证码的登录所得的刷新令牌会失效,用户需要重新登录并输入验证码。
  • 通过身份提供方登录的人无法以这种方式打开此应用。
  • 对于在你的代理之后的应用,请改为在路径的 “Ask to sign in again” 条件上勾选 “with a code from an authenticator app”。
给你的智能体的提示词

把它粘贴到 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

AI 智能体FoxAuth Cloud 上已可用

连接 MCP 服务器或 API 时要求验证码

你的问题
被盗的密码就能让智能体连接到你的 MCP 服务器。
用上 FoxAuth
只有带验证码的登录才能让智能体连接。
你会得到什么
打开 API 列表

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面上有一行文字写出你的 MCP 服务器的名称
  • 输入密码后再输入身份验证器应用中的验证码
  • 如果没有,会看到一个可以设置并继续的页面

只有当智能体所代表的用户使用身份验证器应用中的验证码登录之后,智能体才能连接你的 MCP 服务器。用户还需要按你选择的频率重新登录。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1智能体向 FoxAuth 申请用于你的 MCP 服务器的令牌。
  2. 2无论智能体请求了什么,FoxAuth 都会先要求用户输入密码,再输入身份验证器应用中的验证码。
  3. 3令牌中写明这次登录包含了验证码。
  4. 4你的服务器或你的代理只接受登录时输入过验证码的令牌。

注意事项

  • 在该 API 页面的 Access 选项卡中打开 “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)

AI 智能体FoxAuth Cloud 上已可用

只允许部分用户使用某一个 MCP 工具

你的问题
能使用你的 MCP 服务器的人,可以调用任何工具。
用上 FoxAuth
这个工具只响应你选择的人。
你会得到什么
打开 API 列表

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有人会看到新的页面
  • 智能体会告知该工具被拒绝

你的 MCP 服务器中的某一个工具(例如 delete_files)只能由你选择的用户组、在你选择的网络和时间段内调用。其他所有工具保持原样开放。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1智能体调用你的 MCP 服务器中的一个工具,并按照 MCP 2026-07-28 的要求写明工具名称。
  2. 2你的代理请项目检查令牌和这个工具。
  3. 3这个人不在可以调用 delete_files 的用户组中,所以项目拒绝了请求。他的其他工具仍然可以使用。
  4. 4同一个智能体调用另一个工具,你的代理放行了请求。

注意事项

  • 在该 API 页面的 Access 选项卡中设置:在这个工具下方为它添加条件。这些条件会叠加在 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 上已可用

阻止已知地址猜测密码

你的问题
一个地址尝试成千上万个密码。
用上 FoxAuth
已知的猜测者只有三次机会。
你会得到什么
打开 Sign-in

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 来自列表中的地址、输错三次密码之后:“此网络暂时无法使用密码登录”、现在可以怎么做,以及一行要发给你的文字
  • 第一次就输入正确密码:和以前一样登录
  • 页面上的其他登录方式保持不变

使用 FoxTrust 的列表,其中是被发现猜测密码的地址。列表中的地址在这里可以输错三次密码,之后它的密码登录会被拒绝。

在你自己的服务器上,请在 Settings 中开启: attackReports.enabled 和 attackerList.enabled

逐步了解它如何运作

  1. 1你的服务器每小时从 FoxTrust 下载被发现猜测密码的地址列表,并验证其签名。
  2. 2列表中的一个地址对许多账户尝试密码。它的前三个错误密码照常检查。
  3. 3一小时内失败三次后,项目会拒绝它的下一个密码,并且不检查它。只要该地址继续尝试,就一直如此。
  4. 4另一个人使用列表中的地址,例如共享的 Wi-Fi,第一次就输入了自己正确的密码。
  5. 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 上已可用

在你自己的地址上登录

你的问题
登录发生在别人的地址上。
用上 FoxAuth
登录发生在你自己的地址上。
你会得到什么
打开 Settings

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面,地址栏中显示你的地址

登录页面位于你项目自己的地址上:一个路径,例如 /yourshop,或者本服务器上的一个子域名,例如 yourshop。超级管理员也可以改为把它放在你自己的域名上,例如 login.yourshop.com,这样在用户看来,它就是你的网站。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户打开项目的地址:一个路径、一个子域名或你自己的域名。
  2. 2这个地址通向 FoxAuth。你自己的域名需要一条指向它的 DNS 记录。
  3. 3FoxAuth 根据地址找到项目。项目有自己的签发者和自己的签名密钥。
  4. 4用户在一个显示你的地址的页面上登录。

注意事项

  • 一个项目只有三种地址中的一种:路径、子域名或你自己的域名。
  • 项目所属团队的所有者可以更改它的路径或子域名,但前提是项目中还没有任何应用、身份提供商、SCIM 连接或已连接的服务。
  • 在那之后,由超级管理员来更改。你自己的域名始终由超级管理员设置。
  • 你自己的域名需要一条 DNS 记录和一张 https 证书。
  • 更改地址会改变签发者,所以请在你的应用中同步更新。
给你的智能体的提示词

把它粘贴到 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.

底层协议: 每个项目一个签发者

用户FoxAuth Cloud 上已可用

退出一个应用,同时退出所有应用

你的问题
退出登录后,其他应用仍然处于登录状态。
用上 FoxAuth
一次退出,所有应用都退出。
你会得到什么
打开 Applications

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 你自己的“已退出”页面
  • 其他应用让用户退出时不显示任何页面

当用户退出你的某个应用时,FoxAuth 会结束用户的会话,并通知用户用过的其他每个应用,以便它们也将用户登出。

在你自己的服务器上,请在 Settings 中开启: rpInitiatedLogout.enabled

逐步了解它如何运作

  1. 1用户在你的某个应用中点击“退出登录”。
  2. 2你的应用把用户转到 FoxAuth 的退出地址。
  3. 3FoxAuth 结束用户的会话。
  4. 4FoxAuth 以服务器到服务器的方式,向用户用过的其他每个应用发送登出通知。
  5. 5用户来到你的“已退出”页面。

注意事项

  • 每个需要接收通知的应用,都要向 FoxAuth 提供一个登出通知地址。
  • 通知在服务器之间发送,所以即使应用的标签页已经关闭也能生效。
  • 只有超级管理员在服务器设置中开启后台通道登出后,才会发送登出通知。
  • 在结束会话之前,先校验登出令牌的签名、iss、aud 和 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 上已可用

看起来像你的产品的登录页面

你的问题
登录页面看起来像别人的。
用上 FoxAuth
你的徽标、你的颜色、用户的语言。
你会得到什么
打开 Applications

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 每个登录页面上都有你的主色
  • 授权同意页面上有你的徽标和名称
  • 用户自己的语言

为你的应用设置徽标和主色,登录页面就会带上它们,并以英文、俄文或简体中文显示。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户在你的应用中点击“登录”。
  2. 2你的应用把用户转去登录,并可以说明它偏好的语言。
  3. 3FoxAuth 选用你的颜色、用于授权同意页面的徽标,以及用户的语言。
  4. 4用户在一个看起来像你的产品的页面上登录。

注意事项

  • 徽标是你上传的图片:PNG、JPEG 或 WebP,最大 64 KiB。
  • 它们只对你自己组织的应用显示。设备登录不显示,所有回调地址都是本地地址时也不显示。
  • 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 上已可用

用户查看并移除能访问其账户的应用

你的问题
用户看不到哪些应用能访问自己的账户。
用上 FoxAuth
用户能看到每个应用,并能移除任何一个。
你会得到什么
打开账户页面

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 能访问其账户的应用列表
  • 每个应用都有一个移除按钮

每个项目都有一个账户页面,列出能访问当前登录用户的应用,用户可以移除其中任何一个。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户打开你项目的账户页面。
  2. 2FoxAuth 列出能访问其账户的应用。
  3. 3用户移除一个应用。
  4. 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 上已可用

用户查看自己的登录记录,并在所有地方退出登录

你的问题
怀疑别人在用自己账户的用户,没有地方可以查看。
用上 FoxAuth
用户查看自己的登录记录,并把不是本人的登录者挡在外面。
你会得到什么
打开“最近登录”

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 最近十次登录:应用、时间、方式、浏览器和国家
  • 一个在所有地方退出登录的按钮

账户页面列出用户最近十次登录,不显示地址。如果其中某次不是本人,用户可以一次退出所有应用,并收到设置新密码的链接。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1用户在账户页面打开“最近登录”;如果登录已超过 15 分钟,需要重新登录。
  2. 2FoxAuth 列出每次登录:应用、时间、方式、浏览器和国家。
  3. 3其中一次不是本人,于是用户在所有地方退出登录。
  4. 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 上已可用

被盗的令牌毫无用处

你的问题
复制走的令牌谁都能用。
用上 FoxAuth
令牌只能配合你的应用的密钥使用。
你会得到什么
打开 Applications

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有人看到任何界面:这是你的应用和你的 API 之间的事

使用 DPoP 时,每个令牌都必须配合一个新的证明才能使用。证明由一把从不离开你的应用的密钥签名,所以单独复制走的令牌会被拒绝。

在你自己的服务器上,请在 Settings 中开启: dpop.enabled

逐步了解它如何运作

  1. 1你的应用申请令牌,并用自己的密钥签名一个证明。
  2. 2FoxAuth 把令牌绑定到这把密钥。
  3. 3每次调用都携带令牌和一个新的证明。
  4. 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 上已可用

公司登录

你的问题
你的应用保存着公司 IT 无法收回的密码。
用上 FoxAuth
员工用公司账户登录。
你会得到什么
立即设置

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 登录页面上有一个带公司名称的按钮
  • 然后是公司自己的登录页面,再返回
下一步:人员自动加入和离开

添加公司的身份提供商,可以是任何 OpenID 提供商,也可以是某个组织的 Microsoft 目录。你的应用无需任何改动。

在你自己的服务器上,请在 Settings 中开启: federation.enabled

逐步了解它如何运作

  1. 1员工点击“登录”。
  2. 2你的应用照常把员工转到 FoxAuth。
  3. 3FoxAuth 把员工转到其公司的身份提供商。
  4. 4公司的身份提供商确认员工的身份。
  5. 5你的应用拿到普通的令牌。

注意事项

  • 你需要向公司的 IT 部门索要:身份提供商的地址、一个 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 · 联合登录

企业在你自己的服务器上

人员自动加入和离开

你的问题
每个人都要手工添加和移除。
用上 FoxAuth
公司的目录自动添加和移除人员。
你会得到什么
运行你自己的服务器

FoxAuth Cloud 关闭了这项功能。你自己的服务器上可以使用。

  • 公司的 IT 部门在自己的目录中看到这个连接
  • 已离职的人在登录时被拒绝
下一步:公司登录

有了 SCIM 连接,公司的目录就能在你的项目中创建、修改和停用人员,而你的应用仍然向 FoxAuth 询问谁可以登录。

请在 Settings 中开启: scim.enabled

逐步了解它如何运作

  1. 1有人加入公司。目录在 FoxAuth 中创建此人。
  2. 2此人调到另一个部门。目录更新其记录。
  3. 3此人离职。目录停用此人。
  4. 4之后,此人尝试登录你的某个应用。
  5. 5FoxAuth 拒绝登录。你的应用不会收到任何消息:它只是永远拿不到此人的令牌。

注意事项

  • 你向公司的 IT 部门提供一个 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 上已可用

令牌中的部门和角色

你的问题
你的应用不知道用户属于哪个部门。
用上 FoxAuth
部门信息随令牌一起到达。
你会得到什么
打开 Groups

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 没有人看到任何界面:用户组随令牌一起到达

把人员放进项目的用户组,你的应用就会在令牌的 groups 字段中拿到这些用户组,并决定显示什么。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1Anna 登录你的应用。
  2. 2在项目中,Anna 是“财务”用户组的成员。
  3. 3你的应用在令牌中拿到她所在的用户组。
  4. 4你的应用为 Anna 打开财务板块。

注意事项

  • 公司的目录也可以通过 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 · groups 声明

企业FoxAuth Cloud 上已可用

有人离职:所有地方的访问都已关闭

你的问题
有人已经离职,访问权限却还开着。
用上 FoxAuth
改一处,所有地方的访问都关闭。
你会得到什么
打开 Users

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 此人从每个应用中退出登录,不会看到任何页面

在 FoxAuth 中停用此人,或者让公司的身份提供商自动将此人从所有地方登出。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1IT 部门在自己那边停用这名员工。
  2. 2公司的身份提供商通知 FoxAuth 让此人退出登录。
  3. 3FoxAuth 结束会话并撤销令牌。
  4. 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

企业在你自己的服务器上

公司的智能体,无需授权同意页面

你的问题
没有人在场点击“允许”。
用上 FoxAuth
公司为自己的智能体担保。
你会得到什么
运行你自己的服务器

FoxAuth Cloud 关闭了这项功能。你自己的服务器上可以使用。

  • 没有人看到授权同意页面:公司已经做了决定

公司的身份提供商给智能体一个断言,FoxAuth 用它换出一个令牌,所以访问权限始终由公司掌控。

请在 Settings 中开启: jwtBearer.enabled

逐步了解它如何运作

  1. 1智能体向公司的身份提供商请求访问你的应用。
  2. 2身份提供商签发一个断言(ID-JAG)。
  3. 3智能体把断言提交给 FoxAuth。
  4. 4FoxAuth 签发令牌,不显示授权同意页面。
  5. 5智能体调用你的 API。

注意事项

  • 信任在身份提供商上开启:“Accept assertions”。
  • 这些令牌不附带刷新令牌。
  • 断言永远不会到达管理 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

企业在你自己的服务器上

用户批准一项具体的操作

你的问题
一次同意放行的远远超出本意。
用上 FoxAuth
用户只批准一项具体的操作。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 授权同意页面显示这笔支付:金额和账户
  • 用户只批准这笔支付,不批准别的

你的应用请求一项描述详尽的操作,授权同意页面准确显示这项操作,令牌也只携带这项操作。

请在 Settings 中开启: richAuthorizationRequests.enabled

逐步了解它如何运作

  1. 1你的应用为一笔支付申请令牌,并详细描述这笔支付。
  2. 2FoxAuth 向用户显示这笔支付本身。
  3. 3用户批准这笔支付。
  4. 4FoxAuth 签发一个只携带这笔支付的令牌。
  5. 5你的支付 API 从令牌中读取详细信息并执行。

注意事项

  • 每种操作只需在服务器设置中声明一次,同时写明授权同意页面显示的标签。
  • 这些详细信息只会进入发给某一个已声明 API 的令牌。
  • 它适用于登录授权码和刷新令牌,不适用于其他流程。
给你的智能体的提示词

把它粘贴到 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

企业在你自己的服务器上

在手机上批准

你的问题
客户要把密码大声说出来。
用上 FoxAuth
客户在自己的手机上批准。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 用户的手机上:谁在请求,请求什么
  • 批准或拒绝

请求送到用户的手机上,发起请求的系统拿到令牌。

请在 Settings 中开启: ciba.enabled

逐步了解它如何运作

  1. 1呼叫中心系统请求 Anna 批准。
  2. 2Anna 在手机上收到请求。
  3. 3Anna 批准。
  4. 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

企业在你自己的服务器上

最严格的安全规范

你的问题
没人说得清哪些规则真正在执行。
用上 FoxAuth
先做就绪检查,再打开一个严格开关。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 控制台中的就绪报告,在任何改变发生之前给出

IPSIE SL1 规范只需一个开关就能启用。在此之前,就绪检查会先显示哪些地方会改变。

请在 Settings 中开启: ipsieSl1.enabled

逐步了解它如何运作

  1. 1你运行就绪检查。
  2. 2FoxAuth 列出将会停止工作的应用。
  3. 3你开启这个规范。
  4. 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 上已可用

团队与审计日志

你的问题
所有人共用一个管理员账户。
用上 FoxAuth
每个团队只能访问自己的项目。
你会得到什么
打开 Teams

在 FoxAuth Cloud 中打开,进入你的项目。 你需要先登录,或者创建一个免费账户。

  • 控制台中的日志:谁在什么时间改了什么

项目归团队所有。只有成员身份能授予访问权限。每项更改都会写入一份任何人都无法编辑的日志。

在你自己的服务器上,这不需要开启任何设置。

逐步了解它如何运作

  1. 1支付团队拥有自己的项目。
  2. 2只有团队成员能访问项目。
  3. 3每项更改都写入日志。
  4. 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
只有你的管理员能进入。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 管理员登录页面,然后回到工具

把这个工具注册为管理员项目中的应用,groups 字段就会写出管理员所在的团队。

逐步了解它如何运作

  1. 1管理员打开内部工具。
  2. 2工具把管理员转到管理员登录页面。
  3. 3工具拿到管理员所在的团队。
  4. 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 · groups 声明

企业在你自己的服务器上

你的管理员用公司 SSO 登录控制台

你的问题
控制台需要一个单独的密码。
用上 FoxAuth
管理员用公司的登录方式进入控制台。
你会得到什么
运行你自己的服务器

这需要超级管理员,而 FoxAuth Cloud 上没有超级管理员。在你自己的服务器上,由超级管理员来设置。

  • 控制台登录页面上有一个公司按钮
  • 然后是公司自己的登录页面,再返回

把公司的身份提供商添加到管理员项目,控制台的登录页面就会提供它,同时 FoxAuth 确保控制台永远不会把自己锁住。

请在 Settings 中开启: federation.enabled

逐步了解它如何运作

  1. 1管理员打开控制台,选择公司的身份提供商。
  2. 2FoxAuth 把管理员转到公司的身份提供商。
  3. 3身份提供商确认管理员的身份。
  4. 4FoxAuth 把此人关联到其已有的管理员账户。
  5. 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 · 刷新令牌Cloud 上可用
浏览器中的单页应用OpenID Connect · Authorization Code + PKCE · 公开应用 · 刷新令牌Cloud 上可用
手机、桌面或终端中的应用OpenID Connect · Authorization Code + PKCE · 回环重定向(RFC 8252)Cloud 上可用
电视或没有键盘的设备OAuth 2.0 Device Authorization Grant (RFC 8628)Cloud 上可用
程序调用你的 API,没有人参与OAuth 2.1 · Client CredentialsCloud 上可用
你的 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 DocumentCloud 上可用
你的智能体在用户的 Google、GitHub 或 Slack 中操作OAuth 2.0 Token Exchange (RFC 8693) · 令牌保管库Cloud 上可用
用 AI 智能体管理 FoxAuthMCP · OAuth 2.1 受保护资源Cloud 上可用
使用 Google、GitHub、Apple 或 Microsoft 登录OpenID Connect · 联合登录Cloud 上可用
没有自带登录的 Web 应用Forward auth · OpenID Connect · Authorization Code + PKCECloud 上可用
无需授权代码即可保护 MCP 服务器Forward auth · MCP Authorization · OAuth 2.1 · Protected Resource Metadata (RFC 9728)Cloud 上可用
只允许从办公网络访问Forward auth · X-Forwarded-ForCloud 上可用
不让 Tor、VPN 和其他国家访问某个路径Forward auth · 签名的 IP 快照(FoxTrust)· DB-IP 国家数据Cloud 上可用
查明某人为什么进不去Sign-in decisions · Forward auth decisionsCloud 上可用
找出不再使用某个应用的人Activity marks · Forward auth decisionsCloud 上可用
在管理页面前要求重新登录Forward auth · OpenID Connect max_ageCloud 上可用
用户自己创建账户,或通过邀请加入OpenID Connect · email_verifiedCloud 上可用
登录时的第二因素TOTP (RFC 6238)Cloud 上可用
让用户自己开启两步验证TOTP (RFC 6238)Cloud 上可用
只在需要的应用中要求验证码OpenID Connect acrCloud 上可用
连接 MCP 服务器或 API 时要求验证码OAuth 2.0 Step Up Authentication Challenge (RFC 9470)Cloud 上可用
只允许部分用户使用某一个 MCP 工具Forward auth · MCP 2026-07-28 请求头Cloud 上可用
阻止已知地址猜测密码签名的 IP 信誉列表(FoxTrust)Cloud 上可用
在你自己的地址上登录每个项目一个签发者Cloud 上可用
退出一个应用,同时退出所有应用OIDC RP-Initiated Logout · OIDC Back-Channel LogoutCloud 上可用
看起来像你的产品的登录页面OpenID Connect ui_locales · 徽标 · 主色Cloud 上可用
用户查看并移除能访问其账户的应用面向最终用户的授权管理Cloud 上可用
用户查看自己的登录记录,并在所有地方退出登录面向最终用户的会话管理Cloud 上可用
被盗的令牌毫无用处DPoP (RFC 9449) · mTLS 证书绑定令牌(RFC 8705)Cloud 上可用
企业
公司登录OpenID Connect · 联合登录Cloud 上可用
人员自动加入和离开SCIM 2.0 (RFC 7644)自己的服务器
令牌中的部门和角色OpenID Connect · groups 声明Cloud 上可用
有人离职:所有地方的访问都已关闭Okta Universal Logout · OIDC Back-Channel LogoutCloud 上可用
公司的智能体,无需授权同意页面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 · groups 声明自己的服务器
你的管理员用公司 SSO 登录控制台OpenID Connect · 控制台联合登录自己的服务器