Fájl SDK – Ismételt közzététel – rövid útmutató (C++)
Áttekintés
A forgatókönyv áttekintését és használatát a MIP SDK-ban való ismételt közzétételben tekintheti meg.
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őket a MIP SDK fogalmaiban.
- Opcionálisan: Tekintse át a Védelmi kezelőket a MIP SDK fogalmaiban.
Logika hozzáadása a FileHandler Observer osztályhoz
Ahhoz, hogy egy védett fájl GetDecryptedTemporaryFileAsync()
visszafejtése az általa mip::FileHandler
közzétett módszerrel használható legyen, az aszinkron metódus visszahívásait az alábbiak szerint kell meghatározni.
Nyissa meg az előző "Rövid útmutató: Bizalmassági címkék beállítása/lekérése(C++) című rövid útmutatóban létrehozott Visual Studio-megoldást.
A Megoldáskezelő használatával nyissa meg a
filehandler_observer.h
fájlt a projektben. A FileHandler-definíció vége felé adja};
hozzá az alábbi sorokat a metódusdefinícióhoz.void OnGetDecryptedTemporaryFileSuccess(const std::string& decryptedFilePath, const std::shared_ptr<void>& context) override; void OnGetDecryptedTemporaryFileFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
A Megoldáskezelő használatával nyissa meg a
filehandler_observer.cpp
fájlt a projektben. A fájl vége felé adja hozzá az alábbi sorokat a metódusdefiníciókhoz.void FileHandlerObserver::OnGetDecryptedTemporaryFileSuccess(const std::string& decryptedFilePath, const std::shared_ptr<void>& context) { auto promise = std::static_pointer_cast<std::promise<std::string>>(context); promise->set_value(decryptedFilePath); } void FileHandlerObserver::OnGetDecryptedTemporaryFileFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) { auto promise = std::static_pointer_cast<std::promise<std::string>>(context); promise->set_exception(error); }
Logikai elem hozzáadása védett fájlok szerkesztéséhez és újbóli közzétételéhez
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.A fő() törzs vége felé, a rendszer alatt("szünet"); és a fenti visszatérési érték 0; (ahol az előző rövid útmutatóban abbahagyta), szúrja be a következő kódot:
//Originally protected file's path.
std::string protectedFilePath = "<protected-file-path>";
// Create file handler for the file
auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
auto handlerFuture = handlerPromise->get_future();
engine->CreateFileHandlerAsync(protectedFilePath,
protectedFilePath,
true,
std::make_shared<FileHandlerObserver>(),
handlerPromise);
auto protectedFileHandler = handlerFuture.get();
// retieve and store protection handler from file
auto protectionHandler = protectedFileHandler->GetProtection();
//Check if the user has the 'Edit' right to the file and if so decrypt the file.
if (protectionHandler->AccessCheck("Edit")) {
// Decrypt file to temp path using the same file handler
auto tempPromise = std::make_shared<std::promise<string>>();
auto tempFuture = tempPromise->get_future();
protectedFileHandler->GetDecryptedTemporaryFileAsync(tempPromise);
auto tempPath = tempFuture.get();
/// Write code here to perform further operations for edit ///
/// Follow steps below for re-protecting the edited file ///
// Create a new file handler using the temporary file path.
auto reprotectPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
auto reprotectFuture = reprotectPromise->get_future();
engine->CreateFileHandlerAsync(tempPath,
tempPath,
true,
std::make_shared<FileHandlerObserver>(),
reprotectPromise);
auto republishHandler = reprotectFuture.get();
// Set protection using the ProtectionHandler from the original consumption operation.
republishHandler->SetProtection(protectionHandler);
std::string reprotectedFilePath = "<protected-file-path>";
// Commit changes
auto republishPromise = std::make_shared<std::promise<bool>>();
auto republishFuture = republishPromise->get_future();
republishHandler->CommitAsync(reprotectedFilePath, republishPromise);
// Validate republishing
cout << "Protected File: " + protectedFilePath<<endl;
cout << "Protected Label ID: " + protectedFileHandler->GetLabel()->GetLabel()->GetId() << endl;
cout << "Protection Owner: " + protectedFileHandler->GetProtection()->GetOwner() << endl<<endl;
cout << "Republished File: " + reprotectedFilePath<<endl;
cout << "Republished Label ID: " + republishHandler->GetLabel()->GetLabel()->GetId() << endl;
cout << "Republished Owner: " + republishHandler->GetProtection()->GetOwner() << endl;
}
A Main() vége felé keresse meg az előző rövid útmutatóban létrehozott alkalmazásleállítási blokkot, és adja hozzá az alábbi kezelősorokat az erőforrások felszabadításához.
protectedFileHandler = nullptr; protectionHandler = nullptr;
Cserélje le a helyőrző értékeket a forráskódban a következő értékekkel:
Helyőrző Value <védett fájl elérési útja> Védett fájl az előző rövid útmutatóból. <reprotected-file-path> A módosított fájl újraközzé tenni kívánt kimeneti fájl elérési útja.
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()
. Ahogyan korábban a "Bizalmassági címke beállítása/lekérése" rövid útmutatóban is tette, futtassa a PowerShell-szkriptet a jogkivonat minden alkalommal történő beszerzéséhez a $authority és $resourceUrl megadott értékek használatával.
Sensitivity labels for your organization:
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 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 . . .
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: Confidential
Id: 074e457c-5848-4542-9a6f-34a182080e7z
Press any key to continue . . .
Protected File: C:\Test\Test_labeled.docx
Protected Label ID: 074e457c-5848-4542-9a6f-34a182080e7z
Protection Owner: user1@tenant.onmicrosoft.com
Republished File: c:\Test\Test_republished.docx
Republished Label ID: 074e457c-5848-4542-9a6f-34a182080e7z
Republished Owner: user1@tenant.onmicrosoft.com
Press any key to close this window . . .
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: