跳转到内容

成员与设备

团队由成员和设备组成。每台设备有自己的密钥和指纹,管理员只有在收到设备所有者发来的指纹后,才会把团队密钥授予该设备。这样同步服务器就无法自行加入设备。

只有管理员可以邀请成员、授予密钥、撤销邀请和移除成员。

  1. 管理员: 邀请成员。

    bssh teams invite platform ana@example.com

    bssh 会为 Ana 打印两条命令,其中包含一次性令牌和你设备的指纹。请通过你确认为 Ana 本人的渠道发送。

  2. Ana: 使用邀请创建账号,然后用管理员指纹加入。

    bssh teams init --server https://teams.example.com --email ana@example.com --invite <TOKEN>
    bssh teams join <TOKEN> --fingerprint <ADMIN FINGERPRINT>

    如果团队中没有任何管理员设备的指纹与之匹配,bssh 会拒绝信任该团队。加入后会打印 Ana 设备的指纹。

  3. 管理员: 把密钥授予 Ana 的设备。

    bssh teams grant platform

    这会列出等待密钥的设备。只有收到 Ana 发来的指纹后才授予:

    bssh teams grant platform --fingerprint <ANA'S FINGERPRINT>
  4. Ana: 同步。

    bssh teams sync

    团队的连接会出现在 bssh list 中。

邀请中包含管理员的指纹,成员在加入时将其固定。如果该指纹不属于团队的任何管理员设备,就什么都不信任:服务器无法冒充团队管理员。同样,管理员只把密钥授予成员直接发来的指纹,这样服务器就无法自行加入设备。

请通过你已经在用的聊天工具、电话或当面发送指纹。不要通过同步服务器,也不要从管理员界面读取:在粘贴的指纹匹配之前,桌面应用不会显示服务器报告的指纹。

授予团队密钥:粘贴的指纹与服务器上等待授予的设备匹配

此时没有信任任何内容,邀请令牌也已用完。请用正确的指纹按团队 ID 完成加入:

bssh teams join --team <TEAM ID> --fingerprint <FINGERPRINT>

错误消息会打印确切的命令,其中包含团队 ID。请先与管理员核对指纹:不匹配也可能意味着服务器并不是你以为的那一台。

在桌面应用中,加入对话框会说明不匹配,并提供 Try again,以同样的方式完成加入。

待处理的邀请会占用一个席位,直到被接受或在创建 7 天后过期。

管理员可以用 bssh teams members platform 查看待处理的邀请,也可以在桌面应用团队 Members & devices 标签页的 Pending invites 下查看。

bssh teams uninvite platform ana@example.com

这会撤销邀请:令牌不再有效,席位也重新空闲。在桌面应用中,选择邀请旁的 Revoke。如果令牌丢失,请撤销邀请并重新发送。

bssh teams invite platform sam@example.com --admin

管理员可以邀请成员、授予密钥、撤销邀请、移除成员并读取审计日志。在桌面应用中,在 Create invite 前勾选 Make them an admin。

bssh teams remove platform ana@example.com

bssh 会要求确认,移除 Ana 并轮换团队密钥。

轮换后,Ana 的设备无法再同步,此后写入的任何内容对她都不可读。她可能仍保留已同步内容的副本,因此请轮换重要的凭据。

轮换只会把新密钥封装给这台管理员设备通过 bssh teams grant 批准过的设备。如果服务器列出了你从未批准过的设备,轮换会停止并指出该设备。在命令行中,这条消息出现时该成员已经被移除;在轮换成功之前,团队仍使用当前的密钥。请与其所有者核对该设备的指纹后授予,然后再次同步以完成轮换。桌面应用的 Remove… 对话框会列出这些设备,在全部授予之前不允许移除该成员;若轮换因其他原因停止,原因会留在对话框中。

目前还不能逐个撤销设备。要移除单台设备,请先移除该成员,然后重新邀请。

bssh teams members platform

这会列出每位成员及其角色、每台设备的指纹,如果你是管理员,还会列出待处理的邀请。在桌面应用中,团队的 Members & devices 标签页显示相同内容,并带有席位计量、等待密钥的设备和除你之外每位成员的 Remove… 按钮。

  • 授予后同步,并收取待处理的更改。
  • 在审计日志中查看成员在团队主机上发起的会话。