Hızlı Başlangıç: Duyarlılık etiketi ayarlama ve alma (C#)

  • Makale

Bu Hızlı Başlangıçta, MIP Dosya SDK'larının daha fazlasını nasıl kullanacağınız gösterilmektedir. Önceki Hızlı Başlangıçta listelediğiniz duyarlılık etiketlerinden birini kullanarak bir dosyaya etiket ayarlamak/almak için Dosya işleyicisi kullanırsınız. Dosya işleyici sınıfı, desteklenen dosya türleri için etiket ayarlama/alma veya koruma için çeşitli işlemleri kullanıma sunar.

Ön koşullar

Henüz yapmadıysanız devam etmeden önce aşağıdaki önkoşulları tamamladığınızdan emin olun:

Duyarlılık etiketi ayarlamak ve almak için mantık ekleme

Dosya altyapısı nesnesini kullanarak dosyaya duyarlılık etiketi ayarlamak ve almak için mantık ekleyin.

  1. Çözüm Gezgini kullanarak projenizde Main()' yönteminin uygulamasını içeren .cs dosyasını açın. Varsayılan olarak, proje oluşturma sırasında belirttiğiniz, onu içeren projeyle aynı ada sahiptir.

  2. Gövdenin sonuna doğru, açıklamanın Main()//Application Shutdown arkasına var fileEngine = ve üstüne aşağıdaki kodu ekleyin:

      //Set paths and label ID
  string inputFilePath = "<input-file-path>";
  string actualFilePath = inputFilePath;
  string labelId = "<label-id>";
  string outputFilePath = "<output-file-path>";
  string actualOutputFilePath = outputFilePath;

  //Create a file handler for that file
  //Note: the 2nd inputFilePath is used to provide a human-readable content identifier for admin auditing.
  var handler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(inputFilePath, actualFilePath, true)).Result;

  //Set Labeling Options
  LabelingOptions labelingOptions = new LabelingOptions()
  {
       AssignmentMethod = AssignmentMethod.Standard
  };

  // Set a label on input file
  handler.SetLabel(fileEngine.GetLabelById(labelId), labelingOptions, new ProtectionSettings());

  // Commit changes, save as outputFilePath
  var result = Task.Run(async () => await handler.CommitAsync(outputFilePath)).Result;

  // Create a new handler to read the labeled file metadata
  var handlerModified = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(outputFilePath, actualOutputFilePath, true)).Result;

  // Get the label from output file
  var contentLabel = handlerModified.Label;
  Console.WriteLine(string.Format("Getting the label committed to file: {0}", outputFilePath));
  Console.WriteLine(string.Format("File Label: {0} \r\nIsProtected: {1}", contentLabel.Label.Name, contentLabel.IsProtectionAppliedFromLabel.ToString()));
  Console.WriteLine("Press a key to continue.");
  Console.ReadKey();

  3. Main() İlk hızlı başlangıçta oluşturulan uygulama kapatma bloğunu bulun ve işleyici satırının açıklamasını kaldırın:

    // Application Shutdown
handler = null;
fileEngine = null;
fileProfile = null;
mipContext = null;

  4. Aşağıdaki değerleri kullanarak kaynak koddaki yer tutucu değerlerini değiştirin:

    Yer tutucu Değer
    <input-file-path> Bir test giriş dosyasının tam yolu, örneğin: c:\\Test\\Test.docx.
    <label-id> Önceki Hızlı Başlangıç'ta konsol çıkışından kopyalanan duyarlılık etiketi kimliği, örneğin: f42a3342-8706-4288-bd31-ebb85995028z.
    <output-file-path> Çıkış dosyasının tam yolu; giriş dosyasının etiketli bir kopyası olacaktır, örneğin: c:\\Test\\Test_labeled.docx.

Uygulamayı derleme ve test etme

İstemci uygulamanızı derleyin ve test edin.

  1. İstemci uygulamanızı derlemek için CTRL-SHIFT-B (Çözüm Derleme) kullanın. Derleme hatanız yoksa, uygulamanızı çalıştırmak için F5 (Hata ayıklamayı başlat) kullanın.

  2. Projeniz başarıyla derlenip çalıştırılırsa, SDK yönteminizi AcquireToken() her çağırdığında uygulama ADAL aracılığıyla kimlik doğrulaması isteyebilir. Önbelleğe alınmış kimlik bilgileri zaten varsa, oturum açmanız ve etiket listesini ve ardından uygulanan etiket ve değiştirilen dosyadaki bilgileri görmeniz istenmez.

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

 Applying Label ID 074e457c-5848-4542-9a6f-34a182080e7z to c:\Test\Test.docx
 Committing changes

 Label committed to file: c:\Test\Test_labeled.docx
 Press any key to continue.

 Getting the label committed to file: c:\Test\Test_labeled.docx
 File Label: Confidential
 IsProtected: false   
 Press any key to continue.

Çıkış dosyasını açıp belgenin bilgi koruma ayarlarını görsel olarak inceleyerek etiketin uygulamasını doğrulayabilirsiniz.

Dekont

Bir Office belgesini etiketlediyseniz ancak erişim belirtecinin alındığı Microsoft Entra kiracısından bir hesap kullanarak oturum açmadıysanız (ve duyarlılık etiketleri yapılandırıldıysa), etiketli belgeyi açabilmeniz için önce oturum açmanız istenebilir.