为 GitHub Codespaces 管理存储库和组织的加密机密

关于机密

密钥是您在组织或仓库中创建的加密环境变量。你创建的机密可用于 GitHub Codespaces。 GitHub 在机密提交到 GitHub 之前使用 libsodium 密封盒对其加密，并且仅当需要在 codespace 中使用它们时才对其解密。

组织级密钥允许在多个仓库之间共享密钥，从而减少创建重复密钥的需要。您可以使用访问策略来控制哪些仓库可以使用组织密钥。

一旦创建了密码，便可以在创建新的代码空间或重新启动代码空间时使用它。要使用刚刚在当前代码空间中创建的密码，您需要停止代码空间并恢复它。有关停止 codespace 的信息，请参阅“在 GitHub Codespaces 中使用 Visual Studio Code 命令面板”。

以下规则适用于密码名称：

密钥名称只能包含字母数字字符（[a-z]、[A-Z]、[0-9]）或下划线 (_)。不允许空格。
机密名称不得以 GITHUB_ 前缀开头。
密码名称不能以数字开头。
机密名称不区分大小写。
密码名称在所创建的级别上必须是唯一的。例如，在仓库级别创建的密钥必须在该仓库中具有唯一的名称，而在组织级创建的密钥必须在该级别有独特的名称。

如果具有相同名称的机密存在于多个级别，则级别最低的机密优先。例如，如果组织级别密码的名称与仓库级别的密码相同，则仓库级别的密码优先。

每个组织最多可存储 100 个密钥，每个仓库最多可存储 100 个密钥。

密码大小限于 48 KB。

要为组织仓库创建密码，您必须具有管理员访问权限。

在 GitHub.com 上，导航到存储库的主页。 1. 在存储库名称下，单击 “设置”。如果看不到“设置”选项卡，请选择下拉菜单，然后单击“设置” 。

1. 在边栏的“安全性”部分中，选择“ 机密和变量”、然后单击“Codespaces” 。
在页面顶部，单击“新建存储库机密”。
在“名称”输入框中键入机密名称。
输入密码的值。
单击“添加机密”。

在组织中创建密码时，可以使用策略来限制可以访问该密码的仓库。例如，您可以将访问权限授予所有仓库，也可以限制仅私有仓库或指定的仓库列表拥有访问权限。

要在组织级别创建机密，必须具有 admin 访问权限。

在 GitHub.com 上，导航到组织的主页。 1. 在组织名称下，单击“设置”。

1. 在边栏的“安全性”部分中，选择“ 机密和变量”、然后单击“Codespaces” 。
在页面顶部，单击“新建组织机密”。
在“名称”输入框中键入机密名称。
输入“机密”的值。
从“存储库访问”下拉列表中，选择访问策略。
单击“添加机密”。

您可以检查哪些访问策略应用于组织中的密钥。

在 GitHub.com 上，导航到组织的主页。 1. 在组织名称下，单击“设置”。

1. 在边栏的“安全性”部分中，选择“ 机密和变量”、然后单击“Codespaces” 。
密码列表包括任何已配置的权限和策略。例如：
若要详细了解已为每个机密配置的权限，请单击“更新”。