应用访问白名单
将 OAuth 和 SAML 登录限制为特定的团队和用户,确保只有获得批准的成员才能登录你的应用。
应用访问白名单#
一些下游应用(如 frp、自托管工具)本身不支持基于 JWT claims 的访问控制 —— 它们无法读取 in_team_* 或 role_in_team_* 声明并自行强制执行成员资格检查。 应用访问白名单 功能让 Prism 在入口处就进行拦截,在用户到达应用之前完成检查。
启用后,OAuth 和 SAML 登录都会按一组规则检查用户。未匹配任何规则的用户将被重定向到 "访问被拒绝"页面,而不是看到授权页面。
工作原理
应用所有者在应用的 访问 标签页中开启白名单
添加规则,指定哪些团队或用户可以授权
团队规则可以按需要求最低角色(所有者、共同所有者、管理员或成员)
多条规则之间是或关系 —— 匹配任意一条即可获得访问权限
如果开关已开启但没有配置任何规则,任何人都无法访问该应用
配置白名单#
1. 在仪表盘中打开应用#
导航到 应用 → 选择应用 → 点击 访问 标签页。
2. 开启白名单#
将 启用访问白名单 切换为开启状态。
3. 添加规则#
点击 添加规则 并选择:
| 规则类型 | 团队 — 团队中所有成员均可访问。用户 — 单个用户可访问。 |
| 目标 | 从下拉菜单中选择团队,或输入用户 ID。 |
| 最低角色 | (仅限团队)成员必须拥有的最低角色。可选:所有者、共同所有者、管理员、成员。 |
你可以添加任意数量的规则。用户只需匹配至少一条规则即可通过白名单检查。
4. 删除规则#
每条规则行都有一个删除按钮,删除后立即生效。
认证过程中的检查#
检查在用户登录之后、显示授权页面之前执行。不匹配的用户会看到一个"访问被拒绝" 页面,其中显示应用名称和一个"返回"按钮。
API 管理#
白名单规则也可以通过 API 管理(需要对应用的写权限):
列出规则#
curl https://your-prism.example/api/apps/<app_id>/access-rules \
-H "Authorization: Bearer <token>"响应:
{
"rules": [
{
"id": "rul_abc123",
"app_id": "app_xyz789",
"rule_type": "team",
"target_id": "team_456",
"min_role": "admin",
"created_at": 1711200000
},
{
"id": "rul_def456",
"app_id": "app_xyz789",
"rule_type": "user",
"target_id": "usr_abc",
"min_role": null,
"created_at": 1711200100
}
]
}添加规则#
curl -X POST https://your-prism.example/api/apps/<app_id>/access-rules \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"rule_type": "team",
"target_id": "team_456",
"min_role": "admin"
}'删除规则#
curl -X DELETE https://your-prism.example/api/apps/<app_id>/access-rules/<rule_id> \
-H "Authorization: Bearer <token>"限制#
没有公开的用户列表 API。 创建用户规则时必须知道用户的 ID。 带下拉选择的团队规则是主要的工作流程。
白名单在授权时进行评估。将用户从团队中移除会立即阻止其后续登录, 但不会使该应用已有的访问令牌失效 —— 如有需要,应用所有者还应撤销令牌。
支持子团队继承:如果团队规则允许访问,且用户是某个子团队的成员, 他们将以有效成员资格通过检查。