本指南涉及的角色

  • Owner / Admin:可以管理组织成员、项目、连接器、资产和授权。
  • Member:只能使用被授予的访问发起会话,无法执行下列标注的管理步骤。

必经路径

这 6 步走完,你就拥有了第一次可验证的资产访问。

  1. 注册并完成 MFA 引导

    通过注册表单创建账号。WingGate 在 onboarding 中要求绑定首个 MFA 因子:用认证器应用扫描二维码绑定 TOTP,或注册 passkey(Touch ID / Windows Hello / 安全密钥);注册 passkey 时会签发一次性恢复码,请立即抄写保存。注册后自动获得默认组织和项目。

    完成标志:
    登录成功并进入控制台。
    失败时:
    验证码或 passkey 确认被拒时,先确认设备时间已同步或凭据仍在本机,再重试。
    打开注册
  2. 部署并绑定连接器 Owner/Admin

    在能触达资产的网络中的一台主机上安装 wing-connector。连接器通过 mTLS 主动出站连接 WingGate,无需暴露入站端口。安装后在连接器页面将其绑定到组织。

    完成标志:
    连接器在组织的连接器清单中显示为在线。
    失败时:
    连接器持续离线时,先验证到 WingGate 的出站连通性,再查看连接器服务日志。见连接器部署文章。
  3. 添加资产和连接配置 Owner/Admin

    打开组织资产池并选择「添加资产」。按本指南继续时,接入一台 SSH 主机并填写地址和连接配置。浏览器资产由 WingGate 扩展绑定,不走这个表单。

    完成标志:
    资产连同其连接配置出现在组织的资产清单中。
    失败时:
    资产无法触达时,要从连接器所在网络而不是你的笔记本去验证地址。
  4. 在项目中创建访问授权 Owner/Admin

    项目访问授权把该项目的全数据面授予成员。只授权真正需要访问的人。

    完成标志:
    授权出现在项目的访问页面中。
    失败时:
    成员报「未授权」时,检查其是否持有该项目的授权,以及资产是否就绪。
  5. 发起第一次会话

    首次连接时,WingGate 会探测目标主机的 SSH 主机密钥,供你带外核对;确认后即固定该密钥,之后出现不匹配会被标记而不是被静默接受。然后在项目中对资产发起 Web 终端会话。

    完成标志:
    在目标主机上打开 shell。
    失败时:
    主机密钥不匹配时,重新探测并审慎确认——对无法解释的不匹配绝不要 override(见安全页面);会话打不开时,按顺序排查连接器状态、授权范围、连接配置上的凭据。
  6. 在审计中确认访问

    每次会话和与授权相关的操作都会记录在组织的审计视图中(查看需要相应角色)。打开审计,确认你的首次连接以预期的操作者、资产和时间出现。

    完成标志:
    审计条目与你的会话一致。
    失败时:
    条目缺失时,确认你查看的是正确的组织和时间范围。

按需扩展

核心路径之外的能力,需要时再接入。

使用你自己的 SSH 客户端

除了 Web 终端,也可以用你自己的 SSH 客户端,通过 WingGate 的 SSH 访问和账号中注册的公钥连接资产。

完成标志:
在自己的客户端中打开 shell。
失败时:
客户端连不上时,确认账号已注册 SSH 公钥,并使用 WingGate 提供的 SSH 访问端点。

配置 MCP 凭据并连接客户端

WingGate 可以通过 MCP 向 AI Agent 暴露受限的文件和命令能力。在项目中创建 MCP 凭据,并让你的外部 MCP 客户端使用它。

完成标志:
客户端列出 WingGate 的工具,且调用在授权范围内成功。
失败时:
认证失败时,核对凭据值以及客户端是否每次请求都携带;凭据只在创建时展示一次。

绑定浏览器资产

WingGate 浏览器扩展把你本机已登录的浏览器变成浏览器资产。从 Chrome 应用商店安装扩展(无法访问商店时可改用部署分发的安装包),然后在控制台完成设备码绑定;AI Agent 随即获得受控的浏览器工具(快照、截图、点击、填写、等待),敏感操作在扩展侧本地确认。详见文档中的浏览器绑定指南。

完成标志:
浏览器资产出现在组织资产池中,可供 MCP 浏览器工具使用。
失败时:
绑定未完成时,确认扩展已打开、设备码一致,并在绑定审批页批准该代码。

排障入口