Aracılığıyla paylaş

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

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.

Önkoşullar

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

Duyarlılık etiketini belirle ve almak için kod ekle

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

  1. Çözüm Gezgini'ni kullanarak projenizde Main()' yönteminin uygulamasını içeren .cs dosyasını açın. Proje oluşturma sırasında belirlediğiniz isim, varsayılan olarak projeyle aynı olup onu içeren yapıdadır.

  2. Gövdenin sonuna doğru, var fileEngine ='den sonra ve //Application Shutdown açıklamasının üstünde, 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
    <giriş dosyası yolu> 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.
    <çıktı dosyası yolu> Çıkış dosyasının tam yolu, giriş dosyasının etiketli bir kopyası olacak şekilde, ö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ü Derle) 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 istenmez ve doğrudan etiketler listesini görebilir, ardından uygulanan etiketle ilgili bilgileri ve değiştirilen dosyayı inceleyebilirsiniz.

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.

Uyarı

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.

  • Last updated on