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

Prima di continuare, completare i prerequisiti seguenti:

• Completare l'avvio rapido: Inizializzazione dell'applicazione client - Protection SDK (C#), che crea prima una soluzione di Visual Studio iniziale. Questa guida introduttiva "Elencare i modelli di protezione" si basa sulla guida introduttiva precedente per creare correttamente la soluzione di base.
• Facoltativo: 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.

1. Aprire la soluzione di Visual Studio creata nell'articolo precedente "Avvio rapido - Inizializzazione dell'applicazione client - Protection SDK (C#)".

2. In Esplora soluzioni aprire il file .cs nel progetto che contiene l'implementazione del Main() metodo . Per impostazione predefinita, assume lo stesso nome del progetto che lo contiene, specificato durante la creazione del progetto.

3. Verso la fine del corpo di Main(), sopra la sezione di chiusura dell'applicazione della funzione Main() (nel punto in cui si era interrotto l'avvio rapido 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

Compilare e testare l'applicazione client.

1. Usare CTRL+MAIUSC+B (Compila soluzione) per compilare l'applicazione client. Se la compilazione non presenta errori, usare F5 (Avvia debug) per eseguire l'applicazione.

2. Se il progetto viene compilato ed eseguito correttamente, l'applicazione potrebbe richiedere l'autenticazione usando MSAL ogni volta che l'SDK chiama il AcquireToken() metodo. Se esistono già credenziali memorizzate nella cache, non viene 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 ha il consenso preliminare (come descritto in "Installazione e configurazione di MIP SDK") o si accede con un account da un tenant diverso da quello in cui è registrata l'applicazione. Selezionare Accetta per registrare il consenso.

     

3. 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.

Risoluzione dei problemi

Problemi durante l'esecuzione dell'applicazione C#

Passaggi successivi

Dopo aver appreso come elencare i modelli di protezione disponibili per un utente autenticato, provare la guida introduttiva successiva:

• Esplora l'esempio .NET di MIP Protection SDK su GitHub.