Guida introduttiva: Elencare i modelli (C#)
Questa guida introduttiva illustra come usare MIP Protection SDK per elencare i modelli di protezione disponibili per l'utente.
Prerequisiti
Se non è già stato fatto, assicurarsi di completare i prerequisiti seguenti prima di continuare:
- Completare l'avvio rapido: Inizializzazione dell'applicazione client - Protection SDK (C#), che crea prima una soluzione di Visual Studio iniziale. Questa guida introduttiva "Elenca modelli di protezione" si basa su quella precedente per la creazione corretta della soluzione iniziale.
- Facoltativamente: esaminare i concetti relativi ai modelli RMS.
Aggiungere logica per elencare i modelli di protezione
Aggiungere la logica per elencare i modelli di protezione disponibili per un utente usando l'oggetto motore protezione.
Aprire la soluzione di Visual Studio creata nell'articolo precedente "Avvio rapido - Inizializzazione dell'applicazione client - Protection SDK (C#)".
Usando Esplora soluzioni, aprire il file con estensione cs nel progetto che contiene l'implementazione del
Main()
metodo . Per impostazione predefinita, il nome del progetto che lo contiene è stato specificato durante la creazione del progetto.Verso la fine del
Main()
corpo, sopra la sezione di arresto dell'applicazione dellaMain()
funzione (in cui è stata interrotta la guida introduttiva precedente), inserire il codice seguente:
// 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...");
Compilare e testare l'applicazione
Infine, compilare e testare l'applicazione client.
Usare CTRL-MAIUSC-B (Compila soluzione) per compilare l'applicazione client. Se non sono presenti errori di compilazione, usare F5 (Avvia debug) per eseguire l'applicazione.
Se il progetto viene compilato ed eseguito correttamente, l'applicazione potrebbe richiedere l'autenticazione tramite ADAL ogni volta che l'SDK chiama il
AcquireToken()
metodo. Se le credenziali memorizzate nella cache esistono già, non verrà richiesto di accedere e visualizzare l'elenco delle etichette.Potrebbe anche essere necessario fornire il consenso per consentire all'applicazione di accedere alle API MIP durante l'esecuzione con l'account di accesso. Ciò si verifica quando la registrazione dell'applicazione Microsoft Entra non è pre-consenso (come descritto in "Configurazione e configurazione di MIP SDK") o si accede con un account da un tenant diverso (diverso da quello in cui è registrata l'applicazione). È sufficiente fare clic su Accetta per registrare il consenso.
Dopo l'autenticazione, l'output della console dovrebbe mostrare i modelli di protezione per l'utente autenticato, simile all'esempio seguente:
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.
Nota
Copiare e salvare l'ID di uno o più modelli di protezione ( ad esempio , bb7ed207-046a-4caf-9826-647cff56b990
), come verrà usato nella guida introduttiva successiva.
Risoluzione dei problemi
Problemi durante l'esecuzione dell'applicazione C#
Riepilogo | Messaggio di errore | Soluzione |
---|---|---|
Token di accesso non valido | Si è verificata un'eccezione... il token di accesso non è corretto/scaduto? Chiamata API non riuscita: profile_add_engine_async Failed with: [class mip::P olicySyncException] Failed acquiring policy, Request failed with http status code: 401, x-ms-diagnostics: [2000001; reason="Non è possibile analizzare il token OAuth inviato con la richiesta."; error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (processo 29924) chiuso con codice 0. Premere un tasto qualsiasi per chiudere questa finestra. . . |
Se il progetto viene compilato correttamente, ma viene visualizzato un output simile a quello a sinistra, è probabile che nel metodo sia presente un token AcquireOAuth2Token() non valido o scaduto. Tornare a Compilare e testare l'applicazione e rigenerare il token di accesso, aggiornarlo AcquireOAuth2Token() di nuovo e ricompilare/ripetere l'esecuzione. È anche possibile esaminare e verificare il token e le relative attestazioni, usando l'applicazione Web a pagina singola jwt.ms . |
Passaggi successivi
Dopo aver appreso come elencare i modelli di protezione disponibili per l'utente autenticato, provare la guida introduttiva successiva: