Rövid útmutató: Bizalmassági címke beállítása és lekérése (C#)
Ez a rövid útmutató bemutatja, hogyan használhat több MIP-fájl SDK-t. Az előző rövid útmutatóban felsorolt bizalmassági címkék egyikével fájlkezelővel állíthatja be/szerezheti be a címkét egy fájlon. A Fájlkezelő osztály különböző műveleteket tesz elérhetővé címkék beállításához/lekéréséhez vagy védelemhez a támogatott fájltípusokhoz.
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#) listázása, amely egy kezdő Visual Studio-megoldást hoz létre a szervezet bizalmassági címkéinek listázásához. Ez a "Bizalmassági címke beállítása és lekérése" rövid útmutató az előzőre épül.
- Opcionálisan: Tekintse át a fájlkezelőket a MIP SDK fogalmaiban.
Logikai elem hozzáadása bizalmassági címke beállításához és lekéréséhez
Adjon hozzá logikát egy fájl bizalmassági címkéjének beállításához és lekéréséhez a Fájlmotor objektum használatával.
A Megoldáskezelő használatával nyissa meg a Main() metódus implementálását tartalmazó .cs fájlt a projektben. Alapértelmezés szerint ugyanaz a név lesz, mint a projektet tartalmazó projekt, amelyet a projekt létrehozásakor adott meg.
A szövegtörzs vége felé, a
Main()
//Application Shutdown
megjegyzés utánvar fileEngine =
és felett szúrja be a következő kódot://Set paths and label ID string inputFilePath = "<input-file-path>"; string actualFilePath = inputFilePath; string labelId = "<label-id>"; string outputFilePath = "<output-file-path>"; string actualOutputFilePath = outputFilePath; //Create a file handler for that file //Note: the 2nd inputFilePath is used to provide a human-readable content identifier for admin auditing. var handler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(inputFilePath, actualFilePath, true)).Result; //Set Labeling Options LabelingOptions labelingOptions = new LabelingOptions() { AssignmentMethod = AssignmentMethod.Standard }; // Set a label on input file handler.SetLabel(fileEngine.GetLabelById(labelId), labelingOptions, new ProtectionSettings()); // Commit changes, save as outputFilePath var result = Task.Run(async () => await handler.CommitAsync(outputFilePath)).Result; // Create a new handler to read the labeled file metadata var handlerModified = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(outputFilePath, actualOutputFilePath, true)).Result; // Get the label from output file var contentLabel = handlerModified.Label; Console.WriteLine(string.Format("Getting the label committed to file: {0}", outputFilePath)); Console.WriteLine(string.Format("File Label: {0} \r\nIsProtected: {1}", contentLabel.Label.Name, contentLabel.IsProtectionAppliedFromLabel.ToString())); Console.WriteLine("Press a key to continue."); Console.ReadKey();
Az első rövid útmutatóban létrehozott alkalmazásleállítási blokk megkeresése
Main()
és a kezelővonal kibontása után:// Application Shutdown handler = null; fileEngine = null; fileProfile = null; mipContext = null;
Cserélje le a helyőrző értékeket a forráskódban a következő értékekkel:
Helyőrző Value <bemeneti fájl elérési útja> A teszt bemeneti fájljának teljes elérési útja, például: c:\\Test\\Test.docx
.<címkeazonosító> Az előző rövid útmutatóban a konzol kimenetéből másolt bizalmassági címke azonosítója, például: f42a3342-8706-4288-bd31-ebb85995028z
.<kimeneti fájl elérési útja> A kimeneti fájl teljes elérési útja, amely a bemeneti fájl címkével ellátott másolata lesz, például: c:\\Test\\Test_labeled.docx
.
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 az ADAL-on keresztüli hitelesítést kér 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
Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a 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.
Getting the label committed to file: c:\Test\Test_labeled.docx
File Label: Confidential
IsProtected: false
Press any key to continue.
A címke alkalmazásának ellenőrzéséhez nyissa meg a kimeneti fájlt, és vizuálisan vizsgálja meg a dokumentum adatvédelmi beállításait.
Megjegyzés:
Ha Office-dokumentumot címkéz, de nem a Microsoft Entra-bérlő azon fiókjával jelentkezik be, ahol a hozzáférési jogkivonatot beszerezték (és a bizalmassági címkék konfigurálva vannak), előfordulhat, hogy a címkézett dokumentum megnyitása előtt a rendszer kérni fogja a bejelentkezést.
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: