Začínáme: Přehled štítků citlivosti (C#)

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

Požadavky

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

Přidejte logiku pro výpis štítků citlivosti

Přidejte logiku pro vypsání popisků citlivosti vaší organizace pomocí objektu souborového modulu.

  1. Otevřete řešení sady Visual Studio, které jste vytvořili v předchozím článku Rychlý start: Inicializace klientské aplikace (C#).

  2. V Průzkumník řešení otevřete soubor .cs v projektu, který obsahuje implementaci Main() metody. V rámci výchozího nastavení se použije stejný název jako projekt, který ho obsahuje a který jste zadali při vytváření projektu.

  3. Ke konci těla Main(), před část funkce Main() věnovanou ukončení aplikace (kde jste skončili v předchozím rychlém úvodu), 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

Sestavte a otestujte klientskou aplikaci.

  1. K sestavení klientské aplikace stiskněte kombinaci kláves CTRL +SHIFT-B (Build Solution). Pokud nemáte chyby sestavení, spusťte aplikaci pomocí klávesy F5 (Spustit ladění).

  2. Pokud se projekt úspěšně sestaví a spustí, aplikace může při každém volání vaší metody AcquireToken() sadou SDK zobrazit výzvu k ověření identity pomocí knihovny Identity a ověřování Microsoftu (MSAL). Pokud přihlašovací údaje uložené v mezipaměti už existují, nezobrazí se výzva k přihlášení a zobrazí se seznam popisků.

    Výzva k přihlášení pro získání tokenu v aplikaci Visual Studio.

    • Při spouštění pod přihlašovacím účtem může být také potřeba udělit souhlas, aby aplikace mohla přistupovat k rozhraním API MIP. 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). Výběrem možnosti Přijmout zaznamenáte svůj souhlas.

      Visual Studio výzva k vyjádření souhlasu.

  3. 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émů

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

Shrnutí Zpráva o chybě Ř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 s: [class mip::PolicySyncException] 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 požadavkem nelze analyzovat.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

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ě, je token ve vaší AcquireOAuth2Token() metodě pravděpodobně neplatný nebo vypršela jeho 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 se nezobrazí žá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 Definice taxonomie popisků a nastavení ochrany.

Další kroky

Teď, když víte, jak vypsat popisky citlivosti pro vaši organizaci, vyzkoušejte následující rychlý start: