Quickstart: Vertrouwelijkheidslabels vermelden (C#)

  • Artikel

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

Vereisten

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 File Engine.

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

  2. Open met Solution Explorer het .cs-bestand 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 aan het einde van de Main() hoofdtekst boven de sectie afsluiten van de toepassing van de Main() functie (waar u was gebleven in de vorige quickstart) 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

Ten slotte bouwt en test u uw clienttoepassing.

  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 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 er al referenties in de cache aanwezig zijn, wordt u niet gevraagd om u aan te melden en de lijst met labels weer te geven.

    Visual Studio acquire token sign-in

    • 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). Klik op Accepteren om uw toestemming vast te leggen.

      Visual Studio consent

  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.

Notitie

Kopieer en sla de id van een of meer van de vertrouwelijkheidslabels (bijvoorbeeld f42a3342-8706-4288-bd31-ebb85995028z) op, zoals u in de volgende quickstart gaat gebruiken.

Problemen oplossen

Problemen tijdens de uitvoering van de C#-toepassing

Samenvatting Foutbericht Oplossing
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:[35bc0023-3727-4eff-8062-000006d5d672]'

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 is gebouwd, maar de uitvoer lijkt op de linkerkant, hebt u waarschijnlijk een ongeldig of verlopen token in uw AcquireOAuth2Token() methode. Ga terug naar Build en test de toepassing en genereer het toegangstoken opnieuw, werk het opnieuw bij AcquireOAuth2Token() en herbouwen/opnieuw testen. 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 is gebouwd, maar u geen uitvoer in het consolevenster hebt, moet u ervoor zorgen dat de vertrouwelijkheidslabels van uw organisatie correct zijn geconfigureerd. Zie de installatie en configuratie van de MIP SDK onder Labeltaxonomie en beveiligingsinstellingen definiëren voor meer informatie.

Volgende stappen

Nu u hebt geleerd hoe u de vertrouwelijkheidslabels voor uw organisatie kunt weergeven, kunt u de volgende quickstart proberen:

Een vertrouwelijkheidslabel instellen en ophalen