Sicherheitsschlüssel verwalten
Wichtig:
- Sie müssen diese Funktion in Kombination mit StoreFront™ 1912 LTSR CU2 oder höher verwenden.
- Die Secure XML-Funktion wird nur auf Citrix ADC und Citrix Gateway Release 12.1 und höher unterstützt.
Hinweis:
Sie können Ihre Citrix Virtual Apps and Desktops™-Bereitstellung mit zwei Verwaltungskonsolen verwalten: Web Studio (webbasiert) und Citrix Studio (Windows-basiert). Dieser Artikel behandelt nur Web Studio. Informationen zu Citrix Studio finden Sie im entsprechenden Artikel in Citrix Virtual Apps and Desktops 7 2212 oder früher.
Diese Funktion ermöglicht es Ihnen, nur genehmigten StoreFront- und Citrix Gateway-Maschinen die Kommunikation mit Delivery Controllern zu gestatten. Nachdem Sie diese Funktion aktiviert haben, werden alle Anfragen blockiert, die den Schlüssel nicht enthalten. Verwenden Sie diese Funktion, um eine zusätzliche Sicherheitsebene zum Schutz vor Angriffen aus dem internen Netzwerk hinzuzufügen.
Ein allgemeiner Workflow zur Verwendung dieser Funktion ist wie folgt:
-
Aktivieren Sie Web Studio, um die Funktionseinstellungen anzuzeigen.
-
Konfigurieren Sie die Einstellungen für Ihre Site.
-
Konfigurieren Sie die Einstellungen für StoreFront.
-
Konfigurieren Sie die Einstellungen für Citrix ADC.
Einstellungen für die Site konfigurieren
Sie können Web Studio oder PowerShell verwenden, um Sicherheitsschlüsseleinstellungen für Ihre Site zu konfigurieren.
Web Studio verwenden
- Melden Sie sich bei Web Studio an und wählen Sie im linken Bereich Einstellungen aus.
-
Suchen Sie die Kachel Sicherheitsschlüssel verwalten und klicken Sie auf Bearbeiten. Die Seite Sicherheitsschlüssel verwalten wird angezeigt.

-
Klicken Sie auf das Aktualisierungssymbol, um die Schlüssel zu generieren.
Wichtig:
- Es stehen zwei Schlüssel zur Verfügung. Sie können denselben Schlüssel oder verschiedene Schlüssel für die Kommunikation über die XML- und STA-Ports verwenden. Wir empfehlen, jeweils nur einen Schlüssel zu verwenden. Der ungenutzte Schlüssel wird nur für die Schlüsselrotation verwendet.
- Klicken Sie nicht auf das Aktualisierungssymbol, um den bereits verwendeten Schlüssel zu aktualisieren. Andernfalls kommt es zu einer Dienstunterbrechung.
-
Wählen Sie aus, wo ein Schlüssel für die Kommunikation erforderlich ist:
-
Schlüssel für die Kommunikation über den XML-Port erforderlich (nur StoreFront). Wenn diese Option ausgewählt ist, ist ein Schlüssel zur Authentifizierung der Kommunikation über den XML-Port erforderlich. StoreFront kommuniziert über diesen Port mit Citrix Cloud. Informationen zum Ändern des XML-Ports finden Sie im Knowledge Center-Artikel CTX127945.
-
Schlüssel für die Kommunikation über den STA-Port erforderlich. Wenn diese Option ausgewählt ist, ist ein Schlüssel zur Authentifizierung der Kommunikation über den STA-Port erforderlich. Citrix Gateway und StoreFront kommunizieren über diesen Port mit Citrix Cloud. Informationen zum Ändern des STA-Ports finden Sie im Knowledge Center-Artikel CTX101988.
-
- Klicken Sie auf Speichern, um Ihre Änderungen zu übernehmen und das Fenster zu schließen.
PowerShell verwenden
Im Folgenden sind PowerShell-Schritte aufgeführt, die den Web Studio-Vorgängen entsprechen.
-
Führen Sie das Citrix Virtual Apps and Desktops Remote PowerShell SDK aus.
- Führen Sie in einem Befehlsfenster den folgenden Befehl aus:
Add-PSSnapIn Citrix*
- Führen Sie die folgenden Befehle aus, um einen Schlüssel zu generieren und Key1 einzurichten:
New-BrokerXmlServiceKeySet-BrokerSite -XmlServiceKey1 <the key you generated>
- Führen Sie die folgenden Befehle aus, um einen Schlüssel zu generieren und Key2 einzurichten:
New-BrokerXmlServiceKeySet-BrokerSite -XmlServiceKey2 <the key you generated>
- Führen Sie einen oder beide der folgenden Befehle aus, um die Verwendung eines Schlüssels zur Authentifizierung der Kommunikation zu aktivieren:
- Zur Authentifizierung der Kommunikation über den XML-Port:
Set-BrokerSite -RequireXmlServiceKeyForNFuse $true
- Zur Authentifizierung der Kommunikation über den STA-Port:
Set-BrokerSite -RequireXmlServiceKeyForSta $true
- Zur Authentifizierung der Kommunikation über den XML-Port:
Informationen zu Anleitung und Syntax finden Sie in der PowerShell-Befehlshilfe.
Einstellungen für StoreFront konfigurieren
Nach Abschluss der Konfiguration für Ihre Site müssen Sie die relevanten Einstellungen für StoreFront mithilfe von PowerShell konfigurieren.
Führen Sie auf dem StoreFront-Server die folgenden PowerShell-Befehle aus:
| Um den Schlüssel für die Kommunikation über den XML-Port zu konfigurieren, verwenden Sie den Befehl [Set-STFStoreFarm | https://developer-docs.citrix.com/de-de/storefront-powershell-sdk/current-release/Set-STFStoreFarm.html]. Beispiel |
$store = Get-STFStoreService -VirtualPath [Path to store]
$farm = Get-STFStoreFarm -StoreService $store -FarmName [Resource feed name]
Set-STFStoreFarm -Farm $farm -XMLValidationEnabled $true -XMLValidationSecret [secret]
<!--NeedCopy-->
Geben Sie die entsprechenden Werte für die folgenden Parameter ein:
Path to storeResource feed namesecret
Um den Schlüssel für die Kommunikation über den STA-Port zu konfigurieren, verwenden Sie die Befehle New-STFSecureTicketAuthority und Set-STFRoamingGateway. Beispiel:
$gateway = Get-STFRoamingGateway -Name [Gateway name]
$sta1 = New-STFSecureTicketAuthority -StaUrl [STA1 URL] -StaValidationEnabled $true -StaValidationSecret [secret]
$sta2 = New-STFSecureTicketAuthority -StaUrl [STA2 URL] -StaValidationEnabled $true -StaValidationSecret [secret]
Set-STFRoamingGateway -Gateway $gateway -SecureTicketAuthorityObjs $sta1,$sta2
<!--NeedCopy-->
Geben Sie die entsprechenden Werte für die folgenden Parameter ein:
Gateway nameSTA URLSecret
Informationen zu Anleitung und Syntax finden Sie in der PowerShell-Befehlshilfe.
Einstellungen für Citrix ADC konfigurieren
Hinweis:
Die Konfiguration dieser Funktion für Citrix ADC ist nur erforderlich, wenn Sie Citrix ADC als Gateway verwenden. Wenn Sie Citrix ADC verwenden, führen Sie die folgenden Schritte aus:
-
Stellen Sie sicher, dass die folgende Voraussetzungskonfiguration bereits vorhanden ist:
- Die folgenden Citrix ADC-bezogenen IP-Adressen sind konfiguriert.
- Citrix ADC Management-IP-Adresse (NSIP) für den Zugriff auf die Citrix ADC Konsole. Weitere Informationen finden Sie unter Konfigurieren der NSIP-Adresse.

- Subnetz-IP-Adresse (SNIP) zur Aktivierung der Kommunikation zwischen der Citrix ADC Appliance und den Back-End-Servern. Weitere Informationen finden Sie unter Konfigurieren von Subnetz-IP-Adressen.
- Virtuelle IP-Adresse von Citrix Gateway und virtuelle IP-Adresse des Lastausgleichs, um sich bei der ADC Appliance für den Sitzungsstart anzumelden. Weitere Informationen finden Sie unter Einen virtuellen Server erstellen.

- Die erforderlichen Modi und Funktionen in der Citrix ADC Appliance sind aktiviert.
- Um die Modi zu aktivieren, gehen Sie in der Citrix ADC GUI zu System > Settings > Configure Mode.
- Um die Funktionen zu aktivieren, gehen Sie in der Citrix ADC GUI zu System > Settings > Configure Basic Features.
- Zertifikatsbezogene Konfigurationen sind abgeschlossen.
- Die Zertifikatsignieranforderung (CSR) ist erstellt. Weitere Informationen finden Sie unter Ein Zertifikat erstellen.

- Die Server- und CA-Zertifikate sowie Stammzertifikate sind installiert. Weitere Informationen finden Sie unter Installieren, Verknüpfen und Aktualisieren.


- Ein Citrix Gateway wurde für Citrix Virtual Desktops erstellt. Testen Sie die Konnektivität, indem Sie auf die Schaltfläche Test STA Connectivity klicken, um zu bestätigen, dass die virtuellen Server online sind. Weitere Informationen finden Sie unter Einrichten von Citrix ADC für Citrix Virtual Apps and Desktops.

- Die folgenden Citrix ADC-bezogenen IP-Adressen sind konfiguriert.
-
Fügen Sie eine Rewrite-Aktion hinzu. Weitere Informationen finden Sie unter Konfigurieren einer Rewrite-Aktion.
- Gehen Sie zu AppExpert > Rewrite > Actions.
- Klicken Sie auf Add, um eine neue Rewrite-Aktion hinzuzufügen. Sie können die Aktion „set Type to INSERT_HTTP_HEADER“ nennen.

- Wählen Sie unter Type die Option INSERT_HTTP_HEADER aus.
- Geben Sie unter Header Name den Wert X-Citrix-XmlServiceKey ein.
- Fügen Sie unter Expression
<XmlServiceKey1 value>mit den Anführungszeichen hinzu. Sie können den Wert XmlServiceKey1 aus Ihrer Desktop Delivery Controller™-Konfiguration kopieren.

- Fügen Sie eine Rewrite-Richtlinie hinzu. Weitere Informationen finden Sie unter Konfigurieren einer Rewrite-Richtlinie.
-
Gehen Sie zu AppExpert > Rewrite > Policies.
-
Klicken Sie auf Add, um eine neue Richtlinie hinzuzufügen.

- Wählen Sie unter Aktion die im vorherigen Schritt erstellte Aktion aus.
- Fügen Sie unter Ausdruck HTTP.REQ.IS_VALID hinzu.
- Klicken Sie auf OK.
-
-
Richten Sie den Lastausgleich ein. Sie müssen einen virtuellen Lastausgleichsserver pro STA-Server konfigurieren. Andernfalls können die Sitzungen nicht gestartet werden.
Weitere Informationen finden Sie unter Grundlegenden Lastausgleich einrichten.
- Erstellen Sie einen virtuellen Lastausgleichsserver.
- Gehen Sie zu Traffic Management > Load Balancing > Servers.
- Klicken Sie auf der Seite Virtuelle Server auf Hinzufügen.

- Wählen Sie unter Protokoll die Option HTTP aus.
- Fügen Sie die virtuelle IP-Adresse für den Lastausgleich hinzu und wählen Sie unter Port die Option 80 aus.
- Klicken Sie auf OK.
- Erstellen Sie einen Lastausgleichsdienst.
- Gehen Sie zu Traffic Management > Load Balancing > Services.

- Wählen Sie unter Existing Server den im vorherigen Schritt erstellten virtuellen Server aus.
- Wählen Sie unter Protocol die Option HTTP und unter Port die Option 80.
- Klicken Sie auf OK und dann auf Done.
- Binden Sie den Dienst an den virtuellen Server.
- Wählen Sie den zuvor erstellten virtuellen Server aus und klicken Sie auf Edit.
- Klicken Sie unter Services and Service Groups auf No Load Balancing Virtual Server Service Binding.

- Wählen Sie unter Service Binding den zuvor erstellten Dienst aus.
- Klicken Sie auf Bind.
- Binden Sie die zuvor erstellte Rewrite-Richtlinie an den virtuellen Server.
- Wählen Sie den zuvor erstellten virtuellen Server aus und klicken Sie auf Edit.
- Klicken Sie unter Advanced Settings auf Policies und dann im Abschnitt Policies auf +.

- Wählen Sie unter Choose Policy die Option Rewrite und unter Choose Type die Option Request.
- Klicken Sie auf Continue.
- Wählen Sie unter Richtlinie auswählen die zuvor erstellte Rewrite-Richtlinie aus.
- Klicken Sie auf Binden.
- Klicken Sie auf Fertig.
- Richten Sie bei Bedarf die Persistenz für den virtuellen Server ein.
- Wählen Sie den zuvor erstellten virtuellen Server aus und klicken Sie auf Bearbeiten.
- Klicken Sie unter Erweiterte Einstellungen auf Persistenz.

- Wählen Sie als Persistenztyp Andere aus.
- Wählen Sie DESTIP, um Persistenzsitzungen basierend auf der IP-Adresse des vom virtuellen Server ausgewählten Dienstes (der Ziel-IP-Adresse) zu erstellen.
- Fügen Sie unter IPv4-Netzmaske dieselbe Netzmaske wie die des DDC hinzu.
- Klicken Sie auf OK.
- Wiederholen Sie diese Schritte auch für den anderen virtuellen Server.
- Erstellen Sie einen virtuellen Lastausgleichsserver.
Konfigurationsänderungen, wenn die Citrix ADC Appliance bereits mit Citrix Virtual Desktops™ konfiguriert ist
Wenn Sie die Citrix ADC Appliance bereits mit Citrix Virtual Desktops konfiguriert haben, müssen Sie die folgenden Konfigurationsänderungen vornehmen, um die Secure XML-Funktion zu verwenden.
- Ändern Sie vor dem Start der Sitzung die Security Ticket Authority URL des Gateways, um die FQDNs der virtuellen Lastausgleichsserver zu verwenden.
- Stellen Sie sicher, dass der Parameter
TrustRequestsSentToTheXmlServicePortauf False gesetzt ist. Standardmäßig ist der ParameterTrustRequestsSentToTheXmlServicePortauf False gesetzt. Wenn der Kunde Citrix ADC jedoch bereits für Citrix Virtual Desktops konfiguriert hat, istTrustRequestsSentToTheXmlServicePortauf True gesetzt.
- Gehen Sie in der Citrix ADC-GUI zu Konfiguration > Integration mit Citrix-Produkten und klicken Sie auf XenApp and XenDesktop®.
-
Wählen Sie die Gateway-Instanz aus und klicken Sie auf das Bearbeitungssymbol.
Vorhandene Gateway-Konfiguration bearbeiten(/de-de/citrix-virtual-apps-desktops/2507-ltsr/media/edit-gateway-instance.png)
-
Klicken Sie im StoreFront-Bereich auf das Bearbeitungssymbol.
StoreFront-Details bearbeiten(/de-de/citrix-virtual-apps-desktops/2507-ltsr/media/edit-storefront-details.png)
- Fügen Sie die Secure Ticket Authority-URL hinzu.
- Wenn die Secure XML-Funktion aktiviert ist, muss die STA-URL die URL des Lastenausgleichsdienstes sein.
- Wenn die Secure XML-Funktion deaktiviert ist, muss die STA-URL die URL der STA (Adresse des DDC) sein und der Parameter
TrustRequestsSentToTheXmlServicePortauf dem DDC muss auf True gesetzt sein.
STA-URLs hinzufügen(/de-de/citrix-virtual-apps-desktops/2507-ltsr/media/add-sta-urls.png)