Rychlý start: Výpis popisků citlivosti (C#)

Článek
01/30/2024

V tomto rychlém startu se dozvíte, jak pomocí sady MIP File SDK vypsat popisky citlivosti nakonfigurované pro vaši organizaci.

Předpoklady

Pokud jste to ještě neudělali, nezapomeňte před pokračováním dokončit následující požadavky:

Dokončení rychlého startu: Nejprve inicializace klientské aplikace (C#), která vytvoří počáteční řešení sady Visual Studio. Tento rychlý start "List sensitivity labels" (Vypsat popisky citlivosti) spoléhá na předchozí popisky pro správné vytvoření počátečního řešení.
Volitelně: Projděte si koncepty popisků klasifikace.

Přidání logiky pro výpis popisků citlivosti

Přidejte logiku pro výpis popisků citlivosti vaší organizace pomocí objektu File engine.

Otevřete řešení sady Visual Studio, které jste vytvořili v předchozím článku Rychlý start: Inicializace klientské aplikace (C#).
Pomocí Průzkumník řešení otevřete soubor .cs v projektu, který obsahuje implementaci Main() metody. Ve výchozím nastavení se použije stejný název jako projekt, který obsahuje, který jste zadali při vytváření projektu.
Na konec Main() těla nad část Main() vypnutí aplikace funkce (kde jste skončili v předchozím rychlém startu) vložte následující kód:

// 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));
        }
    }
}

Sestavení a otestování aplikace

Nakonec sestavte a otestujte klientskou aplikaci.

K sestavení klientské aplikace použijte kombinaci kláves CTRL-SHIFT-B (řešení sestavení). Pokud nemáte žádné chyby sestavení, spusťte aplikaci pomocí klávesy F5 (spustit ladění).
Pokud se projekt sestaví a úspěšně spustí, může aplikace při každém volání vaší AcquireToken() metody vyzvat k ověření pomocí knihovny Microsoft Authentication Library (MSAL). Pokud přihlašovací údaje uložené v mezipaměti už existují, nezobrazí se výzva k přihlášení a zobrazení seznamu popisků.
- Možná budete muset udělit souhlas, abyste aplikaci umožnili přístup k rozhraním API MIP při spuštění pod přihlašovacím účtem. K tomu dochází v případě, že registrace aplikace Microsoft Entra není předem odsouhlasována (jak je uvedeno v nastavení a konfiguraci sady MIP SDK), nebo se přihlašujete pomocí účtu z jiného tenanta (jiného než registrace vaší aplikace). Jednoduše klikněte na Přijmout a poznamenejte si svůj souhlas.
Po ověření by výstup konzoly měl zobrazovat popisky citlivosti, podobně jako v následujícím příkladu:

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.

Poznámka:

Zkopírujte a uložte ID jednoho nebo více popisků citlivosti (například f42a3342-8706-4288-bd31-ebb85995028z), protože ho použijete v dalším rychlém startu.

Řešení problému

Problémy při provádění aplikace jazyka C#

Shrnutí	Chybová zpráva	Řešení
Chybný přístupový token	Došlo k výjimce... je přístupový token nesprávný nebo vypršela jeho platnost? Neúspěšné volání rozhraní API: profile_add_engine_async Selhalo: [class mip::P olicySyncException] Nepodařilo se získat zásadu, požadavek selhal se stavovým kódem HTTP: 401, x-ms-diagnostics: [2000001; reason="Token OAuth odeslaný s žádostí nelze analyzovat." error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proces 29924) se ukončil s kódem 0. Stisknutím libovolné klávesy zavřete toto okno . . .	Pokud se projekt úspěšně sestaví, ale zobrazí se výstup podobný levé straně, pravděpodobně máte ve své `AcquireOAuth2Token()` metodě neplatný token nebo token s vypršenou platností. Vraťte se k sestavení a otestování aplikace a znovu vygenerujte přístupový token, aktualizujte `AcquireOAuth2Token()` znovu a znovu sestavte nebo znovu otestujte. Token a jeho deklarace identity můžete také prozkoumat a ověřit pomocí jwt.ms jednostrákové webové aplikace.
Popisky citlivosti nejsou nakonfigurované.	Není k dispozici	Pokud se projekt úspěšně sestaví, ale v okně konzoly nemáte žádný výstup, ujistěte se, že jsou popisky citlivosti vaší organizace správně nakonfigurované. Podrobnosti najdete v tématu Nastavení a konfigurace sady MIP SDK v části Definovat taxonomii popisků a nastavení ochrany.

Další kroky

Teď, když jste se dozvěděli, jak vypsat popisky citlivosti pro vaši organizaci, vyzkoušejte další rychlý start:

Nastavení a získání popisku citlivosti

Sdílet prostřednictvím