Quickstart: Vertrouwelijkheidslabels opsommen (C#)

In deze quickstart ziet u hoe u de MIP File SDK gebruikt om de vertrouwelijkheidslabels weer te geven die zijn geconfigureerd voor uw organisatie.

Vereiste voorwaarden

Als u dat nog niet hebt gedaan, moet u de volgende vereisten voltooien voordat u doorgaat:

Logica toevoegen om de vertrouwelijkheidslabels weer te geven

Voeg logica toe om de vertrouwelijkheidslabels van uw organisatie weer te geven met behulp van het object bestandsengine.

  1. Open de Visual Studio-oplossing die u in het vorige artikel 'Quickstart: Initialisatie van clienttoepassingen (C#)' hebt gemaakt.

  2. Open in Solution Explorer het bestand .cs in uw project dat de implementatie van de Main() methode bevat. Deze wordt standaard ingesteld op dezelfde naam als het project dat het bevat, die u hebt opgegeven tijdens het maken van het project.

  3. Voeg tegen het einde van de hoofdtekst van Main(), vóór de sectie voor het afsluiten van de toepassing in de functie Main() (waar u in de vorige quickstart bent gestopt), de volgende code in:

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

De toepassing bouwen en testen

Bouw en test uw cliëntapplicatie.

  1. Gebruik Ctrl-SHIFT-B (build solution) om uw clienttoepassing te bouwen. Als u geen buildfouten hebt, gebruikt u F5 (Foutopsporing starten) om uw toepassing uit te voeren.

  2. Als uw project succesvol wordt gebouwd en uitgevoerd, kan de toepassing telkens wanneer de SDK uw AcquireToken()-methode aanroept, om verificatie vragen met behulp van Microsoft Authentication Library (MSAL). Als de aanmeldingsgegevens al in de cache staan, hoeft u zich niet aan te melden en ziet u de lijst met labels.

    Visual Studio-aanmeldingsprompt voor het verkrijgen van een token.

    • Mogelijk moet u ook toestemming geven om de toepassing toegang te geven tot de MIP-API's terwijl deze wordt uitgevoerd onder het aanmeldingsaccount. Dit gebeurt wanneer de registratie van de Microsoft Entra-toepassing niet vooraf is toegestaan (zoals wordt beschreven in 'MIP SDK-installatie en -configuratie'), of als u zich aanmeldt met een account van een andere tenant (anders dan het account waarin uw toepassing is geregistreerd). Selecteer Accepteren om uw toestemming vast te leggen.

      Visual Studio toestemmingsprompt.

  3. Na verificatie moet de console-uitvoer de vertrouwelijkheidslabels weergeven, vergelijkbaar met het volgende voorbeeld:

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.

Opmerking

Kopieer en sla de id van een of meer vertrouwelijkheidslabels (bijvoorbeeld f42a3342-8706-4288-bd31-ebb85995028z) op omdat u deze in de volgende quickstart gebruikt.

Probleemoplossingsproces

Problemen tijdens de uitvoering van de C#-toepassing

Samenvatting Foutmelding " needed as the existing translation is correct.
Ongeldig toegangstoken Er is een uitzondering opgetreden... Is het toegangstoken onjuist/verlopen?

Mislukte API-aanroep: profile_add_engine_async Mislukt met: [klasse mip::P olicySyncException] Kan beleid niet ophalen, aanvraag is mislukt met http-statuscode: 401, x-ms-diagnostics: [2000001; reason="OAuth token submitted with the request cannot be parsed."; error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proces 29924) afgesloten met code 0.

Druk op een willekeurige toets om dit venster te sluiten. . .		 Als uw project succesvol wordt gebouwd, maar u uitvoer ziet die vergelijkbaar is met wat links wordt weergegeven, is het token in uw AcquireOAuth2Token()-methode waarschijnlijk ongeldig of verlopen. Ga terug naar Build en test de toepassing, genereer het toegangstoken opnieuw, werk AcquireOAuth2Token() opnieuw bij en herbouw/test opnieuw. U kunt het token en de bijbehorende claims ook onderzoeken en controleren met behulp van de jwt.ms webtoepassing met één pagina.
Vertrouwelijkheidslabels zijn niet geconfigureerd n.v.t. Als uw project succesvol wordt gebouwd, maar er geen uitvoer verschijnt in het consolevenster, controleer dan of de vertrouwelijkheidslabels van uw organisatie correct zijn geconfigureerd. Zie miP SDK-installatie en -configuratie onder Labeltaxonomie en beveiligingsinstellingen definiëren voor meer informatie.

Volgende stappen 

Nu u weet hoe u de vertrouwelijkheidslabels voor uw organisatie kunt vermelden, kunt u de volgende quickstart proberen:

Een vertrouwelijkheidslabel instellen en ophalen

  • Last updated on