$ knox show -w -a privkey -s sshkeys/corporate | ssh-add -

编辑密钥

修改现有密钥的语法与创建密钥时使用的语法完全相同，只是增加了一个可选的属性列表，用于删除。

$ knox edit website.com -d url username=newlogin password=
 INFO  libknox::commands::write > entry website.com was successfully edited

此命令将从密钥中删除 url 属性，将 username 属性更改为 newlogin，并提示输入被删除属性的值 password

重命名密钥

可以通过 rename 命令来重命名密钥

$ knox rename my/first/secret new/location/secret
 INFO  libknox::commands::write > entry my/first/secret was successfully renamed to new/location/secret

删除密钥

$ knox delete dir/subdir/website.com
 INFO  libknox::commands::delete > entry 'dir/subdir/website.com' was successfully deleted from the vault

检查是否被黑

Vault 集成了 Troy Hunt 的 Have I Been Pwned，以检查您的某些密码是否出现在已知的数据泄露中。目前，您可以手动检查每个机密属性是否为特定条目

$ knox pwned my/super/password
 INFO  libknox::commands::pwned > Pwnage status for attributes at pwned/test
 :: PWNED my/super/password:password
 :: PWNED my/super/password:secure
 :: PWNED my/super/password:apikey

在添加或编辑条目时，也会对机密属性进行检查。您可以通过在这些命令中使用 -f / --force 标志来跳过此行为。

您也可以省略 PATH 参数以启动针对数据泄露的全局检查。这可能需要一些时间，但会检查您保险库中的所有机密属性

$ knox pwned
INFO  libknox::commands::pwned > checking for pwned secret across your vault
 :: PWNED test/insecure/test1:password
 :: PWNED test/insecure/test1:apikey
 :: PWNED test/insecure/test2:password
█████████████████████████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░ 53/70
[...]
 INFO  knox::commands::pwned > 5 secrets were found in HIBP's database

管理身份

当您初始化保险库时，它被设置为用于一个特定的 GPG 身份。您可以在保险库中添加和删除任何 GPG 身份，以便其他人可以访问它。

警告：请根据您的威胁模型检查此操作是否适合您。当有人获得一个用他们的 GPG 公钥加密的保险库副本时，无法回溯，他们将能够永久解密该特定保险库快照的内容。

如果您使用的是多身份保险库，单个私钥足以解密保险库，但需要 所有 公钥才能写入。

当您向保险库添加或删除身份时，所有条目（包括元数据）都将使用新的一组公钥（作为 GPG 接收者）重新加密。这可能需要一些时间，具体取决于您的保险库大小。

$ knox init [email protected]
 INFO  libknox::commands::init > vault initialized successfully at /vault
[...]
$ knox identities add [email protected]
 INFO  libknox::commands::identities > Writing metadata file...
 :: re-encrypting entry company/secret1
 :: re-encrypting entry personal/secret2
 :: re-encrypting entry company/secret2
 :: re-encrypting entry personal/secret1
 :: re-encrypting entry personal/secret3

$ knox identities delete [email protected]

配置 TOTP

您的保险库中的每个条目都可以存储一个用于生成 TOTP 代码的 TOTP 配置。首先，配置 TOTP 参数（除了密钥作为 base32 字符串外，所有参数都是可选的）

$ knox totp configure secure/website --secret abcdefghijklmnop --interval 30 --length 6 --hash sha1
 INFO  knox::commands::totp > the TOTP configuration for secure/website has been saved successfully

TOTP 将作为条目上的虚拟红字属性出现，并且还会使用特定命令打印出来

$ knox show -p secure/website
🔒 Knox / secure / website
  username = apognu
  password = password
     @totp = 123456 (expires in 22s)

$ know totp show secure/website
🔒 Knox / secure / website
   TODO = 123456 (expires in 13s)

您可以通过命令 knox totp inspect 检查现有的 TOTP 配置，它将打印出来。

Git 集成

每次您编辑保险库时，无论是添加、编辑或删除密钥，还是更改身份，都会在您的保险库目录中创建一个 git 提交。您的密钥的任何识别信息 永远不会存储在提交信息中，这样就不会泄露任何有关您在保险库中存储的内容的见解。

如果您愿意，可以手动设置远程并推送您的仓库

$ knox git remote [email protected]:passwords.git
 INFO  knox::commands::git > git remote URL set to '[email protected]:passwords.git'
$ knox git push
 INFO  knox::commands::git > vault modifications successfully pushed upstream

目前，唯一支持的认证方法是使用由 ssh-agent 提供的 SSH 密钥。

作为库

examples 目录包含一个示例，展示如何使用 libknox 来操作保险库。您可以通过以下方式运行示例

$ cargo run --example simple