Partager via


Attributs de protection de l'hôte et programmation de l'intégration CLR

Le Common Language Runtime (CLR) fournit un mécanisme permettant d’annoter des interfaces de programmation d’applications managées (API) qui font partie du .NET Framework avec certains attributs susceptibles d’intéresser un hôte du CLR, comme SQL Server, à compter de SQL Server 2005. Voici quelques exemples d'attributs de protection de l'hôte (HPA, Host Protection Attribute) :

  • SharedState, qui indique si l'API expose la capacité à créer ou gérer l'état partagé (par exemple, champs de classe statique).

  • Synchronization, qui indique si l'API expose la capacité à effectuer la synchronisation entre des threads.

  • ExternalProcessMgmt, qui indique si l'API expose une méthode pour contrôler le processus hôte.

Compte tenu de ces attributs, SQL Server spécifie une liste de HPA qui ne sont pas autorisés dans l’environnement hébergé par le biais de la sécurité d’accès du code (CAS). Les exigences du cas sont spécifiées par l’un des trois jeux d’autorisations SQL Server : SAFE, EXTERNAL_ACCESSou UNSAFE. L'un de ces trois niveaux de sécurité est spécifié lorsque l'assembly est inscrit sur le serveur, à l'aide de l'instruction CREATE ASSEMBLY. Le code exécuté dans les jeux d'autorisations SAFE ou EXTERNAL_ACCESS doit éviter certains types ou membres dont l'attribut System.Security.Permissions.HostProtectionAttribute est appliqué. Pour plus d’informations, consultez Création d’un assembly et de restrictions de modèle de programmation d’intégration CLR.

HostProtectionAttribute n'est pas tant une autorisation de sécurité qu'une façon d'améliorer la fiabilité, dans le sens où il identifie des constructions de code spécifiques, à savoir des types ou des méthodes, que l'hôte peut rejeter. L'utilisation de HostProtectionAttribute applique un modèle de programmation qui contribue à protéger la stabilité de l'hôte.

Attributs de protection de l'hôte

Les attributs de protection de l'hôte identifient des types ou des membres qui ne sont pas adaptés au modèle de programmation hôte et représentent les niveaux croissants suivants de menace en termes de fiabilité :

  • Sans gravité par ailleurs.

  • Susceptible de déstabiliser le code utilisateur géré par le serveur.

  • Susceptible de déstabiliser le processus serveur lui-même.

SQL Server interdit l’utilisation d’un type ou d’un membre qui a un HostProtectionAttribute qui spécifie une System.Security.Permissions.HostProtectionResource énumération avec la valeur ExternalProcessMgmt, ExternalThreading, MayLeakOnAbortSecurityInfrastructure, SelfAffectingProcessMgmnt, SelfAffectingThreading, SharedState, Synchronization, , ou UI. Cela empêche les assemblys d’appeler des membres qui activent l’état de partage, effectuent la synchronisation, peuvent entraîner une fuite de ressource à l’arrêt ou affectent l’intégrité du processus SQL Server.

Types et membres rejetés

Les rubriques suivantes identifient les types et les membres dont HostProtectionResource les valeurs ne sont pas autorisées par SQL Server.

Notes

Les listes de ces rubriques ont été générées à partir des assemblys pris en charge. Pour plus d’informations, consultez Bibliothèques .NET Framework prises en charge.

Dans cette section

Types et membres interdits dans Microsoft.VisualBasic.dll
Répertorie les types et membres dans Microsoft.VisualBasic.dll dont les valeurs HPA sont rejetées.

Types et membres interdits dans mscorlib.dll
Répertorie les types et membres dans mscorlib.dll dont les valeurs HPA sont rejetées.

Types et membres non autorisés dans System.dll
Répertorie les types et membres dans System.dll dont les valeurs HPA sont rejetées.

Types et membres non autorisés dans System.Data.dll
Répertorie les types et membres dans System.Data.dll dont les valeurs HPA sont rejetées.

Types et membres interdits dans System.Core.dll
Répertorie les types et membres dans System.Core.dll dont les valeurs HPA sont rejetées.

Voir aussi

Sécurité d'accès du code de l'intégration du CLR
Restrictions du modèle de programmation de l'intégration du CLR
Création d'un assembly