Quickstart: Lijstsjablonen (C#)

In deze quickstart ziet u hoe u de MIP Protection SDK gebruikt om de beveiligingssjablonen weer te geven die beschikbaar zijn voor de gebruiker.

Vereiste voorwaarden

Voltooi de volgende vereisten voordat u doorgaat:

Logica toevoegen om de beveiligingssjablonen weer te geven

Voeg logica toe om beveiligingssjablonen weer te geven die beschikbaar zijn voor een gebruiker met behulp van het object Protection Engine.

  1. Open de Visual Studio-oplossing die u in het vorige artikel 'Quickstart - Initialisatie van de clienttoepassing - Protection SDK (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(), boven het gedeelte waarin de toepassing wordt afgesloten in de functie Main() (waar u in de vorige quickstart bent gestopt), de volgende code in:

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

De toepassing bouwen en testen

Bouw en test uw cliëntapplicatie.

  1. Gebruik Ctrl+Shift+B (build solution) om uw clienttoepassing te bouwen. Als de build geen fouten bevat, 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 MSAL. Als er al aanmeldingsgegevens in de cache aanwezig zijn, wordt u niet gevraagd om u aan te melden en ziet u de lijst met labels.

    Aanmelden bij Visual Studio om een token te verkrijgen.

    • 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 toestemming.

  3. Na verificatie moet de console-uitvoer de beveiligingssjablonen voor de geverifieerde gebruiker weergeven, vergelijkbaar met het volgende voorbeeld:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Opmerking

Kopieer en sla de id van een of meer van de beveiligingssjablonen (bijvoorbeeld bb7ed207-046a-4caf-9826-647cff56b990) op terwijl u deze in de volgende quickstart gebruikt.

Probleemoplossingsproces

Problemen tijdens de uitvoering van de C#-toepassing

Samenvatting Foutmelding Solution
Ongeldig toegangstoken Er is een uitzondering opgetreden... Is het toegangstoken onjuist/verlopen?

Mislukte API-aanroep: profile_add_engine_async Mislukt met: [klasse mip::PolicySyncException] Verkrijgen van beleid mislukt, verzoek is mislukt met http-statuscode: 401, x-ms-diagnostics: [2000001; reason="OAuth-token ingediend met het verzoek kan niet worden geparseerd."; 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 succesvol wordt gebouwd, maar de uitvoer lijkt op die aan de linkerkant, heeft u waarschijnlijk een token dat ongeldig of verlopen is in uw AcquireOAuth2Token() methode. 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.

Volgende stappen 

Nu u hebt geleerd hoe u de beveiligingssjablonen kunt weergeven die beschikbaar zijn voor een geverifieerde gebruiker, kunt u de volgende quickstart proberen: