快速入门:使用 MIP SDK (C#) 加密/解密文本

本快速入门介绍如何使用更多的 MIP 保护 SDK。 使用上一快速入门中列出的其中一个保护模板,通过保护处理程序来加密临时文本。 保护处理程序类公开用于应用/删除保护的各种操作。

必备条件

如果尚未操作,请务必在继续之前完成以下先决条件:

添加逻辑以设置和获取敏感度标签

使用保护引擎对象添加逻辑以加密临时文本。

  1. 使用“解决方案资源管理器”,打开项目中包含 Main()` 方法的实现的 .cs 文件。 它默认与包含它的项目同名,即在项目创建期间指定的名称。

  2. Main() 正文的末尾(在上一快速入门中离开的位置),插入以下代码:

    //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();
    
    
  3. 在靠近 Main() 的末尾处,查找在第一个快速入门中创建的应用程序关闭块,并添加处理程序行:

    // Application Shutdown
    publishingHandler = null;
    consumptionHandler = null;
    protectionEngine = null;
    protectionProfile = null;
    mipContext = null;
    
  4. 使用以下值替换源代码中的占位符值:

    占位符
    <sample-text> 要加密的示例文本,例如:My secure text
    <template-id> 模板 ID,从上一快速入门中的控制台输出所复制,例如:bb7ed207-046a-4caf-9826-647cff56b990

生成和测试应用程序

生成和测试客户端应用程序。

  1. 使用 CTRL-SHIFT-B(“生成解决方案”)来生成客户端应用程序。 如果没有生成错误,请使用 F5(开始调试)来运行应用程序。

  2. 如果项目成功生成并运行,则每次 SDK 调用 方法时,应用程序都可能提示通过 ADAL 进行身份验证。 如果已有缓存凭据,你就不会看到登录和查看标签列表的提示(后跟已应用标签和已修改文件的相关信息)。

 Original content: My secure text
 Encrypted content: c?_hp???Q??+<?
 Decrypted content: My secure text
 Press a key to quit.