{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Quelle est la priorité par défaut des sources de configuration dans ASP.NET Core ?","acceptedAnswer":{"@type":"Answer","text":"Les sources de configuration sont lues dans un ordre précis où les dernières chargées écrasent les précédentes. Environment variables a la priorité la plus élevée, suivi de appsettings.{Environment}.json, puis appsettings.json. User Secrets n'est chargé qu'en environnement Development et a une priorité plus basse que les environment variables."}},{"@type":"Question","name":"Quel est l'intérêt principal d'utiliser des fichiers appsettings.{Environment}.json séparés ?","acceptedAnswer":{"@type":"Answer","text":"Les fichiers appsettings.{Environment}.json permettent de définir des configurations spécifiques à chaque environnement sans changer le code. Par exemple, une chaîne de connexion locale en Development et une chaîne Azure en Production. Cela évite de hardcoder les valeurs ou de modifier le code lors du déploiement."}},{"@type":"Question","name":"Quel est le rôle principal de User Secrets dans ASP.NET Core ?","acceptedAnswer":{"@type":"Answer","text":"User Secrets stocke des secrets (API keys, connection strings) dans un fichier JSON local situé en dehors du projet, typiquement dans le répertoire utilisateur. Cela évite de committer accidentellement des secrets dans Git. User Secrets n'est chargé qu'en environnement Development et ne doit jamais être utilisé en production."}},{"@type":"Question","name":"Quelle est la différence clé entre IOptions et IOptionsSnapshot ?","acceptedAnswer":{"@type":"Answer","text":"IOptions est singleton et lit la configuration au démarrage une seule fois. IOptionsSnapshot est scoped (par requête) et relit la configuration à chaque requête, permettant de détecter les changements dans appsettings.json sans redémarrer l'app. Utiliser IOptionsSnapshot pour les configs qui peuvent changer fréquemment."}},{"@type":"Question","name":"Dans quel cas utiliser IOptionsMonitor plutôt que IOptionsSnapshot ?","acceptedAnswer":{"@type":"Answer","text":"IOptionsMonitor est singleton et permet de réagir aux changements de configuration via OnChange. Cela est utile pour des services singleton (ex: cache, logger) qui doivent ajuster leur comportement quand appsettings.json change. IOptionsSnapshot ne fonctionne que dans un scope HTTP et ne peut pas être injecté dans un singleton."}},{"@type":"Question","name":"Comment binder automatiquement une section de appsettings.json à une classe POCO ?","acceptedAnswer":{"@type":"Answer","text":"Le binding automatique se fait via Configure(GetSection(\"SectionName\")) qui mappe les propriétés JSON aux propriétés C#. Ensuite, injecter IOptions dans les services pour accéder aux valeurs typées. Cela évite les magic strings et apporte la validation au build time."}},{"@type":"Question","name":"Quel est le format des clés de variables d'environnement pour surcharger une configuration hiérarchique JSON ?","acceptedAnswer":{"@type":"Answer","text":"Les variables d'environnement utilisent le double underscore __ pour représenter les niveaux de hiérarchie JSON car certains OS n'acceptent pas le point dans les noms de variables. Par exemple, \"ConnectionStrings__DefaultConnection\" correspond à { \"ConnectionStrings\": { \"DefaultConnection\": \"...\" } } dans JSON."}},{"@type":"Question","name":"Comment valider automatiquement les options de configuration au démarrage de l'application ?","acceptedAnswer":{"@type":"Answer","text":"ValidateDataAnnotations() active la validation via DataAnnotations ([Required], [Range], etc.) et ValidateOnStart() force la validation au démarrage au lieu du premier usage. Cela permet de fail-fast si la configuration est invalide plutôt que d'attendre la première requête HTTP. La validation peut aussi être custom via Validate()."}},{"@type":"Question","name":"Par défaut, que se passe-t-il quand appsettings.json est modifié pendant que l'application tourne ?","acceptedAnswer":{"@type":"Answer","text":"ASP.NET Core active le rechargement automatique des fichiers appsettings.json par défaut (reloadOnChange: true). IOptionsSnapshot et IOptionsMonitor récupèrent les nouvelles valeurs, mais IOptions reste figé. En production, désactiver le reload si les configurations ne doivent jamais changer pendant l'exécution pour éviter des comportements incohérents."}},{"@type":"Question","name":"Comment définir l'environnement d'exécution de l'application ASP.NET Core ?","acceptedAnswer":{"@type":"Answer","text":"ASPNETCORE_ENVIRONMENT détermine quel fichier appsettings.{Environment}.json sera chargé et si User Secrets sera activé. Les valeurs standards sont Development, Staging, Production. En Development, des features comme Developer Exception Page et User Secrets sont activées. En Production, ces features sont désactivées pour la sécurité."}},{"@type":"Question","name":"Quelle est la différence entre Configuration.GetValue(\"Key\") et Configuration.GetSection(\"Key\") ?","acceptedAnswer":{"@type":"Answer","text":"GetValue(\"Key\") lit une valeur simple et la convertit au type T (ex: int, bool, string). GetSection(\"Key\") retourne un objet IConfigurationSection qui permet de naviguer dans les sous-sections ou de binder à une classe via Bind(). Utiliser GetValue pour les valeurs scalaires simples, GetSection pour les objets complexes."}},{"@type":"Question","name":"Quel est le rôle de launchSettings.json dans la configuration ASP.NET Core ?","acceptedAnswer":{"@type":"Answer","text":"launchSettings.json est utilisé par Visual Studio et dotnet run pour définir les profils de démarrage (IIS Express, Kestrel) et les variables d'environnement locales. Ce fichier n'est jamais déployé en production et sert uniquement au développement local. Les vrais paramètres de production doivent être dans appsettings.Production.json ou environment variables."}},{"@type":"Question","name":"Pourquoi utiliser Azure Key Vault plutôt que des variables d'environnement pour les secrets en production ?","acceptedAnswer":{"@type":"Answer","text":"Azure Key Vault centralise la gestion des secrets avec rotation automatique, audit des accès, contrôle d'accès basé sur Azure AD et chiffrement hardware (HSM). Cela réduit le risque de compromission par rapport aux variables d'environnement qui peuvent être exposées via process dumps ou logs. L'intégration ASP.NET Core se fait via le package Azure.Extensions.AspNetCore.Configuration.Secrets."}},{"@type":"Question","name":"Comment configurer plusieurs instances d'options pour la même classe POCO avec des valeurs différentes ?","acceptedAnswer":{"@type":"Answer","text":"Les Named Options permettent d'avoir plusieurs configurations pour la même classe via un nom unique. Par exemple, plusieurs connexions DB ou clients HTTP. Configure(\"Name\", ...) enregistre une config nommée, puis IOptionsSnapshot.Get(\"Name\") ou IOptionsMonitor.Get(\"Name\") récupère l'instance voulue. Utile pour multi-tenancy ou multiples API tiers."}},{"@type":"Question","name":"Quelle est la meilleure pratique pour gérer des secrets sensibles (API keys, passwords) en production ?","acceptedAnswer":{"@type":"Answer","text":"Les secrets ne doivent jamais être dans les fichiers appsettings.json (risque de commit accidentel) ni hardcodés. En production, utiliser un secret manager (Azure Key Vault, AWS Secrets Manager) avec rotation automatique et audit. En développement, User Secrets suffit. Les variables d'environnement sont acceptables mais moins sécurisées que les secret managers."}},{"@type":"Question","name":"Quand préférer injecter IConfiguration directement plutôt que IOptions ?","acceptedAnswer":{"@type":"Answer","text":"IOptions apporte le typage fort, la validation et la séparation des concerns. Injecter IConfiguration directement crée un couplage fort avec le système de configuration et perd le typage. Réserver IConfiguration pour les cas où la structure de config est vraiment dynamique ou pour configurer les options elles-mêmes. Dans 90% des cas, préférer IOptions."}},{"@type":"Question","name":"Que se passe-t-il si une clé de configuration existe dans appsettings.json ET dans une variable d'environnement ?","acceptedAnswer":{"@type":"Answer","text":"Les providers de configuration sont chargés dans un ordre précis où les derniers écrasent les précédents. Les variables d'environnement sont ajoutées après appsettings.json donc elles gagnent. Cela permet de surcharger facilement la config en production via env vars sans toucher aux fichiers. L'ordre exact est défini dans CreateDefaultBuilder."}},{"@type":"Question","name":"Comment ajouter une source de configuration custom (ex: base de données) au système de configuration ?","acceptedAnswer":{"@type":"Answer","text":"Les sources de configuration custom implémentent IConfigurationSource (factory) et IConfigurationProvider (chargement des données). builder.Configuration.Add() enregistre la source qui sera chargée au build. Utile pour charger la config depuis une DB, API externe ou format custom. Attention aux dépendances circulaires si la source custom nécessite elle-même de la configuration."}},{"@type":"Question","name":"Comment binder un tableau JSON de appsettings.json à une propriété List dans une classe d'options ?","acceptedAnswer":{"@type":"Answer","text":"Le binding supporte nativement les tableaux JSON vers List, T[], IEnumerable. Exemple : { \"AllowedHosts\": [\"localhost\", \"example.com\"] } se bind automatiquement à public List AllowedHosts { get; set; }. Les indices de tableaux peuvent aussi être surchargés via env vars avec syntaxe AllowedHosts__0, AllowedHosts__1."}},{"@type":"Question","name":"Quel impact a le rechargement automatique de appsettings.json (reloadOnChange: true) sur les performances en production ?","acceptedAnswer":{"@type":"Answer","text":"Le rechargement surveille le fichier via FileSystemWatcher (faible overhead CPU). Le risque principal est l'incohérence : un request peut lire l'ancienne config, le suivant la nouvelle. Si la config est statique en production, désactiver reloadOnChange via WebApplicationBuilder.Configuration.Sources pour éviter les surprises. En dev, le reload est utile pour tester sans redémarrer."}}]}