Microsoft Information Protection SDK pliku — justowanie akcji w celu obniżenia wrażliwości na plik (C#)

  • Artykuł
  • Czas czytania: 3 min

Ten przewodnik Szybki start dotyczy operacji zmiany na starszą wersję etykiety, gdy zasady dotyczące etykiet wymagają uzasadnienia. W tym miejscu użyjemy IFileHandler interfejsu do zmieniania etykiet pliku. Aby uzyskać więcej szczegółowych informacji, zapoznaj się z informacjami na temat interfejsu API.

Wymagania wstępne

Jeśli jeszcze tego nie zrobić, przed kontynuowaniem upewnij się, że są spełnione następujące wymagania wstępne:

Dodawanie logiki w celu ustawienia niższej etykiety pliku chronionego

Dodaj logikę, aby ustawić etykietę wrażliwości na plik przy użyciu obiektu obsługi plików.

  1. Otwórz Visual Studio zostało utworzone w poprzednim "Szybki start: Ustawianie/uzyskiwanie etykiet wrażliwości(C#).

  2. Za pomocą Eksploratora rozwiązań otwórz plik cs w projekcie, który zawiera implementację Main() metody. Domyślna nazwa jest taka sama jak nazwa projektu zawierającego projekt, która jest określona podczas tworzenia projektu.

  3. Należy <label-id> zaktualizować wartość z poprzedniego szybkiego startu do etykiety wrażliwości, która wymaga uzasadnienia w celu obniżenia wartości. Podczas tego uruchomienia szybki start ustawimy tę etykietę w pierwszej kolejności, a następnie spróbujemy obniżyć ją za pomocą fragmentów kodu w kolejnych krokach.

  4. Na końcu treści, poniżej i powyżej bloku zamykania aplikacji (na końcu którego został zakończony poprzedni szybki start), wstaw Main()Console.ReadKey() następujący kod.

    //Set paths and label ID
string lowerInput = actualOutputFilePath;
string lowerActualInput = lowerInput;
string newLabelId = "<new-label-id>";
string lowerOutput = "<downgraded-labled-output>";
string lowerActualOutput = lowerOutput;

//Create a file handler for that file
var downgradeHandler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(lowerInput, lowerActualInput, true)).Result;

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

try
{
    //Try to set new label
    downgradeHandler.SetLabel(fileEngine.GetLabelById(newLabelId), options, new ProtectionSettings());
}

catch (Microsoft.InformationProtection.Exceptions.JustificationRequiredException)
{
    //Request justification from user
    Console.Write("Please provide justification for downgrading a label: ");
    string justification = Console.ReadLine();

    options.IsDowngradeJustified = true;
    options.JustificationMessage = justification;

    //Set new label
    downgradeHandler.SetLabel(fileEngine.GetLabelById(newLabelId), options, new ProtectionSettings());
}

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

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

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

  5. Pod koniec artykułu Main() znajdź blok zamykania aplikacji utworzony w poprzednim przewodniku szybki start i dodaj poniżej linii obsługi, aby zwolnić zasoby.

    downgradeHandler = null;
commitHandler = null;

  6. Zamień wartości zastępcze w kodzie źródłowym na następujące wartości:

    Symbol zastępczy Wartość
    <downgraded-labled-output> Ścieżka pliku wyjściowego, w którym chcesz zapisać zmodyfikowany plik.
    <new-label-id> Identyfikator szablonu skopiowany z danych wyjściowych konsoli w poprzednim przewodniku Szybki start, na przykład: bb7ed207-046a-4caf-9826-647cff56b990 . Upewnij się, że ma on niższą czułość niż wcześniej chroniona etykieta pliku.

Tworzenie i testowanie aplikacji

Skompilowanie i testowanie aplikacji klienckiej.

  1. Do tworzenia aplikacji klienckiej użyj klawiszy CTRL-SHIFT-B(rozwiązaniekompilacji). Jeśli nie występują błędy kompilacji, użyj klawisza F5(Rozpocznijdebugowanie), aby uruchomić aplikację.

  2. Jeśli projekt zostanie pomyślnie skompilowany i uruchomiony, aplikacja może za każdym razem, gdy zestaw SDK wywoła metodę, może zostać wyświetlony monit o uwierzytelnienie za pośrednictwem usługi ADAL. Jeśli poświadczenia buforowane już istnieją, nie zostanie wyświetlony monit o zalogowanie się i wyświetlanie listy etykiet oraz informacji na zastosowanej etykiecie i zmodyfikowanym pliku.

  Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
  Public : 73254501-3d5b-4426-979a-657881dfcb1e
  General : da480625-e536-430a-9a9e-028d16a29c59
  Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
  Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
  Press a key to continue.

  Getting the label committed to file: c:\Test\Test_labeled.docx
  Name: Confidential
  IsProtected: True
  Press any key to continue . . .

  Please provide justification for downgrading a label: Lower label approved.
  Getting the new label committed to file: c:\Test\Test_downgraded.docx
  File Label: General
  IsProtected: False
  Press a key to continue.

Podobnie jest w przypadku operacji, gdy usunięcie etykiety z pliku wymaga uzasadnienia zgodnie z DeleteLabel() zasadami.DeleteLabel() funkcja zgłasza wyjątek, a flaga powinna być ustawiona na true w JustificationRequiredExceptionIsDowngradeJustified obsłudze wyjątków przed pomyślnym usunięciem etykiety.