StoreFront

Service Citrix Analytics

March 9, 2026

Contributeur:

C C

Si vous êtes un client monitor et que vous disposez d’un déploiement StoreFront sur site, vous pouvez configurer StoreFront de manière à ce que les données soient envoyées au service Citrix Analytics dans monitor. Une fois configurés, l’application Citrix Workspace et les navigateurs web envoient les événements utilisateur à Citrix Analytics pour traitement. Citrix Analytics agrège les métriques sur les utilisateurs, les applications, les points de terminaison, les réseaux et les données afin de fournir des informations complètes sur le comportement des utilisateurs. Pour en savoir plus sur cette fonctionnalité dans la documentation Citrix Analytics, consultez Intégrer des sites Virtual Apps and Desktops à l’aide de StoreFront.

Pour configurer ce comportement :

Téléchargez un fichier de configuration depuis Citrix Analytics.
Importez les données Citrix Analytics dans votre déploiement StoreFront sur site à l’aide de PowerShell.

Une fois StoreFront configuré, l’application Citrix Workspace peut envoyer des données depuis les magasins StoreFront lorsque le service Citrix Analytics le demande.

Important :

Votre déploiement StoreFront doit être en mesure de contacter les services API Citrix. Consultez Exigences réseau d’Analytics.

Télécharger le fichier de configuration depuis Citrix Analytics

Important :

Un fichier de configuration contenant des informations sensibles est requis pour la configuration initiale. Conservez le fichier en lieu sûr après le téléchargement. Ne partagez pas ce fichier avec des personnes extérieures à votre organisation. Après la configuration, vous pouvez supprimer ce fichier. Si vous devez réappliquer la configuration sur une autre machine, vous pouvez télécharger à nouveau le fichier depuis la console de gestion du service Citrix Analytics.

Connectez-vous à monitor (https://citrix.cloud.com/) à l’aide d’un compte administrateur.
Sélectionnez un client monitor.
Ouvrez la console de gestion du service Citrix Analytics en cliquant sur Gérer.
Dans la console de gestion du service Citrix Analytics, sélectionnez Paramètres > Sources de données.
Dans la carte Virtual Apps and Desktops, sélectionnez l’icône de menu (⋮), puis sélectionnez Connecter le déploiement StoreFront.
Sur la page Connecter le déploiement StoreFront, sélectionnez Télécharger le fichier pour télécharger le fichier StoreFrontConfigurationFile.json.

Exemple de fichier de configuration

{
  "customerId": "<yourcloudcustomer>",
  "enablementService": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/<yourcloudcustomer>/XenDesktop/<deviceid>/dsconfigdata",
  "cwsServiceKey": "PFJTPn…….. T4=",
  "enablementServiceStatus": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/storefront/config",
  "instanceId": "d98f21d0-56e0-11e9-ba52-5136d90862fe",
  "name": "CASSingleTenant"
}
<!--NeedCopy-->

où

customerId est l’ID unique du client monitor actuel.

cwsServiceKey est une clé unique identifiant le compte client monitor actuel.

instanceID est un ID généré utilisé pour signer (sécuriser) les requêtes effectuées depuis l’application Citrix Workspace vers Citrix Analytics. Si vous enregistrez plusieurs serveurs StoreFront ou groupes de serveurs avec monitor, chacun d’eux possède un instanceID unique.

Importer les données Citrix Analytics dans votre déploiement StoreFront™

Copiez le fichier StoreFrontConfigurationFile.json dans un dossier approprié sur le serveur StoreFront sur site (ou un serveur d’un groupe de serveurs StoreFront). Les commandes suivantes supposent que le fichier est enregistré sur le Bureau.
Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

Exécutez les commandes suivantes :

Import-STFCasConfiguration -Path "$Env:UserProfile\Desktop\StoreFrontConfigurationFile.json"
Get-STFCasConfiguration
<!--NeedCopy-->

Cette commande renvoie une copie des données importées et les affiche dans la console PowerShell.

Remarque :

Les serveurs StoreFront sur site, installés sur Windows Server 2012 R2, peuvent nécessiter l’installation manuelle des composants logiciels d’exécution C++ afin de pouvoir s’enregistrer auprès de CAS. Si StoreFront est installé lors de l’installation de Citrix Virtual Apps and Desktops, cette étape n’est pas requise, car le méta-installateur CVAD installe déjà les composants d’exécution C++. Si StoreFront est installé à l’aide du méta-installateur CitrixStoreFront-x64.exe uniquement, sans l’environnement d’exécution C++, il peut échouer à s’enregistrer auprès de monitor après l’importation du fichier de configuration CAS.

Propager les données Citrix Analytics à un groupe de serveurs StoreFront

Si vous effectuez ces actions sur un groupe de serveurs StoreFront, vous devez propager les données Citrix Analytics importées à tous les membres du groupe de serveurs. Cette étape n’est pas nécessaire dans un déploiement de serveur StoreFront unique.

Pour propager les données, utilisez l’une des approches suivantes :

Utilisez la console de gestion StoreFront.
Utilisez l’applet de commande PowerShell Publish-STFServerGroupConfiguration.

Vérifier l’ID du groupe de serveurs StoreFront

Pour vérifier si votre déploiement s’est correctement enregistré auprès du service Citrix Analytics, vous pouvez utiliser PowerShell pour découvrir le ServerGroupID de votre déploiement.

Connectez-vous à votre serveur StoreFront, ou à l’un des serveurs StoreFront du groupe de serveurs.
Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

Exécutez les commandes suivantes :

$WebConfigPath = "C:\Program Files\Citrix\Receiver StoreFront\Framework\FrameworkData\Framework.xml"
$XMLObject = (Get-Content $WebConfigPath) -as [Xml]
$XMLObject.framework.properties.property
<!--NeedCopy-->

Par exemple, ces commandes génèrent une sortie similaire à la suivante :

name value
---- -----
ClusterId 8b8ff5c8-44ba-46e4-87f0-2df8cff31432
HostBaseUrl https://storefront.example.com/
SelectedIISWebSiteId 1
AdminConsoleOperationMode Full
<!--NeedCopy-->

Arrêter l’envoi de données à Citrix Analytics depuis StoreFront

Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.
Exécutez les commandes suivantes :

Remove-STFCasConfiguration

Get-STFCasConfiguration

Get-STFCasConfiguration ne renvoie rien si les données Citrix Analytics précédemment importées ont été supprimées avec succès.
Si vous effectuez ces actions sur un groupe de serveurs StoreFront, propagez la modification et supprimez les données Citrix Analytics importées de tous les membres du groupe de serveurs. Sur un serveur du groupe de serveurs, exécutez la commande suivante :

Publish-STFServerGroupConfiguration
Sur tout autre membre du groupe de serveurs, exécutez la commande suivante pour confirmer que la configuration de Citrix Analytics a été supprimée avec succès de tous les serveurs du groupe :

Get-STFCasConfiguration
Connectez-vous à monitor (https://citrix.cloud.com/) à l’aide d’un compte administrateur.
Sélectionnez un client monitor.
Ouvrez la console de gestion du service Citrix Analytics en cliquant sur Gérer.
Dans la console de gestion du service Citrix Analytics, sélectionnez Paramètres > Sources de données.
Dans la carte Virtual Apps and Desktops, sélectionnez le nombre de déploiements StoreFront :
Identifiez le déploiement StoreFront que vous souhaitez supprimer en vous référant à son URL de base d’hôte et à son ServerGroupID.
Dans le menu (⋮), sélectionnez Supprimer le déploiement StoreFront d’Analytics.

Remarque :

Si vous supprimez la configuration côté serveur, mais pas de Citrix Analytics, l’entrée du déploiement StoreFront reste dans Citrix Analytics mais ne reçoit aucune donnée de StoreFront. Si vous supprimez la configuration uniquement de Citrix Analytics, l’entrée du déploiement StoreFront est rajoutée lors du prochain recyclage du pool d’applications (effectué lors d’une réinitialisation IIS ou automatiquement toutes les 24 heures).

Configurer StoreFront pour utiliser un proxy web afin de contacter monitor et de s’enregistrer auprès de Citrix Analytics

Si StoreFront est placé sur un serveur web hôte derrière un proxy web, l’enregistrement auprès de Citrix Analytics échouera. Si les administrateurs StoreFront utilisent un proxy HTTP dans leur déploiement Citrix, le trafic StoreFront destiné à Internet doit passer par le proxy web avant d’atteindre Citrix Analytics dans le cloud. StoreFront n’utilise pas automatiquement les paramètres de proxy du système d’exploitation hôte ; une configuration supplémentaire est requise pour indiquer au magasin d’envoyer le trafic sortant via le proxy web. Vous pouvez configurer une configuration de proxy <system.net> en ajoutant une nouvelle section au fichier web.config du magasin. Effectuez cette opération pour chaque magasin sur le serveur StoreFront qui sera utilisé pour envoyer des données à Citrix Analytics.

Méthode 1 : Configurer le proxy du magasin via Powershell pour un ou plusieurs magasins (recommandé)

L’exécution du script Powershell Config-StoreProxy.ps1 automatise ce processus pour un ou plusieurs magasins et insère automatiquement un XML valide pour configurer <system.net>. Le script sauvegarde également le fichier web.config du magasin sur le bureau de l’utilisateur actuel, ce qui permet de restaurer le fichier web.config non modifié si nécessaire.

Remarque :

L’exécution du script plusieurs fois peut entraîner l’ajout de plusieurs copies du XML <system.net>. Chaque magasin ne doit avoir qu’une seule entrée pour <system.net>. L’ajout de plusieurs copies empêche la configuration du proxy du magasin de fonctionner correctement.

Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.
Définissez $Stores = @("Store","Store2") pour inclure les magasins que vous souhaitez configurer avec un proxy web.
Spécifiez soit :
- une adresse IP, OU
- un nom de domaine complet (FQDN) pour le proxy web

Exécutez le script PowerShell suivant :

$Stores = @("Store","Store2")
$ProxyIP = "10.0.0.1"
$ProxyFQDN = "proxyserver.example.com"
$ProxyPort = 8888

# Set this for every Store using Stores array
function Set-StoreProxyServer() # Tested with both IP and FQDN
{
    [CmdletBinding()]
    param([Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][array]$Stores,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][string]$ProxyIP,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][string]$ProxyFQDN,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][int]$ProxyPort)

    foreach($Store in $Stores)
    {
        Write-Host "Backing up the Store web.config file for store $Store before making changes..." -ForegroundColor "Yellow"
        Write-Host "`n"

        if(!(Test-Path "$env:UserProfile\desktop\$Store\"))
        {
            Write-Host "Creating $env:UserProfile\desktop\$Store\ directory for backup..." -ForegroundColor "Yellow"
            New-Item -Path "$env:UserProfile\desktop\$Store\" -ItemType "Directory" | Out-Null
            Write-Host "`n"
        }

        Write-Host "Copying c:\inetpub\wwwroot\Citrix\$Store\web.config to $env:UserProfile\desktop\$Store\..." -ForegroundColor "Yellow"
        Copy-Item -Path "c:\inetpub\wwwroot\Citrix\$Store\web.config" -Destination "$env:UserProfile\desktop\$Store\" -Force | Out-Null

        if(Test-Path "$env:UserProfile\desktop\$Store\web.config")
        {
            Write-Host "$env:UserProfile\desktop\$Store\web.config file backed up" -ForegroundColor "Green"
        }
        else
        {
            Write-Host "$env:UserProfile\desktop\$Store\web.config file NOT found!" -ForegroundColor "Red"
        }
        Write-Host "`n"

        Write-Host "Setting the proxy server to $ProxyAddress for Store $Store..." -ForegroundColor "Yellow"
        Write-Host "`n"

        $StoreConfigPath = "c:\inetpub\wwwroot\Citrix\$Store\web.config"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        if([string]::IsNullOrEmpty($ProxyFQDN))
        {
            $ProxyServer = ("HTTP://$ProxyIP"+":"+$ProxyPort)
        }
        else
        {
            $ProxyServer = ("HTTP://$ProxyFQDN"+":"+$ProxyPort)
        }

        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        # Create 3 elements
        $SystemNet = $XMLObject.CreateNode("element","system.net","")
        $DefaultProxy = $XMLObject.CreateNode("element","defaultProxy","")
        $Proxy = $XMLObject.CreateNode("element","proxy","")
        $Proxy.SetAttribute("proxyaddress","$ProxyServer")
        $Proxy.SetAttribute("bypassonlocal","true")

        # Move back up the XML tree appending new child items in reverse order
        $DefaultProxy.AppendChild($Proxy)
        $SystemNet.AppendChild($DefaultProxy)
        $XMLObject.configuration.AppendChild($SystemNet)

        # Save the modified XML document to disk
        $XMLObject.Save($StoreConfigPath)

        Write-Host "Getting the proxy configuration for c:\inetpub\wwwroot\Citrix\$Store..." -ForegroundColor "Yellow"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
        $ConfiguredProxyServer = $XMLObject.configuration.'system.net'.defaultProxy.proxy.proxyaddress | Out-Null
        Write-Host ("Configured proxy server for Store $Store"+": "+ $ConfiguredProxyServer) -ForegroundColor "Green"
        Write-Host "`n"
    }
    Write-Host "Restarting IIS..." -ForegroundColor "Yellow"
    IISReset /RESTART
}

Set-StoreProxyServer -Stores $Stores -ProxyFQDN $ProxyFQDN -ProxyPort $ProxyPort
# OR
Set-StoreProxyServer -Stores $Stores -ProxyIP $ProxyIP -ProxyPort $ProxyPort
<!--NeedCopy-->

Vérifiez que C:\inetpub\wwwroot\Citrix\<Store>\web.config contient maintenant une section <system.net> à la fin du fichier.

        </dependentAssembly>
    </assemblyBinding>
</runtime>
<system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
</configuration>
<!--NeedCopy-->

Importez les données Citrix Analytics comme décrit dans Importer les données Citrix Analytics dans votre déploiement StoreFront.

Méthode 2 : Ajouter manuellement une section `<system.net>` au fichier web.config du magasin

Cette opération doit être effectuée pour chaque magasin sur le serveur StoreFront qui sera utilisé pour envoyer des données à Citrix Analytics.

Sauvegardez le fichier web.config du magasin et copiez-le à un autre emplacement en dehors de C:\inetpub\wwwroot\Citrix\<Store>\web.config.
Modifiez le XML suivant avec vos paramètres de proxy en utilisant soit une combinaison FQDN et port, soit une combinaison IP et port.

Par exemple, en utilisant une combinaison FQDN et port, utilisez l’élément <system.net> suivant :
```
<system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>

```
Par exemple, en utilisant une combinaison IP et port, utilisez l’élément <system.net> suivant :
```
<system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://10.0.0.1:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>

```

À la fin du fichier web.config du magasin, insérez l’élément <system.net> approprié comme indiqué ici :

<runtime>
<gcServer enabled="true" />
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
    <assemblyIdentity name="System.Web.MVC" publicKeyToken="31BF3856AD364E35" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
    </dependentAssembly>
</assemblyBinding>
</runtime>

Insert the <system.net> element here

</configuration>
<!--NeedCopy-->

Importez les données Citrix Analytics comme décrit dans Importer les données Citrix Analytics dans votre déploiement StoreFront.

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Service Citrix Analytics

March 9, 2026

Contributeur:

C C

March 9, 2026

Contributeur:

C C

Dans cet article

Télécharger le fichier de configuration depuis Citrix Analytics
Importer les données Citrix Analytics dans votre déploiement StoreFront™
Propager les données Citrix Analytics à un groupe de serveurs StoreFront
Vérifier l’ID du groupe de serveurs StoreFront
Arrêter l’envoi de données à Citrix Analytics depuis StoreFront
Configurer StoreFront pour utiliser un proxy web afin de contacter monitor et de s’enregistrer auprès de Citrix Analytics

Cela vous a-t-il été utile ?

Service Citrix Analytics

Télécharger le fichier de configuration depuis Citrix Analytics

Exemple de fichier de configuration

Importer les données Citrix Analytics dans votre déploiement StoreFront™

Propager les données Citrix Analytics à un groupe de serveurs StoreFront

Vérifier l’ID du groupe de serveurs StoreFront

Arrêter l’envoi de données à Citrix Analytics depuis StoreFront

Configurer StoreFront pour utiliser un proxy web afin de contacter monitor et de s’enregistrer auprès de Citrix Analytics

Méthode 1 : Configurer le proxy du magasin via Powershell pour un ou plusieurs magasins (recommandé)

Méthode 2 : Ajouter manuellement une section <system.net> au fichier web.config du magasin

Dans cet article

Méthode 2 : Ajouter manuellement une section `<system.net>` au fichier web.config du magasin