Snabbstart: Lista mallar (C#)

Artikel
01/30/2024

Den här snabbstarten visar hur du använder MIP Protection SDK för att lista de skyddsmallar som är tillgängliga för användaren.

Förutsättningar

Om du inte redan har gjort det måste du slutföra följande krav innan du fortsätter:

Slutför snabbstart: Initiering av klientprogram – Protection SDK (C#) först, som skapar en Visual Studio-startlösning. Den här snabbstarten "Listskyddsmallar" förlitar sig på den föregående för att startlösningen ska kunna skapas korrekt.
Alternativt: Granska begreppen för RMS-mallar .

Lägg till logik för att lista skyddsmallarna

Lägg till logik för att lista skyddsmallar som är tillgängliga för en användare med hjälp av objektet Skyddsmotor.

Öppna Visual Studio-lösningen som du skapade i föregående artikel "Snabbstart – Initiering av klientprogram – Skydd SDK (C#)."
Använd Solution Explorer och öppna .cs-filen 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.
Mot slutet av brödtexten Main() , ovanför avsnittet programavstängning av Main() funktionen (där du slutade i föregående snabbstart), infogar du följande kod:

// 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...");

Skapa och testa programmet

Skapa och testa slutligen klientprogrammet.

Använd CTRL-SHIFT-B (Build Solution) för att skapa klientprogrammet. Om du inte har några byggfel använder du F5 (Starta felsökning) för att köra programmet.
Om projektet byggs och körs korrekt kan programmet fråga efter autentisering via ADAL varje gång SDK anropar din AcquireToken() metod. Om cachelagrade autentiseringsuppgifter redan finns uppmanas du inte att logga in och se listan med etiketter.
- Du kan också behöva ge medgivande för att programmet ska få åtkomst till MIP-API:erna medan 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). Klicka bara på Acceptera för att registrera ditt medgivande.
Efter autentiseringen bör konsolens utdata visa skyddsmallarna för den autentiserade användaren, ungefär som i följande exempel:

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.

Kommentar

Kopiera och spara ID:t för en eller flera av skyddsmallarna (till exempel bb7ed207-046a-4caf-9826-647cff56b990), som du kommer att använda 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? Misslyckat API-anrop: profile_add_engine_async Misslyckades med: [class mip::P olicySyncException] Det gick inte att hämta principen, Begäran misslyckades med http-statuskoden: 401, x-ms-diagnostics: [2000001; reason="OAuth-token som skickas med begäran kan inte parsas."; error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' 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 har skapats, men du ser utdata som liknar det vänstra, har du förmodligen en ogiltig eller förfallen token i din `AcquireOAuth2Token()` metod. Gå tillbaka till Skapa och testa programmet och återskapa åtkomsttoken, uppdatera `AcquireOAuth2Token()` igen och återskapa/testa igen. Du kan också undersöka och verifiera token och dess anspråk med hjälp av jwt.ms ensideswebbapp.

Nästa steg

Nu när du har lärt dig hur du listar de skyddsmallar som är tillgängliga för autentiserade användare kan du prova nästa snabbstart:

Snabbstart – Kryptera och dekryptera text

Dela via