Fehlerbehebung bei einigen häufigen Fehlern

Last published : Oct 24, 2026
Dieses Thema listet einige der Fehler auf, die bei der Einrichtung von Secure Private Access auftreten können.
Zertifikatfehler
Fehler bei der Datenbankerstellung
StoreFront-Fehler
Fehler bei öffentlichem Gateway/Callback-Gateway
Secure Private Access Server nicht erreichbar

Zertifikatfehler

Fehlermeldung: Zertifikate können nicht automatisch von einem oder mehreren Gateway-Servern abgerufen werden.
Diese Fehlermeldung wird angezeigt, wenn Sie versuchen, eine öffentliche NetScaler® Gateway-Adresse hinzuzufügen und ein Problem beim Abrufen des Zertifikats auftritt. Dieses Problem kann bei der Einrichtung von Secure Private Access oder beim Aktualisieren von Einstellungen nach Abschluss der Einrichtung auftreten.
Problemumgehung: Aktualisieren Sie das Gateway-Zertifikat auf die gleiche Weise, wie Sie es für Citrix Virtual Apps and Desktops tun würden.

Fehler bei der Datenbankerstellung

  • Fehlermeldung: Datenbank konnte nicht erstellt werden
    Lösung: Für den automatischen Fall – Der Computer muss über LESE-, SCHREIB- und AKTUALISIERUNGSberechtigungen verfügen, um Tabellen in der Datenbank auf dem SQL-Server zu erstellen.
  • Fehlermeldung: Datenbank konnte nicht erstellt werden: Eine Datenbank existiert bereits.
    Diese Fehlermeldung kann in einem der folgenden Szenarien auftreten.
    • Wenn die Option Automatische Konfiguration bei der Konfiguration der Datenbanken ausgewählt ist.
    • Wenn der Administrator eine Datenbank erstellt, muss es sich um eine leere Datenbank handeln. Diese Fehlermeldung kann erscheinen, wenn die Datenbank nicht leer ist.
      Lösung: Sie müssen eine leere Datenbank erstellen.
    • Sie deinstallieren Secure Private Access und versuchen die Einrichtung mit demselben Site-Namen erneut. In diesem Fall wäre die Datenbank der vorherigen Installation nicht gelöscht worden.
      Lösung: Sie müssen die Datenbank manuell löschen.
    • Sie entscheiden sich, die Datenbank manuell einzurichten (indem Sie auf der Seite „Datenbanken konfigurieren“ die Option „Manuelle Konfiguration“ auswählen) und verwenden dabei das Skript. Anschließend wechseln Sie zur Option „Automatische Konfiguration“, verwenden aber denselben Site-Namen. In diesem Fall ist bereits eine Datenbank mit demselben Namen beim Ausführen des Skripts erstellt worden.
      Lösung: Sie müssen die Site umbenennen und das Skript dann erneut ausführen.
    • Der Computer verfügt nicht über die READ-, WRITE-, UPDATE-Berechtigungen, um Tabellen in der Datenbank auf dem SQL-Server zu erstellen.
      Lösung: Aktivieren Sie die entsprechenden Berechtigungen auf dem Computer. Weitere Informationen finden Sie unter Erforderliche Berechtigungen zum Einrichten von Datenbanken.
  • Fehlermeldung: Datenbank konnte nicht erstellt werden: Verbindung fehlgeschlagen
    Lösung:
    • Überprüfen Sie die Datenbank-Netzwerkkonnektivität von Ihrem Computer aus. Stellen Sie sicher, dass der SQL-Server-Port in der Firewall geöffnet ist.
    • Wenn Sie einen Remote-SQL-Server verwenden, überprüfen Sie, ob der SQL-Server einen Login mit der Secure Private Access-Computeridentität, Domain\hostname$, erstellt hat.
    • Wenn Sie einen Remote-SQL-Server verwenden, bestätigen Sie, dass der Computeridentität die richtige Rolle zugewiesen ist, nämlich die Rolle des Systemadministrators.
    • Wenn Sie einen lokalen SQL-Server verwenden (nicht vom Installationsprogramm), prüfen Sie, ob für den Benutzer NT AUTHORITY\SYSTEM ein Login erstellt werden muss.

StoreFront™-Fehler

  • Fehlermeldung: Fehler beim Erstellen des StoreFront-Eintrags für: <Store URL>
    Aktualisieren Sie die StoreFront-Einträge auf der Registerkarte Einstellungen, falls sie nicht sichtbar sind. Nachdem Sie Secure Private Access mit dem Assistenten eingerichtet haben, können Sie StoreFront-Einträge auf der Registerkarte Einstellungen bearbeiten. Notieren Sie sich die StoreFront Store-URL, für die dieser Fehler aufgetreten ist.
    Lösung:
    1. Klicken Sie auf Einstellungen und dann auf die Registerkarte Integrationen.
    2. Fügen Sie unter StoreFront Store-URL den StoreFront-Eintrag hinzu, falls er nicht sichtbar ist.
  • Fehlermeldung: Fehler beim Konfigurieren des StoreFront-Eintrags für: <Store URL>
    Lösung:
    1. Es könnte eine PowerShell-Ausführungsrichtlinienbeschränkung vorliegen. Führen Sie den PowerShell-Skriptbefehl Get-ExecutionPolicy aus, um Details zu erhalten.
    2. Wenn dies eingeschränkt ist, müssen Sie dies umgehen und ein StoreFront-Konfigurationsskript manuell ausführen.
    3. Klicken Sie auf Einstellungen und dann auf die Registerkarte Integrationen.
    4. Identifizieren Sie unter StoreFront Store-URL den StoreFront-URL-Eintrag, für den der Fehler aufgetreten ist.
    5. Klicken Sie neben dieser Store-URL auf die Schaltfläche Skript herunterladen und führen Sie dieses PowerShell-Skript mit Administratorrechten auf dem Computer aus, auf dem die entsprechende StoreFront-Installation vorhanden ist. Dieses Skript muss auf allen StoreFront-Computern ausgeführt werden.
    Hinweis:
    Wenn Sie die Installation nach der Deinstallation erneut versuchen, stellen Sie sicher, dass kein Eintrag mit dem Namen „Secure Private Access“ in der StoreFront-Konfiguration vorhanden ist (StoreFront > store> Delivery Controller™ -> Secure Private Access). Wenn Secure Private Access vorhanden ist, löschen Sie diesen Eintrag. Laden Sie das Skript manuell von der Seite Einstellungen > Integrationen herunter und führen Sie es aus.
  • Fehlermeldung: StoreFront-Konfiguration ist nicht lokal für: <Store URL>
    Nachdem Sie Secure Private Access mit dem Assistenten eingerichtet haben, können Sie Gateway-Einträge auf der Registerkarte Einstellungen bearbeiten. Notieren Sie sich die StoreFront Store-URL, für die dieser Fehler aufgetreten ist.
    Lösung:
    Dieses Problem tritt auf, wenn StoreFront nicht auf derselben Maschine wie Secure Private Access installiert ist. Sie müssen die StoreFront-Konfiguration manuell auf der Maschine ausführen, auf der Sie StoreFront installiert haben.
    1. Klicken Sie auf Einstellungen und dann auf die Registerkarte Integrationen.
    2. Unter StoreFront Store-URL identifizieren Sie den StoreFront-URL-Eintrag, für den der Fehler aufgetreten ist.
    3. Klicken Sie auf die Schaltfläche Skript herunterladen neben dieser Store-URL und führen Sie dieses PowerShell-Skript mit Administratorrechten auf der Maschine aus, auf der die entsprechende StoreFront-Installation vorhanden ist. Dieses Skript muss auf allen StoreFront-Maschinen ausgeführt werden.
    Hinweis:
    Um das StoreFront PowerShell-Skript auszuführen, öffnen Sie das Windows x64-kompatible PowerShell-Fenster mit Administratorrechten und führen Sie dann ConfigureStorefront.ps1 aus. Das StoreFront-Skript ist nicht mit Windows PowerShell (x86) kompatibel.
  • Fehlermeldung: „Get-STFStoreService : Exception of type 'Citrix.DeliveryServices.Framework.Feature.Exceptions.RegistryKeyNotFoundException' was thrown.“ beim Ausführen des StoreFront-Skripts mit PowerShell.
    Dieser Fehler tritt auf, wenn das StoreFront-Skript in einem x86-kompatiblen PowerShell-Fenster ausgeführt wird.
    Lösung:
    Um das StoreFront PowerShell-Skript auszuführen, öffnen Sie das Windows x64-kompatible PowerShell-Fenster mit Administratorrechten und führen Sie dann ConfigureStorefront.ps1 aus.

Fehler bei öffentlichem Gateway/Callback-Gateway

Fehlermeldung: Gateway-Eintrag konnte nicht erstellt werden für: <Gateway URL> ODER Callback-Gateway-Eintrag konnte nicht erstellt werden für: <Callback Gateway URL>
Lösung:
Beachten Sie die öffentliche Gateway- oder Callback-Gateway-URL, für die der Fehler aufgetreten ist. Nachdem Sie Secure Private Access mit dem Assistenten eingerichtet haben, können Sie Gateway-Einträge über die Registerkarte Einstellungen bearbeiten.
  1. Klicken Sie auf Einstellungen und dann auf die Registerkarte Integrationen.
  2. Aktualisieren Sie die öffentliche Gateway-Adresse oder die Callback-Gateway-Adresse und die virtuelle IP-Adresse, für die der Fehler aufgetreten ist.

Secure Private Access Server nicht erreichbar

Fehlermeldung: IIS-Pool konnte nicht aktualisiert werden. IIS-Pool konnte nicht neu gestartet werden
Lösung:
Gehen Sie in den Internet Information Services (IIS) zu den Anwendungspools und überprüfen Sie, ob die folgenden Anwendungspools gestartet wurden und ausgeführt werden:
  • Secure Private Access Runtime Pool
  • Secure Private Access Admin Pool
Überprüfen Sie auch, ob die Standard-IIS-Site "Default Web Site" aktiv ist und ausgeführt wird.

Fehler bei der Datenbankkonnektivitätsprüfung

Fehlermeldung: Konnektivitätsprüfung fehlgeschlagen
Die Datenbankkonnektivitätsprüfung kann aus mehreren Gründen fehlschlagen:
  • Der Datenbankserver ist von der Hostmaschine des Secure Private Access Plug-ins aufgrund einer Firewall nicht erreichbar.
    Lösung: Überprüfen Sie, ob der Datenbankport (Standardport 1433) in der Firewall geöffnet ist.
  • Die Hostmaschine des Secure Private Access Plug-ins hat nicht die Berechtigung, eine Verbindung zur Datenbank herzustellen.
    Lösung: Siehe SQL-Datenbankberechtigungen für Secure Private Access.

Gateway-Konnektivitätsprüfung fehlgeschlagen. Öffentliches Zertifikat kann nicht abgerufen werden

Fehlermeldung: Die Konfiguration nach der Installation schlägt mit dem Fehler „Gateway-Konnektivitätsprüfung fehlgeschlagen. Öffentliches Zertifikat kann nicht abgerufen werden…“ fehl.
Lösung:
  • Laden Sie das öffentliche Gateway-Zertifikat manuell mit dem Konfigurationstool in die Secure Private Access-Datenbank hoch.
  • Öffnen Sie PowerShell oder das Eingabeaufforderungsfenster mit Administratorrechten.
  • Wechseln Sie das Verzeichnis in den Ordner Admin\AdminConfigTool unter dem Secure Private Access-Installationsordner (z. B. cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")
  • Führen Sie den folgenden Befehl aus:
    .\AdminConfigTool.exe /UPLOAD_PUBLIC_GATEWAY_CERTIFICATE <PublicGatewayUrl> <PublicGatewayCertificatePath>

Fehler bei der Anwendungsaufzählung

Die Anwendungsaufzählung schlägt fehl, wenn die StoreFront-URL oder die NetScaler Gateway-URL einen nachgestellten Schrägstrich (/) enthält.
Lösung:
Entfernen Sie den nachgestellten Schrästrich in der StoreFront-Store-URL oder der NetScaler Gateway-URL. Einzelheiten finden Sie unter StoreFront oder die NetScaler Gateway-Serverdetails nach der Einrichtung aktualisieren.

Verschiedenes

Diagnose-Support-Bundle für Secure Private Access erstellen

Führen Sie die folgenden Schritte aus, um ein Diagnose-Support-Bundle für Secure Private Access zu erstellen:
  • Öffnen Sie PowerShell oder das Eingabeaufforderungsfenster mit Administratorrechten.
  • Wechseln Sie in das Verzeichnis Admin\AdminConfigTool unter dem Installationsordner von Secure Private Access (z. B. cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool").
  • Führen Sie den folgenden Befehl aus:
    .\AdminConfigTool.exe /SUPPORTBUNDLE <output folder>

SQL-Datenbankberechtigungen für Secure Private Access

Für die automatische Datenbankerstellung muss der Hostcomputer des Secure Private Access-Plug-ins über die Berechtigungen verfügen, um eine Verbindung zur Datenbank herzustellen und das Datenbankschema zu erstellen.
Remotedatenbank:
Führen Sie die folgenden Schritte aus, um die Berechtigungen für eine Remotedatenbank einzurichten.
  1. Erstellen Sie eine leere Datenbank mit der Namenssyntax CitrixAccessSecurity<Site Name>. Hier ist <Site Name> der Secure Private Access-Sitenamen. (z. B. CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Erstellen Sie ein SQL-Server-Login für die Maschinenidentität der Secure Private Access-VM. Wenn der Name Ihres Secure Private Access-Broker-Computers beispielsweise HOST1 und die Maschinendomäne DOMAIN1 ist, dann ist die Maschinenidentität "DOMAIN1\HOST1$". Wenn das Login bereits erstellt wurde, können Sie diesen Schritt ignorieren.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [DOMAIN1\HOST1$] FROM WINDOWS
    Der Domänenname kann mit der folgenden Abfrage gefunden werden:
    SELECT DEFAULT_DOMAIN()[DomainName]
  3. Weisen Sie der Maschinenidentität die Rolle db_owner zu.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'
    ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
Lokale Datenbank:
Führen Sie die folgenden Schritte aus, um die Berechtigungen für eine lokale Datenbank einzurichten.
  1. Erstellen Sie eine leere Datenbank mit der Namenssyntax CitrixAccessSecurity<Site Name>. Hier ist <Site Name> der Secure Private Access-Sitenname. (zum Beispiel CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Erstellen Sie einen SQL Server-Login für den Benutzer NT AUTHORITY\SYSTEM. Wenn der Login bereits erstellt wurde, können Sie diesen Schritt ignorieren.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS
  3. Weisen Sie die Rolle db_owner dem Benutzer „NT AUTHORITY\SYSTEM“ zu.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
Wenn Sie die Datenbank manuell erstellen, fügt das heruntergeladene Datenbankskript die Berechtigungen zur Maschinenidentität hinzu.