Oblicz działanie

Jak opisano wcześniej, podstawowe funkcje zestawu SDK zasad to:

  • lista dostępnych etykiet
  • zwraca zestaw akcji, które należy wykonać przez aplikację na podstawie bieżącego i żądanego stanu

Ostatnim krokiem procesu jest podanie identyfikatora etykiety i opcjonalnie metadanych dotyczących istniejącej etykiety do ComputeActions() funkcji.

Przykładowy kod dla tego artykułu jest dostępny w GitHub.

Oblicz akcję dla nowej etykiety

Oblicz mip::Actions dla nowej etykiety przy użyciu ExecutionStateImpl zdefiniowanego w ExecutionState.

// Replace with valid label ID.
string newLabelId = "d7b93a40-4df3-47e4-b2fd-7862fc6b095c";
sample::upe::ExecutionStateOptions options;

// Resolve desired label id to mip::Label and set in ExecutionStateOptions.
options.newLabel = mEngine->GetLabelById(newLabelId);

// Initialize ExecutionStateImpl with options, create handler, call ComputeActions.
std::unique_ptr<ExecutionStateImpl> state(new ExecutionStateImpl(options));
auto handler = mEngine->CreatePolicyHandler(false); // Don't generate audit event.
auto actions = handler->ComputeActions(*state);

Zapisywanie tylko zwróconych mip::MetadataActions elementów w ramach wyświetlania actions :

Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled : true
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate : 2018-10-23T20:39:06-0800
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method : Standard
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name : Contoso FTEs (C)
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId : 94f6984e-8d31-4794-bdeb-3ac89ad2b660
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId : 2266fbe8-a0d9-44e8-bad8-00008f2a0915
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits : 3

Funkcja PolicyHandler oblicza akcje i zwraca wartość typu std::vectormip::Action. Deweloper aplikacji musi zastosować te metadane do pliku lub danych.

Uwaga / Notatka

Poprzedni przykład wyświetla tylko dane wyjściowe mip::MetadataAction. Przykład prezentujący inne typy akcji można znaleźć w przykładowych pakietach dołączonych do pobieranego pakietu Policy SDK.

Oblicz akcje z istniejącą etykietą

Gdy używasz zestawu SDK zasad, aplikacja odczytuje metadane z zawartości. Aplikacja udostępnia te metadane interfejsowi API w ramach elementu mip::ExecutionState. ComputeActions() może obsługiwać bardziej złożone operacje niż stosowanie nowej etykiety do dokumentu bez etykiet. W poniższym przykładzie pokazano obniżenie poziomu etykiety z etykiety bardziej wrażliwej na mniej wrażliwą etykietę. Przykład symuluje ten proces, odczytując rozdzielony przecinkami ciąg metadanych i dostarczając go do interfejsu API za pośrednictwem elementu mip::ExecutionState.

Uwaga / Notatka

W przykładzie użyto funkcji narzędzia o nazwie SplitString(). Przykład można znaleźć w źródleSplitString() funkcji narzędziowej.

// Replace with valid label ID.
string newLabelId = "d7b93a40-4df3-47e4-b2fd-7862fc6b095c";

// Comma and Pipe Delimited Metadata.
string metadata = "MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled|true,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate|2018-10-23T21:53:31-0800,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method|Standard,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name|Contoso FTEs (C),MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId|94f6984e-8d31-4794-bdeb-3ac89ad2b660,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId|b56491d9-155f-40ff-866f-0000acd85c31,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits|7";

// Create ExecutionStateOptions and resolve newLabelId to mip::Label
sample::upe::ExecutionStateOptions options;
options.newLabel = mEngine->GetLabelById(newLabelId);

// Split metadata string by commas, store in vector.
vector<string> metadataPairs = sample::utils::SplitString(metadata, ',');

// Iterate through each string, splitting by the pipe.
// Add each key/value pair to ExecutionStateOptions metadata.
for (const string& metadataPair : metadataPairs) {
    vector<string> keyValue = sample::utils::SplitString(metadataPair, '|');
    options.metadata[keyValue[0]] = keyValue[1];
}

// Initialize ExecutionStateImpl with options, create handler, call ComputeActions
std::unique_ptr<ExecutionStateImpl> state(new ExecutionStateImpl(options));
auto handler = mEngine->CreatePolicyHandler(false); // Don't generate audit event.
auto actions = handler->ComputeActions(*state);

Powyższy przykład może spowodować kilka akcji. Te akcje zależą od etykiet podanych jako danych wejściowych i konfiguracji etykiety. W minimalnym przypadku wynikiem jest pojedynczy element mip::MetadataAction, który zawiera dane do usunięcia przez GetMetadataToRemove() oraz dane do dodania przez GetMetadataToAdd().

Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Enabled : true
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_SetDate : 2018-10-23T23:59:41-0800
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Method : Standard
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Name : General
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_SiteId : 94f6984e-8d31-4794-bdeb-3ac89ad2b660
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_ActionId : 447a996b-28ea-482c-b0b5-000075bd4bb3
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_ContentBits : 7
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId

Następne kroki

  • Ostatnia aktualizacja o