Snabbstart: Lista känslighetsetiketter (C#)

Artikel
01/30/2024

Den här snabbstarten visar hur du använder MIP File SDK för att lista de känslighetsetiketter som konfigurerats för din organisation.

Förutsättningar

Om du inte redan har gjort det måste du slutföra följande krav innan du fortsätter:

Slutför snabbstart: Initiering av klientprogram (C#) först, som skapar en Visual Studio-startlösning. Den här snabbstarten "Lista känslighetsetiketter" förlitar sig på den föregående för att startlösningen ska kunna skapas korrekt.
Valfritt: Granska begrepp för klassificeringsetiketter .

Lägg till logik för att lista känslighetsetiketterna

Lägg till logik för att lista organisationens känslighetsetiketter med hjälp av filmotorobjektet.

Öppna Visual Studio-lösningen som du skapade i föregående artikel "Snabbstart: Initiering av klientprogram (C#)."
Använd Solution Explorer och öppna .cs-filen i projektet som innehåller implementeringen av Main() metoden. Det är som standard samma namn som det projekt som innehåller det, som du angav när projektet skapades.
Mot slutet av brödtexten Main() , ovanför avsnittet programavstängning av Main() funktionen (där du slutade i föregående snabbstart), infogar du följande kod:

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

Skapa och testa programmet

Skapa och testa slutligen klientprogrammet.

Använd CTRL-SHIFT-B (Build Solution) för att skapa klientprogrammet. Om du inte har några byggfel använder du F5 (Starta felsökning) för att köra programmet.
Om projektet byggs och körs korrekt kan programmet fråga efter autentisering med hjälp av Microsoft Authentication Library (MSAL) varje gång SDK:t anropar din AcquireToken() metod. Om cachelagrade autentiseringsuppgifter redan finns uppmanas du inte att logga in och se listan med etiketter.
- Du kan också behöva ge medgivande för att programmet ska få åtkomst till MIP-API:erna medan det körs under inloggningskontot. Detta inträffar när Microsoft Entra-programregistreringen inte har godkänts i förväg (enligt beskrivningen i "MIP SDK-konfiguration" eller om du loggar in med ett konto från en annan klientorganisation (förutom den där ditt program är registrerat). Klicka bara på Acceptera för att registrera ditt medgivande.
Efter autentiseringen bör konsolens utdata visa känslighetsetiketterna, ungefär som i följande exempel:

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.

Kommentar

Kopiera och spara ID:t för en eller flera av känslighetsetiketterna (till exempel f42a3342-8706-4288-bd31-ebb85995028z), som du kommer att använda i nästa snabbstart.

Felsökning

Problem vid körning av C#-program

Sammanfattning	Felmeddelande	Lösning
Felaktig åtkomsttoken	Ett undantag inträffade... är åtkomsttoken felaktig/har upphört att gälla? Misslyckat API-anrop: profile_add_engine_async Misslyckades med: [class mip::P olicySyncException] Det gick inte att hämta principen, Begäran misslyckades med http-statuskoden: 401, x-ms-diagnostics: [2000001; reason="OAuth-token som skickas med begäran kan inte parsas."; error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (process 29924) avslutades med kod 0. Tryck på valfri tangent för att stänga det här fönstret . . .	Om projektet har skapats, men du ser utdata som liknar det vänstra, har du förmodligen en ogiltig eller förfallen token i din `AcquireOAuth2Token()` metod. Gå tillbaka till Skapa och testa programmet och återskapa åtkomsttoken, uppdatera `AcquireOAuth2Token()` igen och återskapa/testa igen. Du kan också undersöka och verifiera token och dess anspråk med hjälp av jwt.ms ensideswebbapp.
Känslighetsetiketter har inte konfigurerats	saknas	Om projektet har skapats, men du inte har några utdata i konsolfönstret, kontrollerar du att organisationens känslighetsetiketter är korrekt konfigurerade. Mer information finns i Konfiguration och konfiguration av MIP SDK under "Definiera etiketttaxonomi och skyddsinställningar".

Nästa steg

Nu när du har lärt dig hur du listar känslighetsetiketterna för din organisation kan du prova nästa snabbstart:

Ange och hämta en känslighetsetikett