Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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:
- 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“ (Vypsání popisků citlivosti) navazuje na předchozí rychlý start, ve kterém se vytvoří výchozí řešení.
- Volitelně: Přezkoumejte koncepty štítků klasifikace.
Přidejte logiku pro výpis štítků citlivosti
Přidejte logiku pro vypsání popisků citlivosti vaší organizace pomocí objektu souborového modulu.
Otevřete řešení sady Visual Studio, které jste vytvořili v předchozím článku Rychlý start: Inicializace klientské aplikace (C#).
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.Ke konci těla
Main(), před část funkceMain()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.
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í).
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ů.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.
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:
- Prozkoumejte ukázku sady MIP File SDK .NET na GitHub.