Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce guide de démarrage rapide vous montre comment utiliser davantage de kits SDK de protection MIP. À l’aide de l’un des modèles de protection que vous avez répertoriés dans le guide de démarrage rapide précédent, vous utilisez un gestionnaire protection pour chiffrer du texte ad hoc. La classe de gestionnaire Protection expose différentes opérations pour appliquer/supprimer la protection.
Conditions préalables
Si ce n’est déjà fait, veillez à remplir les conditions préalables suivantes avant de continuer :
- Démarrage rapide complet : Répertoriez d’abord les modèles de protection (C#), qui créent une solution Visual Studio de démarrage, pour répertorier les modèles de protection disponibles pour l’utilisateur authentifié. Ce guide de démarrage rapide « Chiffrer/Déchiffrer le texte » s’appuie sur le précédent.
- Optionnellement: passez en revue les concepts des gestionnaires de protection dans le SDK MIP.
Ajouter une logique pour définir et obtenir un modèle de protection
Ajoutez une logique pour chiffrer du texte ad hoc à l’aide de l’objet moteur de protection.
À l’aide de l’Explorateur de solutions, ouvrez le fichier .cs dans votre projet qui contient l’implémentation de la méthode Main(). Il a par défaut le même nom que le projet qui le contient, que vous avez spécifié lors de la création du projet.
Vers la fin du corps
Main()
(là où vous vous êtes arrêté dans le précédent Démarrage rapide), insérez le code suivant ://Set text to encrypt and template ID string inputText = "<Sample-text>"; string templateId = "<template-id>"; //Create a template based publishing descriptor ProtectionDescriptor protectionDescriptor = new ProtectionDescriptor(templateId); //Create publishing settings using protection descriptor PublishingSettings publishingSettings = new PublishingSettings(protectionDescriptor); //Generate Protection Handler for publishing var publishingHandler = Task.Run(async() => await protectionEngine.CreateProtectionHandlerForPublishingAsync(publishingSettings)).Result; //Encrypt text using Publishing handler long bufferSize = publishingHandler.GetProtectedContentLength(inputText.Length, true); byte[] inputTextBuffer = Encoding.ASCII.GetBytes(inputText); byte[] encryptedTextBuffer = new byte[bufferSize]; publishingHandler.EncryptBuffer(0, inputTextBuffer, encryptedTextBuffer, true); Console.WriteLine("Original text: {0}", inputText); Console.WriteLine("Encrypted text: {0}", Encoding.UTF8.GetString(encryptedTextBuffer)); //Create a Protection handler for consumption using the same publishing licence var serializedPublishingLicense = publishingHandler.GetSerializedPublishingLicense(); PublishingLicenseInfo plInfo = PublishingLicenseInfo.GetPublishingLicenseInfo(serializedPublishingLicense); ConsumptionSettings consumptionSettings = new ConsumptionSettings(plInfo); var consumptionHandler = protectionEngine.CreateProtectionHandlerForConsumption(consumptionSettings); //Use the handler to decrypt the encrypted text long buffersize = encryptedTextBuffer.Length; byte[] decryptedBuffer = new byte[bufferSize]; var bytesDecrypted = consumptionHandler.DecryptBuffer(0, encryptedTextBuffer, decryptedBuffer, true); byte[] OutputBuffer = new byte[bytesDecrypted]; for (int i = 0; i < bytesDecrypted; i++){ OutputBuffer[i] = decryptedBuffer[i]; } Console.WriteLine("Decrypted content: {0}", Encoding.UTF8.GetString(OutputBuffer)); Console.WriteLine("Press a key to quit."); Console.ReadKey();
Vers la fin de
Main()
, recherchez le bloc d’arrêt d’application créé dans le premier démarrage rapide et ajoutez les lignes de gestionnaire :// Application Shutdown publishingHandler = null; consumptionHandler = null; protectionEngine = null; protectionProfile = null; mipContext = null;
Remplacez les valeurs de remplacement dans le code source en utilisant les valeurs suivantes :
Espace réservé Valeur <exemple de texte> Exemple de texte que vous souhaitez chiffrer, par exemple : My secure text
.<template-id> ID de modèle, copié à partir de la sortie de la console dans le démarrage rapide précédent, par exemple : bb7ed207-046a-4caf-9826-647cff56b990
.
Concevoir et tester l’application
Générez et testez votre application cliente.
Utilisez ctrl-SHIFT-B (générer la solution) pour générer votre application cliente. Si vous n’avez aucune erreur de build, utilisez F5 (Démarrer le débogage) pour exécuter votre application.
Si votre projet génère et s’exécute correctement, l’application peut demander l’authentification via ADAL chaque fois que le SDK appelle votre
AcquireToken()
méthode. Si des informations d’identification mises en cache existent déjà, vous ne serez pas invité à vous connecter et à afficher la liste des étiquettes, suivie des informations sur l’étiquette appliquée et le fichier modifié.
Original content: My secure text
Encrypted content: c?_hp???Q??+<?
Decrypted content: My secure text
Press a key to quit.