Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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:
- Voltooi de Snelstart: Initialisatie van de clienttoepassing - Protectie-SDK (C#) eerst, waarmee een eenvoudige Visual Studio-oplossing wordt gebouwd. Deze quickstart 'Sjablonen voor lijstbeveiliging' is afhankelijk van de vorige quickstart om de startersoplossing correct te maken.
- Optioneel: Bekijk concepten van RMS-sjablonen .
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.
Open de Visual Studio-oplossing die u in het vorige artikel 'Quickstart - Initialisatie van de clienttoepassing - Protection SDK (C#)' hebt gemaakt.
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.Voeg tegen het einde van de hoofdtekst van
Main(), boven het gedeelte waarin de toepassing wordt afgesloten in de functieMain()(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.
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.
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.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.
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:
- Verken de MIP Protection SDK .NET voorbeeld op GitHub.