> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/fr/installation-setup/installation/parametres-des-variables-denvironnement.md).

# Paramètres des variables d’environnement

Outre ses [paramètres système](/fr/installation-setup/system-settings.md) vous pouvez également configurer le noyau de ngSurvey à l’aide de la variable d’environnement suivante. Ces variables peuvent également être définies dans le fichier web.config si vous utilisez IIS ou dans le fichier ngsurvey.settings.json.

{% hint style="info" %}
Dans un service d’application Azure Linux par défaut ou un conteneur Linux personnalisé, tout `:` dans le nom de la variable doit être remplacé par `__` (double trait de soulignement).
{% endhint %}

## 🔅 Variables d’environnement

* **`NGSurvey:Secret`**&#x63;lé de chiffrement utilisée pour signer les JWT et les jetons des éléments de sécurité. Doit comporter au moins 64 caractères.&#x20;
* **`NGSurvey:AutoDBSetup`** par défaut, ngSurvey configure ou met automatiquement à niveau votre Base de données cible. Si vous souhaitez désactiver le processus d’installation / mise à niveau automatique, vous pouvez définir cette variable sur false. Dans ce cas, vous devrez installer manuellement la Base de données à l’aide du fichier [dacpac](/fr/installation-setup/installation/backend-de-base-de-donnees/microsoft-sql-server.md) pour Microsoft SQL Server. MariaDB ou MySQL seront installés uniquement directement par ngSurvey ; nous ne proposons aucun script ni code pour installer et configurer manuellement la Base de données vous-même.
* **`NGSurvey:MailingBatchPoolingDelay`**&#x63;orrespond au délai, en minutes, au terme duquel les lots liés aux envois, tels que l’envoi d’e-mails de campagne, seront déclenchés. La valeur par défaut est de 1 minute.
* **`NGSurvey:MaxMailingThread`** vous permet de définir le nombre de threads de travail qui seront utilisés lors du processus d’envoi d’e-mails. Soyez prudent lors de la définition du nombre de threads, car chaque thread ouvrira une connexion à votre serveur de messagerie. La valeur par défaut est 2.
* **`NGSurvey:DisableEmailBlacklisting`** désactive la possibilité de mettre des e-mails sur liste noire pour les campagnes si défini sur true.
* **`NGSurvey:DisableMobilePhoneNumberBlacklisting`** désactive la possibilité de mettre des téléphones mobiles sur liste noire pour les campagnes si défini sur true.
* **`NGSurvey:EnableSwagger`** si défini sur false, désactivera l’accès à la documentation de l’API à l’adresse <https://yourngsurveysite/api.&#x20>;
* **`NGSurvey:DistributedCache`**&#x61;ctive le cache distribué si défini sur true. Le cache distribué doit être activé si vous utilisez ngSurvey dans une configuration de type [cluster](/fr/installation-setup/installation/cluster-scale-out-configuration.md) comme configuration
* **`NGSurvey:CacheTimeout`** ngSurvey utilise des caches internes pour améliorer les performances. Par défaut, ces caches n’expirent pas. Vous pouvez définir un délai d’expiration en minutes si vous souhaitez définir une durée d’expiration afin que ces caches soient vidés à intervalles réguliers.&#x20;
* **`NGSurvey:PanelSyncronizerThreadsNumber`** définit le nombre de threads qui seront utilisés pour synchroniser les panels avec leurs sources de données. La valeur par défaut est 6. Soyez prudent, car chaque thread peut ouvrir une nouvelle connexion à la source de données à laquelle votre panel est connecté.&#x20;
* **`NGSurvey:Languages`** un tableau de codes de langue qui pourront être sélectionnés pour la section d’administration. :&#x20;
* **`NGSurvey:ClusterNode`** définit, si défini sur true, si l’instance s’exécute sur un nœud de cluster. Les instances dont le nœud de cluster est défini sur true n’exécuteront aucun type de tâche d’arrière-plan. Vous devez conserver les tâches d’arrière-plan soit sur des instances distinctes qui ne servent aucun Sondage, soit sur une seule instance.&#x20;
* **`NGSurvey:EncryptionKey`** cette clé de chiffrement sera utilisée pour tout le chiffrement des données au niveau de la Base de données, telles que les chaînes de connexion, les mots de passe et les paramètres sensibles. Doit comporter au minimum 64 caractères. Veillez à conserver une sauvegarde de la clé, car sans elle, vous ne pourrez peut-être pas récupérer vos données ngSurvey.
* **`NGSurvey:AccountLockoutThreshold`** nombre de tentatives d’authentification autorisées pour une connexion avant son verrouillage.
* **`NGSurvey:AccountLockoutDuration`** nombre de minutes pendant lesquelles le compte de connexion est verrouillé avant de pouvoir à nouveau s’authentifier. &#x20;
* **`NGSurvey:EnableHSTS`**&#x61;ctive HSTS ; si vous utilisez SSL, tous les cookies seront définis comme sécurisés.&#x20;
* **`NGSurvey:WebSetupDisabled`** désactivez l’interface d’installation web de ngSurvey en définissant cette valeur sur true.
* **`NGSurvey:CaptchaDisabled`** désactive les fonctionnalités captcha si défini sur true.
* **`NGSurvey:TwoFactorDisabled`** désactive l’authentification à deux facteurs lors de la connexion si défini sur true. Peut être utilisé pour contourner l’authentification à deux facteurs en cas de problème.
* **`NGSurvey:ClearActivityLogsOlderThanDays`** nombre de jours de conservation des données du journal d’activité.
* **`NGSurvey:ClearActivityLogTresholdDays`** nombre de jours avant la suppression définitive des données du journal d’activité.
* **`NGSurvey:EncryptActivityLog`** si défini sur true, chiffrera les données du journal d’activité au niveau de la Base de données.
* **`NGSurvey:PersitentMailStorageLocation`** chemin d’accès à un dossier pouvant être utilisé pour sauvegarder les messages enregistrés dans le dossier de récupération Exchange si vous utilisez le dossier de récupération Exchange pour envoyer des e-mails. &#x20;
* **`NGSurvey:MaxAllowedTextSize`** taille maximale autorisée du texte, en octets, pouvant être stockée dans le système. Peut être utilisée pour prévenir les attaques par dépassement de capacité sur le système. La valeur par défaut est 10485760.
* **`NGSurvey:MailServerTest`** si défini sur true, n’enverra pas directement les e-mails via le serveur de messagerie configuré.
* **`NGSurvey:LoadTest`** si défini sur true, autorisera la soumission plusieurs fois des mêmes réponses du Répondant.&#x20;
* **`NGSurvey:AdminDisabled`** si défini sur true, désactivera toutes les fonctionnalités d’administration de l’API. Si cette option est désactivée, seules les API relatives à la récupération des Sondages et aux soumissions des Répondants seront disponibles.&#x20;
* **`NGSurvey:CPSPolicy`**&#x73;i défini sur « Self », appliquera la politique de sécurité du contenu (CSP) dans le navigateur. Notez que les éléments de Réponse basés sur des widgets et toutes les fonctionnalités liées à JavaScript personnalisé seront désactivés si défini sur Self.&#x20;
* **KeyVault:Name** nom du coffre de clés Azure si vous prévoyez de stocker votre variable d’environnement dans le coffre de clés Azure.&#x20;
* **AzureAd:ClientId** ID client du coffre de clés Azure.&#x20;
* **AzureAd:ClientSecret** secret client pour accéder au coffre de clés Azure.
* **`NGSurvey:RedisConnectionString`** chaîne de connexion au serveur de mise en cache Redis.
* **`NGSurvey:RedisInstanceName`** nom facultatif de l’instance Redis
* **`NGSurvey:ActivityLogAzureWorkspaceId`** ID de l’espace de travail Azure Analyses des journaux pour journaliser les activités
* **`NGSurvey:ActivityLogAzureAuthenticationId`** ID d’authentification de l’agent Azure Analyses des journaux
* **`NGSurvey:ActivityLogAwsAccessKeyId`** ID de clé d’accès AWS CloudWatch pour journaliser les activités
* **`NGSurvey:ActivityLogAwsSecretAccessKey`** clé secrète AWS CloudWatch
* **`NGSurvey:ActivityLogAwsRegion`** région AWS CloudWatch&#x20;
* **`NGSurvey:ActivityLogAwsLogGroup`** groupe de journaux AWS CloudWatch
* **`NGSurvey:ActivityLogApplicationInsightsKey`** clé Azure Application Insights pour journaliser les activités&#x20;
* **`NGSurvey:ActivityLogUseEventLog`** si défini sur true, consignera les activités dans le journal des événements Windows.
* **`NGSurvey:AccountJWTAccessTokenExpiration`** durée d’expiration, en minutes, du Jeton JWT de développeur au niveau du compte. Valeur par défaut : 90 jours ; maximum : 6 mois.&#x20;
* **`NGSurvey:FormJWTAccessTokenExpiration`** durée d’expiration, en minutes, du Jeton JWT de développeur au niveau du Sondage/Formulaire. Valeur par défaut : 2 jours ; maximum : 7 jours.
* **`NGSurvey:FormJWTAccessTokenExpiration`** durée d’expiration, en minutes, du Jeton JWT de développeur au niveau du Sondage/Formulaire. Valeur par défaut : 2 jours ; maximum : 7 jours.
* **`NGSurvey:PostgresAzureScope`** portée Azure qui gère les jetons d’accès Entra pour utiliser Postgres avec un compte géré Entra.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ngsurvey.com/fr/installation-setup/installation/parametres-des-variables-denvironnement.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
