Microsoft Information Protection SDK – File SDK – Rövid útmutató a fájl ismételt közzétételéhez (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 állítsa be/kérje le a bizalmassági címkéket (C#), 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 - Republish a protected file - 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.
Logikai elem hozzáadása védett fájlok szerkesztéséhez és újbóli közzétételéhez
Nyissa meg az előző "Rövid útmutató: Bizalmassági címkék beállítása/lekérése(C#)" cikkben létrehozott Visual Studio-megoldást.
A Megoldáskezelő használatával nyissa meg a metódus implementálását tartalmazó .cs 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 törzs vége felé, az
Main()
alkalmazásleállítási blokk alattConsole.ReadKey()
és felett (ahol az előző rövid útmutatóban abbahagyta), szúrja be a következő kódot.
string protectedFilePath = "<protected-file-path>" // Originally protected file's path from previous quickstart.
//Create a fileHandler for consumption for the Protected File.
var protectedFileHandler = Task.Run(async () =>
await fileEngine.CreateFileHandlerAsync(protectedFilePath,// inputFilePath
protectedFilePath,// actualFilePath
false, //isAuditDiscoveryEnabled
null)).Result; // fileExecutionState
// Store protection handler from file
var protectionHandler = protectedFileHandler.Protection;
//Check if the user has the 'Edit' right to the file
if (protectionHandler.AccessCheck("Edit"))
{
// Decrypt file to temp path
var tempPath = Task.Run(async () => await protectedFileHandler.GetDecryptedTemporaryFileAsync()).Result;
/*
Your own application code to edit the decrypted file belongs here.
*/
/// Follow steps below for re-protecting the edited file. ///
// Create a new file handler using the temporary file path.
var republishHandler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(tempPath, tempPath, false)).Result;
// Set protection using the ProtectionHandler from the original consumption operation.
republishHandler.SetProtection(protectionHandler);
// New file path to save the edited file
string reprotectedFilePath = "<reprotected-file-path>" // New file path for saving reprotected file.
// Write changes
var reprotectedResult = Task.Run(async () => await republishHandler.CommitAsync(reprotectedFilePath)).Result;
var protectedLabel = protectedFileHandler.Label;
Console.WriteLine(string.Format("Originally protected file: {0}", protectedFilePath));
Console.WriteLine(string.Format("File LabelID: {0} \r\nProtectionOwner: {1} \r\nIsProtected: {2}",
protectedLabel.Label.Id,
protectedFileHandler.Protection.Owner,
protectedLabel.IsProtectionAppliedFromLabel.ToString()));
var reprotectedLabel = republishHandler.Label;
Console.WriteLine(string.Format("Reprotected file: {0}", reprotectedFilePath));
Console.WriteLine(string.Format("File LabelID: {0} \r\nProtectionOwner: {1} \r\nIsProtected: {2}",
reprotectedLabel.Label.Id,
republishHandler.Protection.Owner,
reprotectedLabel.IsProtectionAppliedFromLabel.ToString()));
Console.WriteLine("Press a key to continue.");
Console.ReadKey();
}
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 = null; protectionHandler = null;
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, előfordulhat, hogy az alkalmazás a Microsoft Authentication Library (MSAL) használatával kéri a hitelesítést minden alkalommal, amikor az SDK meghívja a metódust
AcquireToken()
. Ha a gyorsítótárazott hitelesítő adatok már léteznek, a rendszer nem fogja kérni, hogy jelentkezzen be, és tekintse meg a címkék listáját, majd az alkalmazott címkére és a módosított fájlra vonatkozó információkat.
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_protected.docx
File Label: Confidential
IsProtected: True
Press a key to continue.
Originally protected file: C:\Test\Test_protected.docx
File LabelID: 569af77e-61ea-4deb-b7e6-79dc73653959
ProtectionOwner: User1@Contoso.OnMicrosoft.com
IsProtected: True
Reprotected file: C:\Test\Test_reprotected.docx
File LabelID: 569af77e-61ea-4deb-b7e6-79dc73653959
ProtectionOwner: User1@Contoso.OnMicrosoft.com
IsProtected: True
Press a key to continue.
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: