Sicherheitsschlüssel verwalten
Hinweis:
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.
Mit dieser Funktion können Sie nur zugelassenen StoreFront- und Citrix Gateway-Maschinen die Kommunikation mit Citrix Delivery Controllern 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:
-
Studio aktivieren, um die Funktionseinstellungen anzuzeigen.
-
Einstellungen für Ihre Site konfigurieren.
-
Einstellungen in StoreFront konfigurieren.
-
Einstellungen in Citrix ADC konfigurieren.
Studio aktivieren, um die Funktionseinstellungen anzuzeigen
Standardmäßig sind die Einstellungen für Sicherheitsschlüssel in Studio ausgeblendet. Um Studio zu ermöglichen, sie anzuzeigen, verwenden Sie das PowerShell SDK wie folgt:
- Führen Sie das Citrix Virtual Apps and Desktops™ PowerShell SDK aus.
- Führen Sie in einem Befehlsfenster die folgenden Befehle aus:
-
Add-PSSnapIn Citrix*. Dieser Befehl fügt die Citrix Snap-Ins hinzu. Set-ConfigSiteMetadata -Name "Citrix_DesktopStudio_SecurityKeyManagementEnabled" -Value "True"
-
Weitere Informationen zum PowerShell SDK finden Sie unter SDKs und APIs.
Einstellungen für die Site konfigurieren
Sie können Studio oder PowerShell verwenden, um Sicherheitsschlüsseleinstellungen für Ihre Site zu konfigurieren.
Studio-Konsole verwenden
-
Navigieren Sie zu Studio > Einstellungen > Sicherheitsschlüssel verwalten und klicken Sie auf Bearbeiten. Das Fenster Sicherheitsschlüssel verwalten wird angezeigt.
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.
-
Klicken Sie auf das Aktualisierungssymbol, um neue Schlüssel zu generieren.
-
Wählen Sie aus, wo ein Schlüssel 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
Die folgenden PowerShell-Schritte entsprechen den Studio-Vorgängen.
-
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 und Syntax finden Sie in der PowerShell-Befehlshilfe.
Einstellungen in StoreFront konfigurieren
Nachdem Sie die Konfiguration für Ihre Site abgeschlossen haben, müssen Sie die relevanten Einstellungen in StoreFront mithilfe von PowerShell konfigurieren.
Führen Sie auf dem StoreFront-Server die folgenden PowerShell-Befehle aus:
| Verwenden Sie zum Konfigurieren des Schlüssels für die Kommunikation über den XML-Port 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
Verwenden Sie zum Konfigurieren des Schlüssels für die Kommunikation über den STA-Port 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
Siehe die PowerShell-Befehlshilfe für Anleitungen und Syntax.
Einstellungen in Citrix ADC konfigurieren
Hinweis:
Das Konfigurieren dieser Funktion in Citrix ADC ist nur erforderlich, wenn Sie Citrix ADC als Ihr 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 Ermöglichung 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 Lastenausgleichs, 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, navigieren Sie in der Citrix ADC GUI zu System > Einstellungen > Modus konfigurieren.
- Um die Funktionen zu aktivieren, navigieren Sie in der Citrix ADC GUI zu System > Einstellungen > Grundlegende Funktionen konfigurieren.
- Zertifikatsbezogene Konfigurationen sind abgeschlossen.
- Die Zertifikatsignieranforderung (CSR) wird erstellt. Weitere Informationen finden Sie unter Zertifikat erstellen.
- Die Server- und CA-Zertifikate sowie die 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.
- Navigieren Sie zu AppExpert > Rewrite > Actions.
- Klicken Sie auf Add, um eine neue Rewrite-Aktion hinzuzufügen. Sie können die Aktion als „set Type to INSERT_HTTP_HEADER“ benennen.
- 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.
-
Navigieren Sie zu AppExpert > Rewrite > Policies.
-
Klicken Sie auf Hinzufügen, 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.
- Navigieren Sie zu Traffic Management > Load Balancing > Servers.
- Klicken Sie auf der Seite Virtuelle Server auf Hinzufügen.
- Wählen Sie unter Protokoll HTTP aus.
- Fügen Sie die virtuelle IP-Adresse für den Lastausgleich hinzu und wählen Sie unter Port 80 aus.
- Klicken Sie auf OK.
- Erstellen Sie einen Lastausgleichsdienst.
- Navigieren 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 aus.
- 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 Erweiterte Einstellungen auf Richtlinien, und dann im Abschnitt Richtlinien auf +.
- Wählen Sie unter Richtlinie auswählen die Option Rewrite und unter Typ auswählen die Option Anfrage.
- Klicken Sie auf Weiter.
- 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 den Persistenztyp als 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 eine Netzmaske hinzu, die der des DDC entspricht.
- 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 Sitzungsstart 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 den Citrix ADC jedoch bereits für Citrix Virtual Desktops konfiguriert hat, istTrustRequestsSentToTheXmlServicePortauf True gesetzt.
- Navigieren Sie in der Citrix ADC GUI zu Configuration > Integrate with Citrix Products und klicken Sie auf XenApp and XenDesktop®.
-
Wählen Sie die Gateway-Instanz aus und klicken Sie auf das Bearbeitungssymbol.
-
Klicken Sie im StoreFront-Bereich auf das Bearbeitungssymbol.
- Fügen Sie die Secure Ticket Authority URL hinzu.
- Wenn die Secure XML-Funktion aktiviert ist, muss die STA-URL die URL des Lastausgleichsdienstes sein.
- Wenn die Secure XML-Funktion deaktiviert ist, muss die STA-URL die URL der STA (Adresse des DDC) sein und der Parameter TrustRequestsSentToTheXmlServicePort auf dem DDC muss auf True gesetzt werden.
