Comment : importer un jeu d'autorisations à l'aide d'un fichier XML

Article
09/04/2008

Mise à jour : novembre 2007

Le fichier XML peut contenir un jeu d'autorisations (avec ou sans autorisation personnalisée) qui contient les autorisations que l'application doit exécuter. Vous pouvez importer le jeu d'autorisations dans la stratégie de sécurité en utilisant l'Outil .NET Framework Configuration (Mscorcfg.msc) ou en utilisant l'Outil Code Access Security Policy Tool (Caspol.exe).

Ajout d'une autorisation personnalisée à l'aide de l'outil .NET Framework Configuration

L'exemple suivant illustre un jeu d'autorisations et une autorisation dans un fichier XML.

<PermissionSet class="NamedPermissionSet" version="1"
  Name="MyPermissionSet"
  Description="Permission set containing my custom permission">
  <IPermission class="myCustomNamespace.CustomPermission, customPerm,
    Version=0.0.0.0, Culture=neutral, PublicKeyToken=64a85a7d791b1a32"
    version="1" Unrestricted="True"/>
</PermissionSet>

L'élément <PermissionSet> peut contenir un nombre quelconque d'éléments <IPermission> représentant les autorisations dans le jeu d'autorisations. L'attribut class contient généralement la valeur "NamedPermissionSet" ou "System.Security.NamedPermissionSet". L'attribut version indique la version du .NET Framework. L'attribut Name est le nom du jeu d'autorisations tel qu'il apparaît dans l'outil .NET Framework Configuration. L'attribut Description fournit une description du jeu d'autorisations. Vous pouvez modifier les attributs Name et Description.

Attention :
Avant d'ajouter le jeu d'autorisation à la stratégie de sécurité, vous devrez peut-être modifier le fichier XML de sorte que l'état des autorisations corresponde à vos besoins. Consultez la documentation de l'application pour obtenir des informations sur les attributs spécifiques de l'autorisation et la manière de modifier son état.

Pour importer un jeu d'autorisations d'un fichier XML à l'aide de Mscorcfg.msc

Dans le .NET Framework 1.0 et 1.1, tapez ce qui suit dans l'invite de commandes : %Systemroot%\Microsoft.NET\Framework\numéroVersion\Mscorcfg.msc. Dans le .NET Framework 2.0, démarrez le Invite de commandes du Kit de développement SDK et tapez mscorcfg.msc.

L'interface utilisateur de l'outil apparaît.
Développez le nœud Stratégie de sécurité du runtime.
Développez le nœud du niveau de stratégie auquel ajouter le jeu d'autorisations.
Cliquez avec le bouton droit sur Jeux d'autorisations, puis choisissez Nouveau.
Cliquez sur Importer un jeu d'autorisations à partir d'un fichier XML et sélectionnez le fichier XML qui contient les informations relatives au jeu d'autorisations.
Associez le jeu d'autorisations à un groupe de codes. Pour plus d'informations, consultez Configuration des groupes de codes à l'aide de l'outil .NET Framework Configuration Tool (Mscorcfg.msc).

Ajout d'une autorisation personnalisée à l'aide de l'outil Code Access Security Policy Tool

Le Outil Code Access Security Policy Tool (Caspol.exe) est fourni avec le Kit de développement logiciel (SDK) Windows et prend en charge le script pour modifier la stratégie de sécurité. Vous pouvez utiliser Caspol.exe pour ajouter de nouveaux jeux d'autorisations, mais pas pour modifier des jeux d'autorisations. Si le fichier XML possède uniquement une autorisation (et non un jeu d'autorisations) et que vous voulez ajouter cette autorisation à l'aide de Caspol.exe, vous devez encapsuler l'autorisation dans un jeu d'autorisations.

Pour ajouter un jeu d'autorisations à l'aide de Caspol.exe

Tapez la commande suivante à l'invite de commandes :

caspol {-entreprise|-machine|-user} -addpset Fichierxml

Dans cette commande, Fichierxml est le nom du fichier qui contient le jeu d'autorisations et l'autorisation.