Microsoft Information Protection File SDK – A bizalmassági címke fájlon való csökkentésének műveleti indoklása (C++)
Ez a rövid útmutató egy leminősítési címkeművelet kezelését ismerteti, ha a címkeszabályzat indoklást igényel. Ebben az esetben egy fájl címkéinek módosításához osztályt használunk mip::FileHandler
. További részletekért tekintse meg az API-referenciát.
Előfeltételek
Ha még nem tette meg, a folytatás előtt mindenképpen végezze el a következő előfeltételeket:
- Kész rövid útmutató: Először a bizalmassági címkék (C++) beállítása/lekérése, amely egy kezdő Visual Studio-megoldást hoz létre a szervezet bizalmassági címkéinek listázásához, a bizalmassági címkék fájlba vagy fájlból való beállításához és olvasásához. Ez a "How to - Downgrade/Remove a label that needs a justification (C++)" Rövid útmutató az előzőre épül.
- Opcionálisan: Tekintse át a Fájlkezelők fogalmait a MIP SDK-fogalmakban.
Logika hozzáadása egy alacsonyabb címke védett fájlhoz való beállításához
Adjon hozzá logikát egy fájl bizalmassági címkéjének beállításához az mip::FileHandler
objektum használatával.
Nyissa meg az előző rövid útmutatóban létrehozott Visual Studio-megoldást: Bizalmassági címkék beállítása/lekérése(C++).
A Megoldáskezelő használatával nyissa meg a metódus implementálását tartalmazó .cpp fájlt a
main()
projektben. Alapértelmezés szerint ugyanaz a név lesz, mint a projektet tartalmazó projekt, amelyet a projekt létrehozásakor adott meg.Adja hozzá a következő #include és a megfelelő meglévő irányelvek alá tartozó irányelveket a fájl tetején:
#include "mip/file/file_error.h" using mip::JustificationRequiredError; using std::cin;
Frissítse az
<label-id>
előző gyorsútmutató értékét egy bizalmassági címkére, amely indokolja a leengedést. A rövid útmutató futtatása során először ezt a címkét állítjuk be, majd a további lépésekben kódrészletekkel próbáljuk csökkenteni.A törzs vége felé, a
main()
leállítási blokk alattsystem("pause");
és felett (ahol az előző rövid útmutatóban abbahagyta), szúrja be a következő kódot:
// Downgrade label
// Set paths and lower label ID
// Set a new label on input file.
string lowerlabelId = "<lower-label-id>";
cout << "\nApplying new Label ID " << lowerlabelId << " to " << filePathOut << endl;
mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);
// Try to apply a label with lower sensitivity.
try
{
handler->SetLabel(engine->GetLabelById(lowerlabelId), labelingOptions, mip::ProtectionSettings());
}
catch (const mip::JustificationRequiredError& e)
{
// Request justification from user.
cout<<"Please provide justification for downgrading a label: "<<endl;
string justification;
cin >> justification;
// Set Justification provided flag
bool isDowngradeJustified = true;
mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);
labelingOptions.SetDowngradeJustification(isDowngradeJustified,justification);
//Set new label.
handler->SetLabel(engine->GetLabelById(lowerlabelId), labelingOptions, mip::ProtectionSettings());
}
catch (const std::exception& e)
{
cout << "An exception occurred... did you specify a valid label ID?\n\n" << e.what() << "'\n";
system("pause");
return 1;
}
// Commit changes, save as a different output file
string lowerFilePathOut = "<lower-output-file-path>";
try
{
cout << "Committing changes" << endl;
auto commitPromise = std::make_shared<std::promise<bool>>();
auto commitFuture = commitPromise->get_future();
handler->CommitAsync(lowerFilePathOut, commitPromise);
if (commitFuture.get()) {
cout << "\nLabel committed to file: " << lowerFilePathOut << endl;
}
else {
cout << "Failed to label: " + lowerFilePathOut << endl;
return 1;
}
}
catch (const std::exception& e)
{
cout << "An exception occurred... did you specify a valid commit file path?\n\n" << e.what() << "'\n";
system("pause");
return 1;
}
system("pause");
// Set up async FileHandler for output file operations
string lowerActualFilePath = "<lower-content-identifier>";
try
{
auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
auto handlerFuture = handlerPromise->get_future();
engine->CreateFileHandlerAsync(
lowerFilePathOut,
lowerActualFilePath,
true,
std::make_shared<FileHandlerObserver>(),
handlerPromise);
handler = handlerFuture.get();
}
catch (const std::exception& e)
{
cout << "An exception occurred... did you specify a valid output file path?\n\n" << e.what() << "'\n";
system("pause");
return 1;
}
// Get the lowered label from output file
try
{
cout << "\nGetting the label committed to file: " << lowerFilePathOut << endl;
auto lowerLabel = handler->GetLabel();
cout << "Name: " + lowerLabel->GetLabel()->GetName() << endl;
cout << "Id: " + lowerLabel->GetLabel()->GetId() << endl;
}
catch (const std::exception& e)
{
cout << "An exception occurred... did you specify a valid label ID?\n\n" << e.what() << "'\n";
system("pause");
return 1;
}
system("pause");
Cserélje le a helyőrző értékeket a forráskódban a következő értékekkel:
Helyőrző Value <lower-label-id> Az előző rövid útmutatóban a konzol kimenetéből másolt címkeazonosító, például: bb7ed207-046a-4caf-9826-647cff56b990
. Győződjön meg arról, hogy kisebb a bizalmassági szint, mint a korábban védett fájlcímke.<lower-output-file-path> A módosított fájlt menteni kívánt kimeneti fájl elérési útja. <lower-content-identifier> A tartalom emberi olvasásra alkalmas azonosítója.
Az alkalmazás létrehozása és tesztelése
Hozza létre és tesztelje az ügyfélalkalmazást.
Az ügyfélalkalmazás létrehozásához használja a CTRL-SHIFT-B (Build Solution) parancsot. Ha nincsenek buildelési hibái, használja az F5 (Hibakeresés indítása) lehetőséget az alkalmazás futtatásához.
Ha a projekt sikeresen épül és fut, az alkalmazás hozzáférési jogkivonatot kér minden alkalommal, amikor az SDK meghívja a metódust
AcquireOAuth2Token()
.
Non-Business : 87ba5c36-17cf-14793-bbc2-bd5b3a9f95cz
Public : 83867195-f2b8-2ac2-b0b6-6bb73cb33afz
General : f42a3342-8706-4288-bd31-ebb85995028z
Confidential : 074e457c-5848-4542-9a6f-34a182080e7z
Highly Confidential : f55c2dea-db0f-47cd-8520-a52e1590fb6z
Press any key to continue . . .
Applying Label ID f55c2dea-db0f-47cd-8520-a52e1590fb6z to c:\Test\Test.docx
Committing changes
Label committed to file: c:\Test\Test.docx
Press any key to continue . . .
Run the PowerShell script to generate an access token using the following values, then copy/paste it below:
Set $authority to: https://login.windows.net/37f4583d-9985-4e7f-a1ab-71afd8b55ba0
Set $resourceUrl to: https://aadrm.com
Sign in with user account: user1@tenant.onmicrosoft.com
Enter access token: <paste-access-token-here>
Press any key to continue . . .
Getting the label committed to file: c:\Test\Test_labeled.docx
Name: Highly Confidential
Id: f55c2dea-db0f-47cd-8520-a52e1590fb6z
Press any key to continue . . .
Applying new Label ID f42a3342-8706-4288-bd31-ebb85995028z to c:\Test\Test_labeled.docx
Please provide justification for downgrading a label:
Need for sharing with wider audience.
Committing changes
Label committed to file: c:\Test\Test_downgraded.docx
Press any key to continue . . .
Getting the label committed to file: c:\Test\Test_downgraded.docx
Name: General
Id: f42a3342-8706-4288-bd31-ebb85995028z
Press any key to continue . . .
Felhívjuk figyelmét, hogy ha a fájlból törölt címke indoklást igényel a címkeszabályzat szerint, a művelethez DeleteLabel()
hasonló megközelítést kell alkalmazni. DeleteLabel()
függvény kivételt mip::JustificationRequiredError
jelez. isDowngradeJustified
A címke sikeres törlése előtt a kivételkezelés során igaz értékre kell állítani a jelzőt.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: