管理安全密钥

March 4, 2021

贡献者:

C G

注意：

必须将此功能与 StoreFront 1912 LTSR CU2 或更高版本结合使用。

此功能允许您仅允许批准的 StoreFront 计算机和 Citrix Gateway 计算机与 Citrix Cloud 进行通信。启用此功能后，将阻止不包含该密钥的任何请求。使用此功能可添加额外的安全层，以防止来自内部网络的攻击。

使用此功能的常规工作流程如下：

通过使用 PowerShell SDK 在 Studio 中启用该功能。
在 Studio 中配置各项设置。（使用 Studio 控制台或 PowerShell）。
在 StoreFront 中配置各项设置。（使用 PowerShell）。

启用安全密钥功能

默认情况下，该功能处于禁用状态。要将其启用，请使用远程 PowerShell SDK。有关远程 PowerShell SDK 的详细信息，请参阅 SDK 和 API。

要启用此功能，请执行以下步骤：

运行 Citrix Virtual Apps and Desktops 远程 PowerShell SDK。
在命令窗口中，运行以下命令：
- Add-PSSnapIn Citrix*。此命令将添加 Citrix 管理单元。
- Set-ConfigSiteMetadata -Name "Citrix_DesktopStudio_SecurityKeyManagementEnabled" -Value "True"

在 Studio 中配置各项设置

您可以通过使用 Studio 控制台或 PowerShell 在 Studio 中配置各项设置。

使用 Studio 控制台

启用该功能后，请导航到 Studio > 配置 > 管理安全密钥。您可能需要单击刷新才能显示管理安全密钥选项。

单击管理安全密钥后，将显示管理安全密钥窗口。

“管理安全密钥”向导

重要：

有两个密钥可供使用。通过 XML 和 STA 端口进行通信时，您可以使用相同的密钥或不同的密钥。我们建议您一次仅使用一个密钥。未使用的密钥仅用于密钥轮换。

请勿单击刷新图标以更新已在使用的密钥。如果这样做，将会发生服务中断。

单击刷新图标以生成新密钥。

需要密钥才能通过 XML 端口进行通信(仅限 StoreFront)。如果选择此选项，则需要密钥才能对通过 XML 端口进行的通信执行身份验证。StoreFront 通过此端口与 Citrix Cloud 进行通信。有关更改 XML 端口的信息，请参阅知识中心文章 CTX127945。

需要密钥才能通过 STA 端口进行通信。如果选择此选项，则需要密钥才能对通过 STA 端口进行的通信执行身份验证。Citrix Gateway 和 StoreFront 通过此端口与 Citrix Cloud 进行通信。有关更改 STA 端口的信息，请参阅知识中心文章 CTX101988。

应用更改后，单击关闭退出管理安全密钥窗口。

使用 PowerShell

以下是相当于 Studio 操作的 PowerShell 步骤。

运行 Citrix Virtual Apps and Desktops 远程 PowerShell SDK。
在命令窗口中，运行以下命令：
- Add-PSSnapIn Citrix*
运行以下命令以生成密钥并设置 Key1：
- New-BrokerXmlServiceKey
- Set-BrokerSite -XmlServiceKey1 <the key you generated>
运行以下命令以生成密钥并设置 Key2：
- New-BrokerXmlServiceKey
- Set-BrokerSite -XmlServiceKey2 <the key you generated>
运行以下一个或两个命令以在对通信进行身份验证时使用密钥：
- 要对通过 XML 端口进行的通信执行身份验证，请执行以下操作：
  - Set-BrokerSite -RequireXmlServiceKeyForNFuse $true
- 要对通过 STA 端口进行的通信执行身份验证，请执行以下操作：
  - Set-BrokerSite -RequireXmlServiceKeyForSta $true

有关指导和语法，请参阅 PowerShell 命令帮助。

在 StoreFront 中配置各项设置

在 Studio 中完成配置后，您需要在 StoreFront 中使用 PowerShell 配置相关设置。

在 StoreFront 服务器上，运行以下 PowerShell 命令：

要配置通过 XML 端口进行通信所需的密钥，请使用 Get-STFStoreServie 和 Set-STFStoreService 命令。例如：
- PS C:\> Set-STFStoreFarm $farm -Farmtype XenDesktop -Port 80 -TransportType HTTP -Servers <domain name1, domain name2> -XMLValidationEnabled $true -XMLValidationSecret <the key you generated in Studio>
要配置通过 STA 端口进行通信所需的密钥，请使用 New-STFSecureTicketAuthority 命令。例如：
- PS C:\> $sta = New-STFSecureTicketAuthority –StaUrl <STA URL> -StaValidationEnabled $true -StavalidationSecret <the key you generated in Studio>

有关指导和语法，请参阅 PowerShell 命令帮助。

本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

管理安全密钥

March 4, 2021

贡献者:

C G

March 4, 2021

贡献者:

C G