Dépannage de certaines erreurs courantes

Dernière publication : Oct 24, 2026
Cette rubrique répertorie certaines des erreurs que vous pourriez rencontrer lors de la configuration de Secure Private Access.
Erreurs de certificat
Erreurs de création de base de données
Échecs de StoreFront
Échecs de la passerelle publique/de la passerelle de rappel
Serveur Secure Private Access inaccessible

Erreurs de certificat

Message d'erreur : Impossible d'obtenir automatiquement les certificats d'un ou plusieurs serveurs Gateway.
Ce message d'erreur apparaît lorsque vous essayez d'ajouter une adresse NetScaler® Gateway publique et qu'il y a un problème lors de la récupération du certificat. Ce problème peut survenir lors de la configuration de Secure Private Access ou de la mise à jour des paramètres une fois la configuration terminée.
Solution de contournement : Mettez à jour le certificat de la passerelle de la même manière que vous le feriez pour Citrix Virtual Apps and Desktops.

Erreurs de création de base de données

  • Message d'erreur : Échec de la création de la base de données
    Résolution : Pour le cas automatique - La machine doit disposer des autorisations de LECTURE, ÉCRITURE, MISE À JOUR pour créer des tables dans la base de données sur le serveur SQL.
  • Message d'erreur : Échec de la création de la base de données : Une base de données existe déjà.
    Ce message d'erreur peut apparaître dans l'un des scénarios suivants.
    • Si l'option Configuration automatique est sélectionnée lors de la configuration des bases de données.
    • Si l'administrateur crée une base de données, celle-ci doit être vide. Ce message d'erreur peut apparaître si la base de données n'est pas vide.
      Résolution : Vous devez créer une base de données vide.
    • Vous désinstallez Secure Private Access et réessayez l'installation avec le même nom de site. Dans ce cas, la base de données de l'installation précédente n'aurait pas été supprimée.
      Résolution : Vous devez supprimer manuellement la base de données.
    • Vous choisissez de configurer la base de données manuellement (en sélectionnant Configuration manuelle dans la page Configuration des bases de données) à l'aide du script, puis vous passez à l'option Configuration automatique mais utilisez le même nom de site. Dans ce cas, une base de données portant le même nom est déjà créée lors de l'exécution du script.
      Résolution : Vous devez renommer le site, puis exécuter le script à nouveau.
    • La machine ne dispose pas des autorisations de LECTURE, ÉCRITURE, MISE À JOUR pour créer des tables dans la base de données sur le serveur SQL.
      Résolution : Activez les autorisations appropriées sur la machine. Pour plus de détails, consultez Autorisations requises pour configurer les bases de données.
  • Message d'erreur : Échec de la création de la base de données : Connexion échouée
    Résolution :
    • Vérifiez la connectivité réseau de la base de données depuis votre machine. Assurez-vous que le port du serveur SQL est ouvert sur le pare-feu.
    • Si vous utilisez un serveur SQL distant, vérifiez si le serveur SQL a un identifiant de connexion créé avec l'identité de la machine Secure Private Access, Domaine\nom_d'hôte$.
    • Si vous utilisez un serveur SQL distant, confirmez que l'identité de la machine a le rôle correct attribué, le rôle d'administrateur système.
    • Si vous utilisez un serveur SQL local (non issu de l'installateur), vérifiez si l'utilisateur NT AUTHORITY\SYSTEM doit avoir une connexion créée.

Échecs de StoreFront™

  • Message d'erreur : Échec de la création de l'entrée StoreFront pour : <Store URL>
    Mettez à jour les entrées StoreFront à partir de l'onglet Paramètres si elles ne sont pas visibles. Après avoir configuré Secure Private Access à l'aide de l'assistant, vous pouvez modifier les entrées StoreFront à partir de l'onglet Paramètres. Notez l'URL du Store StoreFront pour laquelle cette erreur s'est produite.
    Résolution :
    1. Cliquez sur Paramètres, puis sur l'onglet Intégrations.
    2. Dans URL du Store StoreFront, ajoutez l'entrée StoreFront si elle n'est pas visible.
  • Message d'erreur : Échec de la configuration de l'entrée StoreFront pour : <Store URL>
    Résolution :
    1. Il peut y avoir une restriction de stratégie d'exécution PowerShell en place. Exécutez la commande de script PowerShell Get-ExecutionPolicy pour plus de détails.
    2. Si elle est restreinte, vous devez la contourner et exécuter un script de configuration StoreFront manuellement.
    3. Cliquez sur Paramètres, puis sur l'onglet Intégrations.
    4. Dans URL du Store StoreFront, identifiez l'entrée d'URL StoreFront pour laquelle l'erreur s'est produite.
    5. Cliquez sur le bouton Télécharger le script à côté de cette URL de Store et exécutez ce script PowerShell avec des privilèges d'administrateur sur la machine sur laquelle l'installation StoreFront correspondante est présente. Ce script doit être exécuté sur toutes les machines StoreFront.
    Remarque :
    Si vous réessayez l'installation après la désinstallation, assurez-vous qu'il n'y a pas d'entrée nommée « Secure Private Access » dans la configuration StoreFront (StoreFront > store> Delivery Controller™ -> Secure Private Access). Si Secure Private Access est présent, supprimez cette entrée. Téléchargez et exécutez manuellement le script depuis la page Paramètres > Intégrations.
  • Message d'erreur : La configuration StoreFront n'est pas locale pour : <Store URL>
    Après avoir configuré Secure Private Access à l'aide de l'assistant, vous pouvez modifier les entrées de passerelle depuis l'onglet Paramètres. Notez l'URL du Store StoreFront pour laquelle cette erreur s'est produite.
    Résolution :
    Ce problème se produit si StoreFront n'est pas installé sur la même machine que Secure Private Access. Vous devez exécuter manuellement la configuration StoreFront sur la machine où vous avez installé StoreFront.
    1. Cliquez sur Paramètres, puis sur l'onglet Intégrations.
    2. Dans URL du Store StoreFront, identifiez l'entrée d'URL StoreFront pour laquelle l'erreur s'est produite.
    3. Cliquez sur le bouton Télécharger le script à côté de cette URL de Store et exécutez ce script PowerShell avec des privilèges d'administrateur sur la machine où l'installation StoreFront correspondante est présente. Ce script doit être exécuté sur toutes les machines StoreFront.
    Remarque :
    Pour exécuter le script PowerShell StoreFront, ouvrez la fenêtre PowerShell compatible Windows x64 avec des privilèges d'administrateur, puis exécutez ConfigureStorefront.ps1. Le script StoreFront n'est pas compatible avec Windows PowerShell (x86).
  • Message d'erreur : « Get-STFStoreService : Exception of type 'Citrix.DeliveryServices.Framework.Feature.Exceptions.RegistryKeyNotFoundException' was thrown. » lors de l'exécution du script StoreFront à l'aide de PowerShell.
    Cette erreur se produit lorsque le script StoreFront est exécuté dans une fenêtre PowerShell compatible x86.
    Résolution :
    Pour exécuter le script PowerShell StoreFront, ouvrez la fenêtre PowerShell compatible Windows x64 avec des privilèges d'administrateur, puis exécutez ConfigureStorefront.ps1.

Échecs de la passerelle publique/de la passerelle de rappel

Message d'erreur : Échec de la création de l'entrée de passerelle pour : <Gateway URL> OU Échec de la création de l'entrée de passerelle de rappel pour : <Callback Gateway URL>
Résolution :
Notez l'URL de la passerelle publique ou de la passerelle de rappel pour laquelle l'échec s'est produit. Après avoir configuré Secure Private Access à l'aide de l'assistant, vous pouvez modifier les entrées de passerelle à partir de l'onglet Paramètres.
  1. Cliquez sur Paramètres, puis sur l'onglet Intégrations.
  2. Mettez à jour l'adresse de la passerelle publique ou l'adresse de la passerelle de rappel et l'adresse IP virtuelle pour laquelle l'échec s'est produit.

Serveur Secure Private Access inaccessible

Message d'erreur : Échec de la mise à jour du pool IIS. Échec du redémarrage du pool IIS
Résolution :
Accédez aux pools d'applications dans Internet Information Services (IIS) et vérifiez que les pools d'applications suivants ont démarré et sont en cours d'exécution :
  • Pool d'exécution Secure Private Access
  • Pool d'administration Secure Private Access
Vérifiez également que le site IIS par défaut "Default Web Site" est opérationnel.

Échecs de la vérification de la connectivité de la base de données

Message d'erreur : Échec de la vérification de la connectivité
La vérification de la connectivité de la base de données peut échouer pour plusieurs raisons :
  • Le serveur de base de données n'est pas accessible depuis la machine hôte du plug-in Secure Private Access en raison d'un pare-feu.
    Résolution : Vérifiez si le port de la base de données (port par défaut 1433) est ouvert sur le pare-feu.
  • La machine hôte du plug-in Secure Private Access n'a pas l'autorisation de se connecter à la base de données.
    Résolution : Consultez Autorisations de base de données SQL pour Secure Private Access.

Échec de la vérification de la connectivité de la passerelle. Impossible de récupérer le certificat public

Message d'erreur : La configuration post-installation échoue avec l'erreur « Échec de la vérification de la connectivité de la passerelle. Impossible de récupérer un certificat public…. »
Résolution :
  • Téléchargez manuellement le certificat public de la passerelle vers la base de données Secure Private Access à l'aide de l'outil de configuration.
  • Ouvrez la fenêtre PowerShell ou l'invite de commandes avec des privilèges d'administrateur.
  • Changez le répertoire pour le dossier Admin\AdminConfigTool sous le dossier d'installation de Secure Private Access (par exemple, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")
  • Exécutez la commande suivante :
    .\AdminConfigTool.exe /UPLOAD_PUBLIC_GATEWAY_CERTIFICATE <PublicGatewayUrl> <PublicGatewayCertificatePath>

Échec de l'énumération des applications

L'énumération des applications échoue si l'URL de StoreFront ou l'URL de NetScaler Gateway contient une barre oblique finale (/).
Résolution :
Supprimez la barre oblique finale dans l'URL du magasin StoreFront ou l'URL de NetScaler Gateway. Pour plus de détails, consultez Mettre à jour les détails du serveur StoreFront ou NetScaler Gateway après la configuration.

Divers éléments

Créer un bundle de support de diagnostic Secure Private Access

Effectuez les étapes suivantes pour créer un bundle de support de diagnostic Secure Private Access :
  • Ouvrez la fenêtre PowerShell ou l'invite de commandes avec des privilèges d'administrateur.
  • Accédez au dossier Admin\AdminConfigTool sous le dossier d'installation de Secure Private Access (par exemple, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool").
  • Exécutez la commande suivante :
    .\AdminConfigTool.exe /SUPPORTBUNDLE <output folder>

Autorisations de base de données SQL pour Secure Private Access

Pour la création automatique de la base de données, la machine hôte du plug-in Secure Private Access doit disposer des autorisations nécessaires pour se connecter à la base de données et créer le schéma de la base de données.
Base de données distante :
Effectuez les étapes suivantes pour configurer les autorisations d'une base de données distante.
  1. Créez une base de données vide avec la syntaxe de nom CitrixAccessSecurity<Site Name>. Ici, <Site Name> est le nom du site Secure Private Access. (par exemple, CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Créez une connexion au serveur SQL pour l'identité de la machine virtuelle Secure Private Access. Par exemple, si le nom de votre machine broker Secure Private Access est HOST1 et que le domaine de la machine est DOMAIN1, alors l'identité de la machine est "DOMAIN1\HOST1$". Si la connexion est déjà créée, vous pouvez ignorer cette étape.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [DOMAIN1\HOST1$] FROM WINDOWS
    Le nom de domaine peut être trouvé en utilisant la requête suivante :
    SELECT DEFAULT_DOMAIN()[DomainName]
  3. Attribuez le rôle db_owner à l'identité de la machine.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'
    ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
Base de données locale :
Effectuez les étapes suivantes pour configurer les autorisations d'une base de données locale.
  1. Créez une base de données vide avec la syntaxe de nom CitrixAccessSecurity<Site Name>. Ici, <Site Name> est le nom du site Secure Private Access. (par exemple, CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Créez une connexion au serveur SQL pour l'utilisateur NT AUTHORITY\SYSTEM. Si la connexion est déjà créée, vous pouvez ignorer cette étape.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS
  3. Attribuer le rôle db_owner à l'utilisateur « NT AUTHORITY\SYSTEM ».
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
Lorsque vous créez manuellement la base de données, le script de base de données téléchargé ajoute les autorisations à l'identité de la machine.