Rövid útmutató: Bizalmassági címkék listázása (C#)

Cikk
01/30/2024

Ez a rövid útmutató bemutatja, hogyan használhatja a MIP-fájl SDK-t a szervezet számára konfigurált bizalmassági címkék listázására.

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:

Rövid útmutató: Elsőként az ügyfélalkalmazás inicializálása (C#), amely egy kezdő Visual Studio-megoldást hoz létre. Ez a "Bizalmassági címkék listázása" rövid útmutató az előzőre támaszkodik a kiindulási megoldás megfelelő létrehozásához.
Opcionálisan: A besorolási címkék fogalmainak áttekintése.

Logika hozzáadása a bizalmassági címkék listázásához

Adjon hozzá logikát a szervezet bizalmassági címkéinek listázásához a Fájlmotor objektum használatával.

Nyissa meg az előző "Rövid útmutató: Ügyfélalkalmazás inicializálása (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é, a Main() függvény alkalmazásleállítási szakasza Main() fölött (ahol az előző rövid útmutatóban abbahagyta), szúrja be a következő kódot:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Az alkalmazás létrehozása és tesztelése

Végül készítse el é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ódustAcquireToken(). 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.
- Előfordulhat, hogy hozzájárulást is kell adnia ahhoz, hogy az alkalmazás hozzáférhessen a MIP API-khoz, miközben a bejelentkezési fiók alatt fut. Ez akkor fordul elő, ha a Microsoft Entra alkalmazásregisztrációja nincs előzetesen jóváhagyva (a "MIP SDK beállítása és konfigurálása" című szakaszban leírtak szerint), vagy ha egy másik bérlőtől származó fiókkal jelentkezik be (nem azt, ahol az alkalmazást regisztrálták). Egyszerűen kattintson az Elfogadás gombra a hozzájárulás rögzítéséhez.
A hitelesítés után a konzol kimenetének az alábbi példához hasonlóan meg kell jelennie a bizalmassági címkéknek:

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.

Megjegyzés:

Másolja és mentse egy vagy több bizalmassági címke (például) azonosítóját, f42a3342-8706-4288-bd31-ebb85995028zahogy a következő rövid útmutatóban is használni fogja.

Hibaelhárítás

Problémák a C#-alkalmazás végrehajtása során

Summary	Hibaüzenet	Megoldás
Hibás hozzáférési jogkivonat	Kivétel történt... Helytelen/lejárt a hozzáférési jogkivonat? Sikertelen API-hívás: profile_add_engine_async Sikertelen: [class mip::P olicySyncException] Nem sikerült beolvasni a szabályzatot, a kérés http-állapotkóddal meghiúsult: 401, x-ms-diagnostics: [2000001; reason="A kéréssel elküldött OAuth-jogkivonat nem elemezhető."; error_category="invalid_token"], korrelációs azonosító:[35bc0023-3727-4eff-8062-000006d5d672]" A C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (29924-es folyamat) 0-s kóddal kilépett. Az ablak bezárásához nyomja le bármelyik billentyűt. . .	Ha a projekt sikeresen buildel, de a bal oldalihoz hasonló kimenet jelenik meg, valószínűleg érvénytelen vagy lejárt jogkivonattal rendelkezik a `AcquireOAuth2Token()` metódusban. Térjen vissza az alkalmazás buildeléséhez és teszteléséhez, majd a hozzáférési jogkivonat újragenerálásához, a frissítéshez `AcquireOAuth2Token()` és az újraépítéshez/újrateszteléshez. A jogkivonatot és a jogcímeket az jwt.ms egyoldalas webalkalmazással is megvizsgálhatja és ellenőrizheti.
A bizalmassági címkék nincsenek konfigurálva	n.a.	Ha a projekt sikeresen buildel, de nincs kimenete a konzolablakban, győződjön meg arról, hogy a szervezet bizalmassági címkéi megfelelően vannak konfigurálva. A részletekért tekintse meg a MIP SDK beállítását és konfigurációját a "Címke osztályozási és védelmi beállításainak definiálása" területen.

Következő lépések

Most, hogy megtanulta, hogyan listázhatja a szervezet bizalmassági címkéit, próbálkozzon a következő rövid útmutatóval:

Bizalmassági címke beállítása és lekérése