| 说明 | 检查对某个 URL 的 HTTP 访问权限 |
| 用法 | sbx policy check http [--sandbox SANDBOX] [--method METHOD] URL [flags] |
描述
针对发往 URL 的 HTTP 请求评估当前策略。
URL 必须是绝对的 HTTP 或 HTTPS URL。该检查先评估网络访问,然后在适用时评估 HTTP 方法、路径和查询策略。它不会解析主机名、发起网络请求,也不考虑运行时的传输行为。 需要 HTTP 授权的透明连接会在运行时被拦截,而由守护进程管理的别名无论策略结果如何 都可能可达。主机名的结果不包含应用于其解析后 IP 地址的策略。显示的 URL 保留目标 的主机拼写;使用 --verbose 时,Resource 会显示经策略评估的规范化主机和端口。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--format | 输出格式:table、json 或 yaml | |
--json | 以 JSON 格式输出 | |
--method | GET | 要评估的 HTTP 方法 |
--sandbox | 在指定沙箱的策略上下文中评估 | |
-v, --verbose | 显示策略动作与资源 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API,而不是本地 sandboxd(支持的动词正在逐步增加,运行 sbx --cloud --help 查看当前列表) | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示;需要应答的命令会直接失败,并给出应当运行的命令 |
示例
console
# 检查一次 GET 请求
sbx policy check http https://api.example.com/v1/items
# 在沙箱上下文中检查一次 POST 请求
sbx policy check http --sandbox my-sandbox --method POST https://api.example.com/v1/items
# 检查带查询条件的请求并以 JSON 输出
sbx policy check http --json 'https://api.example.com/search?team=platform'参见
sbx policy check— 检查策略是否允许某次访问请求