Guida introduttiva: Elencare le etichette di riservatezza (C#)

2025-04-11

Questa guida introduttiva illustra come usare MIP File SDK per elencare le etichette di riservatezza configurate per l'organizzazione.

Prerequisiti

Se non è già stato fatto, assicurarsi di completare i prerequisiti seguenti prima di continuare:

Prima di tutto, completare Avvio rapido: Inizializzazione dell'applicazione client (C#), che crea una soluzione iniziale di Visual Studio. Questa guida introduttiva "Elenca le etichette di riservatezza" si basa su quella precedente per la creazione corretta della soluzione iniziale.
Facoltativamente: esaminare i concetti relativi alle etichette di classificazione .

Aggiungere la logica per elencare le etichette di riservatezza

Aggiungere la logica per elencare le etichette di riservatezza dell'organizzazione utilizzando l'oggetto di gestione file.

Aprire la soluzione di Visual Studio creata nell'articolo precedente "Avvio rapido: Inizializzazione dell'applicazione client (C#)".
Usando Esplora soluzioni aprire il file .cs nel progetto che contiene l'implementazione del Main() metodo . Per impostazione predefinita, viene utilizzato lo stesso nome del progetto che lo contiene, specificato durante la creazione del progetto.
Vicino alla fine del Main() corpo, sopra la sezione di arresto dell'applicazione della Main() funzione (dove si era interrotto nel Quickstart precedente), inserire il codice seguente:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Compilare e testare l'applicazione

Infine, compilare e testare l'applicazione client.

Usare CTRL-SHIFT-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 usando Microsoft Authentication Library (MSAL) 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-consentita (come descritto in "installazione e configurazione di MIP SDK") o si accede con un account appartenente a un tenant 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 le etichette di sensibilità, come nell'esempio seguente:

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

Annotazioni

Copia e salva l'ID di una o più etichette di riservatezza, ad esempio f42a3342-8706-4288-bd31-ebb85995028z, poiché verrà utilizzato nella prossima guida introduttiva.

Risoluzione dei problemi

Problemi durante l'esecuzione dell'applicazione C#

Sommario	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 non riuscito con: [classe mip::PolicySyncException] Non riuscito acquisire la politica, richiesta non riuscita con codice di stato http: 401, x-ms-diagnostics: [2000001; motivo="Non è possibile analizzare il token OAuth inviato con la richiesta."; categoria_errore="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 .
Le etichette di riservatezza non sono configurate	non disponibile	Se il progetto viene compilato correttamente, ma non appare alcun output nella finestra della console, verifica che le etichette di sensibilità della tua organizzazione siano configurate correttamente. Per informazioni dettagliate, vedere Configurazione e configurazione di MIP SDK in "Definire le impostazioni di tassonomia e protezione delle etichette".

Passaggi successivi

Dopo aver appreso come elencare le etichette di riservatezza per l'organizzazione, prova la prossima guida rapida:

Impostare e ottenere un'etichetta di riservatezza

Condividi tramite