Snabbstart: Lista känslighetsetiketter (C#)

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:

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.

  1. Öppna Visual Studio-lösningen som du skapade i föregående artikel "Snabbstart: Initiering av klientprogram (C#)."

  2. I Prieskumník riešení öppnar du filen .cs 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.

  3. Mot slutet av Main()-delen, före avsnittet för programavslut i funktionen Main() (där du slutade i föregående snabbstart), infoga 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 klientprogrammet.

  1. Använd CTRL-SHIFT-B (Build Solution) för att skapa klientprogrammet. Om du inte har byggfel använder du F5 (Starta felsökning) för att köra programmet.

  2. Om projektet kompileras och körs utan problem kan programmet uppmana till autentisering med Microsofts autentiseringsbibliotek (MSAL) varje gång SDK:t anropar din AcquireToken()-metod. Om cachelagrade autentiseringsuppgifter redan finns uppmanas du inte att logga in och du ser listan med etiketter.

    Visual Studio hämta tokeninloggningsprompt.

    • Du kan också behöva ge medgivande för att programmet ska få åtkomst till MIP-API:erna när 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). Välj Acceptera för att registrera ditt medgivande.

      Visual Studio fråga om medgivande.

  3. 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.

Anmärkning

Kopiera och spara ID:t för en eller flera av känslighetsetiketterna (till exempel f42a3342-8706-4288-bd31-ebb85995028z), eftersom du använder det 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?

API-anrop misslyckades: profile_add_engine_async Misslyckades med: [class mip::PolicySyncException] Det gick inte att hämta principen, begäran misslyckades med HTTP-statuskod: 401, x-ms-diagnostics: [2000001;reason="OAuth-token som skickades med begäran kan inte tolkas.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

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 kompileras utan problem men du ser utdata som liknar den till vänster är tokenen i metoden AcquireOAuth2Token() troligen ogiltig eller har upphört att gälla. Gå tillbaka till Skapa och testa programmet och återskapa åtkomsttoken, uppdatera AcquireOAuth2Token() igen och återskapa/testa igen. Du kan också undersöka och verifiera tokenen och dess påståenden med hjälp av webbapplikationen jwt.ms på en enda sida.
Känslighetsetiketter har inte konfigurerats Inte tillämpligt Om projektet har skapats, men inga utdata visas 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 vet hur du listar känslighetsetiketterna för din organisation kan du prova nästa snabbstart:

Ange och hämta en känslighetsetikett

  • Last updated on