Obliczanie akcji

  • Artykuł
  • Czas czytania: 2 min

Zgodnie ze szczegółowymi informacjami podstawowymi zestawu SDK zasad są:

  • Lista dostępnych etykiet
  • zwraca zestaw akcji, które należy podjąć, na podstawie bieżącego i odpowiedniego stanu

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

Przykładowy kod tego artykułu można znaleźć w GitHub.

Obliczanie akcji dla nowej etykiety

Obliczenia dla nowej etykiety można uzyskać przy użyciu zdefiniowanej w mip::ActionsExecutionStateImpl stanie mip::Actions

// Replace with valid label ID.
string newLabelId = "d7b93a40-4df3-47e4-b2fd-7862fc6b095c"; 
sample::policy::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);

Podczas pisania tylko mip::MetadataActions zwróconych jako część actions ekranów:

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

Oblicza PolicyHandler akcje i zwraca wartość a std::vectormip::Action . To deweloper aplikacji może zastosować te metadane do pliku lub danych.

Uwaga

W powyższym przykładzie wyświetlane są tylko mip::MetadataAction dane wyjściowe. Aby zapoznać się z przykładem wyświetlania dodatkowych typów akcji, przejrzyj przykładowe pakiety z plikiem do pobrania zestawu POLICY SDK.

Akcje obliczeniowe z istniejącą etykietą

Podczas korzystania z zestawu SDK zasad do aplikacji należy odczytywanie metadanych z zawartości. Te metadane są dostarczane do interfejsu API w ramach mip::ExecutionState . ComputeActions() może obsługiwać bardziej złożone operacje niż stosowanie nowej etykiety do dokumentu bez etykiety. W poniższym przykładzie pokazano, jak oceniać etykietę z bardziej poufnej na mniej wrażliwą. Ten proces jest symulowany przez odczytanie ciągu metadanych rozdzielanego przecinkami i udostępnienie interfejsu API za mip::ExecutionState pośrednictwem.

Uwaga

W tym przykładzie użyto funkcji narzędzia o nazwie SplitString() . Przykład można znaleźć tutaj

// 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::policy::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 czynności zależą od etykiet podanych jako dane wejściowe i od ich konfiguracji. Wynikiem co najmniej będzie jeden wynik zawierający dane do usunięcia, przez i dane do mip::MetadataActionGetMetadataToRemove() dodania za pośrednictwem 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