Résumé: ASP.NET is a flexible set of tools and web development technologies that allows you to employ a number of applications based on the ASP.NET framework.

In this topic, you will learn how to configure the server-wide ASP.NET settings in Plesk.

Vue d’ensemble

Plesk supports ASP.NET 2.0 and 4.x, as well as ASP.NET Core 2.1 and later. Most ASP.NET configuration settings that commonly need to be customized in order for ASP.NET applications to function in a desirable way can be edited through Plesk.

Pour configurer les paramètres ASP.NET globaux du serveur :

  1. Connectez-vous à Plesk.

  2. Go to Tools & Settings > ASP.NET Settings (under « Applications & Databases »). The settings for different versions of ASP.NET are located under the corresponding tabs.

    image asp net settings

  3. Set up the strings that determine database connection data for ASP.NET applications which use databases:

    La première fois que vous ouvrez la page de configuration d’ASP.NET, des exemples de paramètres de connexion avec des constructions courantes sont affichés. Vous pouvez alors les supprimer et définir vos propres chaînes.

    • To add a string, click Add one more.
    • Pour déplacer une chaîne, cliquez sur image cross icon en regard.
  4. Configurez et saisissez les messages d’erreur personnalisés que les applications ASP.NET renverront dans le champ Paramètres pour les erreurs personnalisées :

    • Pour activer le mode Messages d’erreur personnalisés, choisissez l’option adéquate dans le menu « Mode Erreurs personnalisées » :

      • On : les messages d’erreur personnalisés sont activés.
      • Off : les messages d’erreur personnalisés sont désactivés et les erreurs détaillées sont affichées.
      • RemoteOnly : les messages d’erreur personnalisés ne sont affichés que pour les clients distants et les erreurs ASP.NET sont affichées sur l’hôte local.
    • To add a custom error message (which will be applied unless the Off mode was selected), enter the values in the « Custom errors » fields.

      • Le Code du statut définit le code du statut HTTP entraînant une redirection vers une page d’erreur.
      • L” URL de redirection définit l’adresse Web de la page d’erreur qui donne au client des informations sur l’erreur.

      Compte tenu du risque de conflit, vous ne pouvez pas ajouter de message d’erreur personnalisé avec un code d’erreur qui existe déjà, mais vous pouvez redéfinir l’URL du code existant.

    • Pour supprimer un message d’erreur personnalisé de la liste, cliquez sur l’icône image cross icon à côté de celui-ci

  5. Configure compilation settings:

    • Pour déterminer le langage de programmation à utiliser par défaut dans les fichiers de compilation dynamique, choisissez une entrée dans la liste « Langues de la page par défaut ».

    • Pour permettre la compilation des applications en mode production, ne cochez pas la case « Activer le débogage ».

    • Pour permettre la compilation d’applications en mode débogage, cochez la case « Activer le débogage ». Dans ce cas, les fragments du code source contenant une erreur seront cités dans le message de la page de diagnostic.

      Note: Lorsque les applications fonctionnent en mode de débogage, une saturation de la mémoire et/ou de la performance peut se produire. Il est recommandé d’utiliser le mode débogage lorsque vous testez une application, mais de le désactiver avant de déployer une application en production.

  6. Configure encoding settings for ASP.NET applications:

    • Pour définir un encodage adopté pour toutes les requêtes entrantes, saisissez une valeur d’encodage dans le champ « Encodage de la requête » (par défaut, utf-8).
    • Pour définir un encodage adopté pour toutes les réponses, saisissez une valeur d’encodage dans le champ « Encodage de la réponse », par défaut, utf-8.
    • Pour définir un encodage à utiliser par défaut pour analyser les fichiers .aspx, .asmx et .asax, saisissez une valeur d’encodage dans le champ « Encodage du fichier », par défaut Windows-1252.
    • Pour définir la langue à utiliser par défaut pour traiter les requêtes Web entrantes, choisissez l’élément voulu dans la liste « Langues ».
    • Pour définir la langue à utiliser par défaut lors de la recherche d’une ressource liée à un fichier de langue, choisissez l’élément voulu dans la liste « Langues UI ».
  7. Set a code access security trust level for ASP.NET applications:

    Le niveau de confiance CAS est un ensemble de restrictions appliquées à une app. Par exemple : le niveau Faible restreint les capacités réseau de l’app (comme l’envoi de mail). Le niveau Élevé supprime toutes les restrictions.

    • Pour autoriser le changement du niveau de confiance CAS des sites Web, cochez la case « Autoriser la modification du niveau de confiance CAS pour les sites Web individuels ». Si vous ne cochez pas cette case, les sites Web utilisent le paramètre de niveau serveur. Dans le cas contraire, chaque site Web dispose de son propre niveau de confiance CAS. Celui-ci est défini dans les paramètres d’hébergement du site Web.

      Note: Lorsqu’un assembleur se voit affecter un niveau de confiance trop bas, il ne fonctionne pas correctement. Pour en savoir plus sur les niveaux de droits, consultez l’article https://msdn.microsoft.com/fr-fr/library/Aa302425

  8. Définissez les paramètres des sessions client dans le champ « Paramètres de session » :

    • Pour configurer le mode d’authentification par défaut pour les applications, choisissez l’élément qui convient dans la liste « Mode d’authentification ». Le mode d’authentification « Windows » doit être sélectionné si une forme d’authentification IIS est utilisée.
    • Pour définir la durée pendant laquelle une session peut rester inactive avant d’être fermée, saisissez la valeur voulue en minutes dans le champ « Délai d’expiration de session (minutes) ».
  9. Click Save to apply all changes.

Note: Plesk prend en charge des configurations distinctes selon les versions du framework .NET.

Note: If you want to use ASP.NET Core web applications, select the « Microsoft ASP.NET Core  » component when installing Plesk. After that, you can upload your ASP.NET Core application to your web site and use it. In this case, it is recommended to switch off the ASP.NET support for your domain to save server resources. To do so, go to Websites & Domains > find the domain that will host your application > go to the « Hosting & DNS » tab > Hosting and clear the Microsoft ASP.NET checkbox.