大网数据广告活动
Azure 身份与安全

如何为 Azure Key Vault 生成和传输受 HSM 保护的密钥 - Azure Key Vault

· 52CE 我爱测

使用这篇文章可帮助你规划、生成然后传输自己的受 HSM 保护的密钥,以便与 Azure 密钥保管库一起使用。 也称为 BYOK 或自带密钥。

Note: 本文已经过更新,以便使用 Azure Az PowerShell 模块。 若要与 Azure 交互,建议使用的 PowerShell 模块是 Az PowerShell 模块。 若要开始使用 Az PowerShell 模块,请参阅安装 Azure PowerShell。 若要了解如何迁移到 Az PowerShell 模块,请参阅 将 Azure PowerShell 从 AzureRM 迁移到 Az。

为了提高可靠性,在使用 Azure 密钥保管库时,可以在硬件安全模块 (HSM) 中导入或生成永不离开 HSM 边界的密钥。 这种情况通常被称为自带密钥,简称 BYOK。 Azure Key Vault 使用 HSM 的 nCipher nShield 系列(FIPS 140-2 第 2 级验证)来保护密钥。

Note: 本文档中所述的 HSM 密钥导入方法仅适用于 HSM 的 nCipher nShield 系列。 若要从其他 HSM 导入 HSM 密钥,请参阅此处。

使用本主题中的信息,可帮助规划、生成并传输自己的受 HSM 保护的密钥,以便与 Azure 密钥保管库一起使用。

此功能不适用于 Azure 中国世纪互联。

Note: 有关 Azure 密钥保管库的详细信息,请参阅什么是 Azure 密钥保管库?
如需包括为受 HSM 保护的密钥创建密钥保管库的入门教程,请参阅什么是 Azure 密钥保管库?。

有关生成和通过 Internet 传输受 HSM 保护的密钥的详细信息:

  • 从脱机工作站生成密钥,这样可以减小攻击面。
  • 密钥通过密钥交换密钥 (KEK) 进行加密,且在传输到 Azure 密钥保管库 HSM 之前一直处于加密状态。 只有加密版本的密钥会离开原始工作站。
  • 该工具集会在将密钥绑定到 Azure 密钥保管库安全体系的租户密钥上设置属性。 因此,在 Azure 密钥保管库 HSM 收到和解密密钥之后,只有这些 HSM 能够使用它。 无法导出密钥。 此绑定由 nCipher HSM 强制实施。
  • 用于加密密钥的密钥交换密钥 (KEK) 是在 Azure 密钥保管库 HSM 内部生成的,且不可导出。 HSM 会强制使 HSM 外部没有清晰版本的 KEK。 此外,该工具集还包括来自 nCipher 的证明,即 KEK 不可导出,并在 nCipher 制造的正版 HSM 内部生成。
  • 该工具集包括来自 nCipher 的证明,即 Azure Key Vault 安全体系也在 nCipher 制造的正版 HSM 内部生成。 此证明可证明 Microsoft 使用的是正版硬件。
  • Microsoft 会在每个地理区域都使用单独的 KEK 和单独的安全体系。 这种分离可确保密钥只能在将其加密的区域的数据中心使用。 例如,来自欧洲客户的密钥不能在北美或亚洲数据中心使用。

有关 nCipher HSM 和 Microsoft 服务的详细信息

nCipher Security 是一家 Entrust Datacard 公司,也是常规用途 HSM 市场的领导者,通过向各个世界领先的组织提供对其业务关键信息和应用程序的信任、完整性和控制来为它们提供支持。 nCipher 的加密解决方案使用全球各组织如今赖以保护敏感数据、网络通信和企业基础架构免受威胁的相同成熟技术,确保新兴技术(云、IoT、区块链、数字付款)的安全,并帮助满足新的符合性要求。 nCipher 提供对业务关键应用程序的信任,从而确保数据的完整性,并使客户任何时候都可掌握完全的控制。

Microsoft 已与 nCipher Security 联手增强 HSM 的技术开发水平。 这些增强功能可使你能够获得托管服务的典型优势,而且无需放弃对密钥的控制权。 具体来说,这些增强功能可以让 Microsoft 管理 HSM,这样你就不必费心管理了。 作为云服务,Azure Key Vault 无需通知即可扩大,以满足组织的使用高峰需求。 同时,密钥也会在 Microsoft 的 HSM 内部获得保护:你生成密钥并将其传输到 Microsoft 的 HSM,所以可以保留对密钥生命周期的控制权。

为 Azure 密钥保管库实现“自带密钥 (BYOK)”

如果将生成自己的受 HSM 保护的密钥,然后将其传输到 Azure 密钥保管库(“自带密钥 (BYOK)”方案),请使用以下信息和过程。

BYOK 的先决条件

有关适用于 Azure 密钥保管库的“自带密钥 (BYOK)”的先决条件列表,请参阅下表。

要求 更多信息
Azure 订阅 若要创建 Azure 密钥保管库,需要 Azure 订阅:注册免费试用版
用于支持受 HSM 保护的密钥的 Azure 密钥保管库“高级”服务层级 请参阅 Azure 密钥保管库定价网站,了解有关 Azure 密钥保管库的服务层级和功能的详细信息。
nCipher nShield HSM、智能卡和支持软件 必须具有 nCipher 硬件安全模块的访问权限并掌握 nCipher nShield HSM 的基本操作知识。 请参阅 nCipher nShield 硬件安全模块,了解兼容型号的列表,或者如果还没有 HSM,请购买 HSM。
以下硬件和软件:<ol><li>脱机 x64 工作站,最低 Windows 操作系统为 Windows 7,nCipher nShield 软件最低为 11.50 版。如果此工作站运行 Windows 7,则必须安装 Microsoft.NET Framework 4.5。</li><li>连接到 Internet 的工作站,最低 Windows 操作系统为 Windows 7,最低 Azure PowerShell 安装版本为 1.1.0。 </li><li>至少拥有 16 MB 可用空间的 USB 驱动器或其他便携式存储设备。</li></ol> 出于安全原因,建议第一个工作站不要连接到网络。 但是,此建议不会以编程方式强制执行。在后面的说明中,将此工作站称为连接断开的工作站。</blockquote>此外,如果租户密钥用于生产网络,建议使用第二个独立的工作站来下载工具集和上传租户密钥。 但出于测试目的,可以使用与第一个相同的工作站。在后面的说明中,将第二个工作站称为连接到 Internet 的工作站。</blockquote>

生成密钥并将其传输到 Azure 密钥保管库 HSM

将使用以下五个步骤来生成密钥并将其传输到 Azure 密钥保管库 HSM:

步骤 1:准备连接到 Internet 的工作站

在步骤 1 中,请对连接到 Internet 的工作站执行以下过程。

步骤 1.1:安装 Azure PowerShell

从通过 Internet 连接的工作站,下载并安装Azure PowerShell 模块,其包含用于管理 Azure 密钥保管库的 cmdlet。 如需安装说明,请参阅 How to install and configure Azure PowerShell(如何安装和配置 Azure PowerShell)。

步骤 1.2:获取 Azure 订阅 ID

使用以下命令启动 Azure PowerShell 会话,并登录 Azure 帐户:

   Connect-AzAccount

在弹出的浏览器窗口中,输入 Azure 帐户用户名和密码。 然后,使用 Get-AzSubscription 命令:

   Get-AzSubscription

从输出中,找到用于 Azure 密钥保管库的订阅的 ID。 稍后会用到该订阅 ID。

不要关闭 Azure PowerShell 窗口。

步骤 1.3:下载 Azure 密钥保管库的 BYOK 工具集

转到 Microsoft 下载中心,针对所在的地理区域或 Azure 实例下载 Azure Key Vault BYOK 工具集。 使用以下信息确定要下载的包名称及其对应的 SHA 256 包哈希:


美国:

KeyVault-BYOK-Tools-UnitedStates.zip

2E8C00320400430106366A4E8C67B79015524E4EC24A2D3A6DC513CA1823B0D4


欧洲:

KeyVault-BYOK-Tools-Europe.zip

9AAA63E2E7F20CF9BB62485868754203721D2F88D300910634A32DFA1FB19E4A


亚洲:

KeyVault-BYOK-Tools-AsiaPacific.zip

4BC14059BF0FEC562CA927AF621DF665328F8A13616F44C977388EC7121EF6B5


拉丁美洲:

KeyVault-BYOK-Tools-LatinAmerica.zip

E7DFAFF579AFE1B9732C30D6FD80C4D03756642F25A538922DD1B01A4FACB619


日本:

KeyVault-BYOK-Tools-Japan.zip

3933C13CC6DC06651295ADC482B027AF923A76F1F6BF98B4D4B8E94632DEC7DF


韩国:

KeyVault-BYOK-Tools-Korea.zip

71AB6BCFE06950097C8C18D532A9184BEF52A74BB944B8610DDDA05344ED136F


南非:

KeyVault-BYOK-Tools-SouthAfrica.zip

C41060C5C0170AAAAD896DA732E31433D14CB9FC83AC3C67766F46D98620784A


阿拉伯联合酋长国:

KeyVault-BYOK-Tools-UAE.zip

FADE80210B06962AA0913EA411DAB977929248C65F365FD953BB9F241D5FC0D3


澳大利亚:

KeyVault-BYOK-Tools-Australia.zip

CD0FB7365053DEF8C35116D7C92D203C64A3D3EE2452A025223EEB166901C40A


Azure 政府:

KeyVault-BYOK-Tools-USGovCloud.zip

F8DB2FC914A7360650922391D9AA79FF030FD3048B5795EC83ADC59DB018621A


美国政府国防部:

KeyVault-BYOK-Tools-USGovernmentDoD.zip

A79DD8C6DFFF1B00B91D1812280207A205442B3DDF861B79B8B991BB55C35263


加拿大:

KeyVault-BYOK-Tools-Canada.zip

61BE1A1F80AC79912A42DEBBCC42CF87C88C2CE249E271934630885799717C7B


德国:

KeyVault-BYOK-Tools-Germany.zip

5385E615880AAFC02AFD9841F7BADD025D7EE819894AA29ED3C71C3F844C45D6


德国公共部门:

KeyVault-BYOK-Tools-Germany-Public.zip

54534936D0A0C99C8117DB724C34A5E50FD204CFCBD75C78972B785865364A29


印度:

KeyVault-BYOK-Tools-India.zip

49EDCEB3091CF1DF7B156D5B495A4ADE1CFBA77641134F61B0E0940121C436C8


法国:

KeyVault-BYOK-Tools-France.zip

5C9D1F3E4125B0C09E9F60897C9AE3A8B4CB0E7D13A14F3EDBD280128F8FE7DF


英国:

KeyVault-BYOK-Tools-UnitedKingdom.zip

432746BD0D3176B708672CCFF19D6144FCAA9E5EB29BB056489D3782B3B80849


瑞士:

KeyVault-BYOK-Tools-Switzerland.zip

88CF8D39899E26D456D4E0BC57E5C94913ABF1D73A89013FCE3BBD9599AD2FE9


若要验证已下载的 BYOK 工具集的完整性,请从 Azure PowerShell 会话中使用 Get-filehash cmdlet。

Get-FileHash KeyVault-BYOK-Tools-*.zip

该工具集包括:

  • 名称以 BYOK-KEK-pkg- 开头的密钥交换密钥 (KEK) 包。
  • 名称以 BYOK-SecurityWorld-pkg- 开头的的安全体系包。
  • 名称为 verifykeypackage.py 的 Python 脚本。
  • 名为 KeyTransferRemote.exe 的命令行可执行文件,以及相关的 DLL。
  • 名称为 vcredist_x64.exe 的 Visual c + + 可再发行组件包。

将该软件包复制到 U 盘或其他便携式存储设备。

步骤 2:准备连接断开的工作站

在步骤 2 中,请对未连接到网络(Internet 或内部网络)的工作站执行以下过程。

步骤 2.1:准备使用 nCipher nShield HSM 的连接断开的工作站

在 Windows 计算机上安装 nCipher支持软件,然后将 nCipher nShield HSM 连接到该计算机。

确保 nCipher 工具位于路径 (%nfast_home%\bin) 下。 例如,请键入以下内容:

set PATH=%PATH%;"%nfast_home%\bin"

有关详细信息,请参阅 nShield HSM 附带的用户指南。

步骤 2.2:在连接断开的工作站上安装 BYOK 工具集

从 U 盘或其他便携式存储设备中复制 BYOK 工具集包,并执行以下操作:

  1. 将下载的程序包中的文件解压到任意文件夹中。
  2. 从该文件夹中运行 vcredist_x64.exe。
  3. 按照说明安装 Visual Studio 2013 的 Visual c + + 运行时组件。

步骤 3:生成密钥

在步骤 3 中,请对连接断开的工作站执行以下过程。 若要完成此步骤,HSM 必须处于初始化模式。

步骤 3.1:将 HSM 模式更改为“I”

如果使用 nCipher nShield Edge,要更改模式,请执行以下操作:1. 使用“模式”按钮突出显示所需模式。 2. 几秒钟内,按住“清除”按钮几秒钟。 如果模式发生更改,新模式的 LED 指示灯将停止闪烁并保持亮起。 状态 LED 可能会不规则地闪烁几秒钟,并在设备就绪时规则闪烁。 否则,设备保持在当前模式,相应的模式 LED 亮起。

步骤 3.2:创建安全体系

启动命令提示符并运行 nCipher new-world 程序。

 new-world.exe --initialize --cipher-suite=DLf3072s256mRijndael --module=1 --acs-quorum=2/3

此程序可在 %NFAST_KMDATA%\local\world(与 C:\ProgramData\nCipher\Key Management Data\local 文件夹对应)下创建一个 安全体系 文件。 可以使用不同的值进行仲裁,但在本例中,系统会提示为每个值输入三个空白卡和 pin。 然后,任何两个卡都会提供对安全体系的完全访问权限。 这些卡变成新安全体系的 管理员卡集。

Note: 如果 HSM 不支持较新的密码套件 DLf3072s256mRijndael,则可以将 --cipher-suite=DLf3072s256mRijndael 替换为 --cipher-suite=DLf1024s160mRijndael

使用 nCipher 软件版本 12.50 附带的 new-world.exe 创建的安全体系与此 BYOK 过程不兼容。 可以使用两个选项:

  1. 将 nCipher 软件版本降级为 12.40.2,以创建新的安全体系。
  2. 请联系 nCipher 支持人员并请求他们提供 12.50 软件版本的修补程序,该修补程序使你能够使用 new-world.exe 的 12.40.2 版本,该版本与此 BYOK 过程兼容。

然后执行以下操作:

  • 备份体系文件。 保障和保护体系文件、管理员卡及其 pin,并确保无人可拥有多个卡的访问权限。

步骤 3.3:将 HSM 模式更改为“O”

如果使用 nCipher nShield Edge,要更改模式,请执行以下操作:1. 使用“模式”按钮突出显示所需模式。 2. 几秒钟内,按住“清除”按钮几秒钟。 如果模式发生更改,新模式的 LED 指示灯将停止闪烁并保持亮起。 状态 LED 可能会不规则地闪烁几秒钟,并在设备就绪时规则闪烁。 否则,设备保持在当前模式,相应的模式 LED 亮起。

步骤 3.4:验证下载的包

此步骤是可选的,但建议执行,以便能够验证以下内容:

  • 工具集附带的密钥交换密钥已从正版 nCipher nShield HSM 中生成。
  • 工具集附带的安全体系哈希已在正版 nCipher nShield HSM 中生成。
  • 密钥交换密钥不可导出。

Note: 要验证下载的程序包,HSM 必须处于连接状态且接通电源,并且在其上必须包含一个安全体系(例如你刚刚创建了一个)。

验证下载的程序包:

  1. 根据所在的地理区域或 Azure 实例,键入以下项之一,以运行 verifykeypackage.py 脚本:

    • 北美洲:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-NA-1 -w BYOK-SecurityWorld-pkg-NA-1
      
    • 欧洲:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-EU-1 -w BYOK-SecurityWorld-pkg-EU-1
      
    • 亚洲:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-AP-1 -w BYOK-SecurityWorld-pkg-AP-1
      
    • 拉丁美洲:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-LATAM-1 -w BYOK-SecurityWorld-pkg-LATAM-1
      
    • 日本:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-JPN-1 -w BYOK-SecurityWorld-pkg-JPN-1
      
    • 韩国:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-KOREA-1 -w BYOK-SecurityWorld-pkg-KOREA-1
      
    • 对于南非:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-SA-1 -w BYOK-SecurityWorld-pkg-SA-1
      
    • 对于阿拉伯联合酋长国:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-UAE-1 -w BYOK-SecurityWorld-pkg-UAE-1
      
    • 澳大利亚:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-AUS-1 -w BYOK-SecurityWorld-pkg-AUS-1
      
    • 对于 Azure Government,会使用美国政府的 Azure 实例:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-USGOV-1 -w BYOK-SecurityWorld-pkg-USGOV-1
      
    • 美国政府国防部:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-USDOD-1 -w BYOK-SecurityWorld-pkg-USDOD-1
      
    • 加拿大:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-CANADA-1 -w BYOK-SecurityWorld-pkg-CANADA-1
      
    • 德国:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-GERMANY-1 -w BYOK-SecurityWorld-pkg-GERMANY-1
      
    • 对于德国公共部门:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-GERMANY-1 -w BYOK-SecurityWorld-pkg-GERMANY-1
      
    • 印度:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-INDIA-1 -w BYOK-SecurityWorld-pkg-INDIA-1
      
    • 对于法国:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-FRANCE-1 -w BYOK-SecurityWorld-pkg-FRANCE-1
      
    • 英国:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-UK-1 -w BYOK-SecurityWorld-pkg-UK-1
      
    • 对于瑞士:

      "%nfast_home%\python\bin\python" verifykeypackage.py -k BYOK-KEK-pkg-SUI-1 -w BYOK-SecurityWorld-pkg-SUI-1
      

      TIP nCipher nShield 软件包含位于 %NFAST_HOME%\python\bin 中的 python

  2. 确认看到以下指示验证成功的消息:Result: SUCCESS

此脚本会验证直到 nShield 根密钥的签名程序链。 此根密钥的哈希嵌入到脚本中,其值应为 59178a47 de508c3f 291277ee 184f46c4 f1d9c639。 还可以通过访问 nCipher 网站单独确认此值。

现在已准备好创建新密钥。

步骤 3.5:新建密钥

通过使用 nCipher nShield generatekey 程序生成一个密钥。

运行以下命令来生成密钥:

generatekey --generate simple type=RSA size=2048 protect=module ident=contosokey plainname=contosokey nvram=no pubexp=

运行此命令时,请使用以下说明︰

  • 参数 protect 必须设置为值 module,如上所示。 这会创建一个受模块保护的密钥。 BYOK 工具集不支持受 OCS 保护的密钥。
  • 将 ident 和 plainname 的 contosokey 值替换为任何字符串值。 为了最大程度减少管理开销并降低错误风险,建议对这两个参数使用相同的值。 Ident 值只能包含数字、短划线和小写字母。
  • 在此示例中,pubexp 留空(默认值),但可以指定特定值。 有关详细信息,请参阅 nCipher 文档。

此命令在 %NFAST_KMDATA%\local 文件夹中创建一个标记化密钥文件,文件名以 key_simple_ 开头,后跟在命令中指定的 ident。 例如:key_simple_contosokey。 此文件包含已加密的密钥。

在安全位置备份这个标记化密钥文件。

Important: 稍后将自己的密钥传送到 Azure 密钥保管库时,Microsoft 就无法将此密钥导出返回给你,因此,请务必安全地备份密钥和安全体系。 请联系 nCipher,获取有关备份密钥的指导和最佳做法。

现在已准备好将密钥传输到 Azure 密钥保管库。

步骤 4:准备要传输的密钥

在步骤 4 中,请对断开连接的工作站执行以下过程。

步骤 4.1:使用减少权限创建密钥的副本

打开新命令提示符并将当前目录更改为解压缩 BYOK zip 文件的位置。 要减少密钥的权限,请从命令提示符处运行以下命令,具体要取决于所在的地理区域或 Azure 实例:

  • 北美洲:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-NA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-NA-
    
  • 欧洲:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-EU-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-EU-1
    
  • 亚洲:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-AP-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-AP-1
    
  • 拉丁美洲:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-LATAM-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-LATAM-1
    
  • 日本:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-JPN-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-JPN-1
    
  • 韩国:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-KOREA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-KOREA-1
    
  • 对于南非:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-SA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-SA-1
    
  • 对于阿拉伯联合酋长国:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-UAE-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-UAE-1
    
  • 澳大利亚:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-AUS-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-AUS-1
    
  • 对于 Azure Government,会使用美国政府的 Azure 实例:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-USGOV-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-USGOV-1
    
  • 美国政府国防部:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-USDOD-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-USDOD-1
    
  • 加拿大:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-CANADA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-CANADA-1
    
  • 德国:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-GERMANY-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-GERMANY-1
    
  • 对于德国公共部门:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-GERMANY-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-GERMANY-1
    
  • 印度:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-INDIA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-INDIA-1
    
  • 对于法国:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-FRANCE-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-FRANCE-1
    
  • 英国:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-UK-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-UK-1
    
  • 对于瑞士:

    KeyTransferRemote.exe -ModifyAcls -KeyAppName simple -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-SUI-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-SUI-1
    

运行此命令时,请将 contosokey 替换为在生成密钥步骤的“步骤 3.5:新建密钥”中指定的相同值。

系统会要求插入安全体系的管理员卡。

此命令完成后,会看到 Result: SUCCESS,同时权限减少的密钥副本位于名为 key_xferacId_<contosokey> 的文件中。

可使用 nCipher nShield 实用程序通过以下命令检查 ACLS:

  • aclprint.py:

    "%nfast_home%\bin\preload.exe" -m 1 -A xferacld -K contosokey "%nfast_home%\python\bin\python" "%nfast_home%\python\examples\aclprint.py"
    
  • kmfile-dump.exe:

    "%nfast_home%\bin\kmfile-dump.exe" "%NFAST_KMDATA%\local\key_xferacld_contosokey"
    

    运行这些命令时,将 contosokey 替换为在生成密钥步骤的“步骤 3.5:新建密钥”中指定的相同值。

步骤 4.2:使用 Microsoft 的密钥交换密钥加密密钥

运行以下一项命令,具体要取决于所在的地理区域或 Azure 实例:

  • 北美洲:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-NA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-NA-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 欧洲:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-EU-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-EU-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 亚洲:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-AP-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-AP-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 拉丁美洲:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-LATAM-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-LATAM-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 日本:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-JPN-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-JPN-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 韩国:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-KOREA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-KOREA-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于南非:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-SA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-SA-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于阿拉伯联合酋长国:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-UAE-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-UAE-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 澳大利亚:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-AUS-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-AUS-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于 Azure Government,会使用美国政府的 Azure 实例:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-USGOV-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-USGOV-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 美国政府国防部:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-USDOD-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-USDOD-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 加拿大:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-CANADA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-CANADA-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 德国:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-GERMANY-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-GERMANY-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于德国公共部门:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-GERMANY-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-GERMANY-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 印度:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-INDIA-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-INDIA-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于法国:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-France-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-France-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 英国:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-UK-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-UK-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    
  • 对于瑞士:

    KeyTransferRemote.exe -Package -KeyIdentifier contosokey -ExchangeKeyPackage BYOK-KEK-pkg-SUI-1 -NewSecurityWorldPackage BYOK-SecurityWorld-pkg-SUI-1 -SubscriptionId SubscriptionID -KeyFriendlyName ContosoFirstHSMkey
    

运行此命令时,请使用以下说明︰

  • 将 contosokey 替换为用于在生成密钥步骤的“步骤 3.5:新建密钥”中生成密钥的标识符。
  • 将 SubscriptionID 替换为包含密钥保管库的 Azure 订阅 ID。 以前已在 准备连接到 Internet 的工作站步骤的 步骤 1.2:获取 Azure 订阅 ID 中检索此值。
  • 将 ContosoFirstHSMKey 替换为用于输出文件名称的标签。

此操作成功完成后,会显示“结果: 成功”,并且包含 KeyTransferPackage-ContosoFirstHSMkey.byok 的当前文件夹中会出现一个新文件

步骤 4.3:将密钥传输包复制到连接 Internet 的工作站

使用 U 盘或其他便携式存储设备,将上一步的输出文件 (KeyTransferPackage-ContosoFirstHSMkey.byok) 复制到连接 Internet 的工作站。

步骤 5:将密钥传输到 Azure 密钥保管库

在此最后一步中,在连接 Internet 的工作站上,使用 Add-AzKeyVaultKey cmdlet 上传从断开连接的工作站复制到 Azure 密钥保管库 HSM 的密钥传输包:

     Add-AzKeyVaultKey -VaultName 'ContosoKeyVaultHSM' -Name 'ContosoFirstHSMkey' -KeyFilePath 'c:\KeyTransferPackage-ContosoFirstHSMkey.byok' -Destination 'HSM'

如果上传成功,会看到刚添加的密钥的属性。

后续步骤

现在可以在密钥保管库中使用此受 HSM 保护的密钥。 有关详细信息,请参阅此价格和功能比较。

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 amitbapat)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 05/29/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。