Étendue des modifications/accès à la configuration

Le système de configuration IIS est une hiérarchie qui s’étend de la configuration du serveur web racine jusqu’à des dossiers individuels avec une application web. Le fichier de configuration racine est nommé applicationHost.config et se trouve dans le répertoire d’installation IIS. Le reste de la configuration d’une application web existe dans web.config fichiers dans les répertoires de l’application. L’un des avantages de l’utilisation de fichiers web.config est que l’application peut introduire la configuration à différents chemins d’accès sans affecter le serveur web dans son ensemble. En même temps, il est possible de définir la configuration dans le applicationHost.config racine qui cible uniquement un chemin spécifique à l’intérieur d’une application web spécifique. Cela signifie qu’il existe deux façons différentes de penser à l’étendue de la configuration.

1. Lecture/modification de la configuration d’un chemin arbitraire d’une application web.
2. Modification de la configuration d’un chemin spécifique, mais en plaçant la configuration dans un fichier de configuration à un niveau supérieur dans la hiérarchie de configuration.
   • Exemple : modification d’un paramètre pour le site web par défaut/MyApp/MyFolder et le placer dans le fichier web.config situé à la racine du site web par défaut

Ciblage d’un chemin spécifique dans une application web

L’interrogation de la configuration à un certain chemin est effectuée à l’aide du filtre de requête d’étendue .

Exemple (la chaîne de requête n’est pas codée en URL pour la lisibilité) :

GET https://localhost:55539/api/webserver/http-request-filtering?scope=Default Web Site/MyApp/MyFolder

Cette requête indique à l’API d’interroger les paramètres de filtrage des requêtes pour le répertoire MyFolder dans l’application MyApp du site web par défaut. La ressource de filtrage des demandes retournée aura l’ID nécessaire pour modifier les paramètres à ce niveau au sein du système de configuration.

Définition de la configuration et stockage de celui-ci à un niveau supérieur

Le cas d’usage le plus courant de cette fonctionnalité consiste à définir des paramètres de configuration auxquels seuls les administrateurs de serveur web ont accès à l’interaction tactile. Cette opération est généralement effectuée pour les éléments susceptibles d’affecter la sécurité globale du serveur web. En règle générale, ces paramètres ne peuvent pas être définis dans les fichiers web.config d’une application afin qu’un administrateur web puisse configurer les applications et indiquer aux paramètres de résider dans le fichier applicationHost.config . Cette opération est implémentée dans le fichier applicationHost.config à l’aide d’un <élément d’emplacement> qui pointe vers le chemin de configuration que les paramètres doivent affecter.

Pour ce faire, utilisez config_scope dans le corps d’une requête PATCH utilisée pour modifier les paramètres. La valeur de la propriété config_scope doit être le chemin d’accès du serveur web au fichier de configuration dans lequel les paramètres doivent résider. Par exemple, le chemin d’accès vide « » fait référence au fichier applicationHost.config racine et le chemin « Site Web par défaut/MyApp » fait référence au fichier web.config dans l’application MyApp au sein du site web par défaut.

Exemple :

Supposons que l’objectif est d’activer la navigation dans le répertoire pour le chemin d’accès par défaut site web/MyApp/MyFolder, l’ID de cette ressource est WXYZ et les paramètres doivent être stockés dans le fichier applicationHost.config.

PATCH https://localhost:55539/api/webserver/directory-browsing/WXYZ

{
    "enabled": "true",
    "config_scope": ""
}