Sicherheitsschlüssel verwalten
Hinweis:
Sie müssen diese Funktion in Kombination mit StoreFront™ 1912 LTSR CU2 oder höher verwenden.
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:
-
Aktivieren Sie Studio, um die Funktionseinstellungen anzuzeigen.
-
Konfigurieren Sie die Einstellungen für Ihre Site (verwenden Sie die Studio-Konsole oder PowerShell).
-
Konfigurieren Sie die Einstellungen in StoreFront (verwenden Sie PowerShell).
-
Konfigurieren Sie die Einstellungen in Citrix ADC (verwenden Sie PowerShell).
Aktivieren Sie Studio, 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 die folgenden Schritte aus, um die Funktion zu aktivieren:
- Führen Sie das Citrix Virtual Apps and Desktops™ Remote 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 Remote PowerShell SDK finden Sie unter SDKs und APIs.
Einstellungen für Ihre Site konfigurieren
Sie können Einstellungen in Studio über die Studio-Konsole oder PowerShell konfigurieren.
Studio-Konsole verwenden
Nachdem Sie Studio aktiviert haben, um die Featureeinstellungen anzuzeigen, navigieren Sie zu Studio > Konfiguration > Sicherheitsschlüssel verwalten. Möglicherweise müssen Sie auf Aktualisieren klicken, damit die Option Sicherheitsschlüssel verwalten angezeigt wird.
Das Fenster Sicherheitsschlüssel verwalten wird angezeigt, nachdem Sie auf Sicherheitsschlüssel verwalten geklickt haben.
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.
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.
Nachdem Sie Ihre Änderungen angewendet haben, klicken Sie auf Schließen, um das Fenster Sicherheitsschlüssel verwalten zu verlassen.
PowerShell verwenden
Im Folgenden sind PowerShell-Schritte aufgeführt, die den 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:
- So authentifizieren Sie die Kommunikation über den XML-Port:
Set-BrokerSite -RequireXmlServiceKeyForNFuse $true
- So authentifizieren Sie die Kommunikation über den STA-Port:
Set-BrokerSite -RequireXmlServiceKeyForSta $true
- So authentifizieren Sie die Kommunikation über den XML-Port:
Informationen und Syntax finden Sie in der PowerShell-Befehlshilfe.
Einstellungen in StoreFront konfigurieren
Nach Abschluss der Konfiguration in Studio müssen Sie die relevanten Einstellungen in StoreFront mit 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 und Syntax finden Sie in der PowerShell-Befehlshilfe.
Einstellungen in Citrix ADC konfigurieren
Hinweis:
Die Konfiguration dieser Funktion in Citrix ADC ist nicht erforderlich, es sei denn, Sie verwenden Citrix ADC als Gateway. 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 Erstellen eines virtuellen Servers.
- 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.
- Der Zertifikatsignierungsantrag (CSR) wird erstellt. Details finden Sie unter Zertifikat erstellen.
- Die Server- und CA-Zertifikate sowie die Stammzertifikate sind installiert. Details 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 STA-Konnektivität testen klicken, um zu bestätigen, dass die virtuellen Server online sind. Details 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. Details finden Sie unter Konfigurieren einer Rewrite-Aktion.
- Gehen Sie zu AppExpert > Rewrite > Aktionen.
- Klicken Sie auf Hinzufügen, um eine Rewrite-Aktion hinzuzufügen. Sie können die Aktion als „Typ auf INSERT_HTTP_HEADER setzen“ benennen.
- Wählen Sie unter Typ die Option INSERT_HTTP_HEADER aus.
- Geben Sie unter Header-Name den Wert X-Citrix-XmlServiceKey ein.
- Fügen Sie unter Ausdruck
<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 Richtlinie hinzuzufügen.
- Wählen Sie unter Action die im vorherigen Schritt erstellte Aktion aus.
- Fügen Sie unter Expression 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 Virtual Servers auf Add.
- Wählen Sie unter Protocol 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 Lastenausgleichsdienst.
- 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.
- Unter Erweiterte Einstellungen klicken Sie auf Richtlinien, und klicken Sie dann im Abschnitt Richtlinien auf +.
- Wählen Sie unter Richtlinie auswählen die Option Rewrite und unter Typ auswählen die Option Anforderung.
- 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 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 die gleiche 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 Sitzungsstart die Security Ticket Authority URL des Gateways, um die FQDNs der Lastenausgleichs-Virtual Server zu verwenden.
- Stellen Sie sicher, dass der
TrustRequestsSentToTheXmlServicePortParameter auf False gesetzt ist. Standardmäßig ist derTrustRequestsSentToTheXmlServicePortParameter auf False gesetzt. Wenn der Kunde die Citrix ADC jedoch bereits für Citrix Virtual Desktops konfiguriert hat, ist derTrustRequestsSentToTheXmlServicePortauf True gesetzt.
- Gehen 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 Lastenausgleichsdienstes 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.
