Guida introduttiva: Elencare le etichette di riservatezza (C#)Quickstart: List sensitivity labels (C#)

Questo Avvio rapido illustra come usare l'API File del SDK di MIP per elencare le etichette di riservatezza configurate per l'organizzazione.This Quickstart shows you how to use the MIP SDK File API to list the sensitivity labels configured for your organization.

PrerequisitiPrerequisites

Se non è già stato fatto, completare i prerequisiti seguenti prima di continuare:If you haven't already, be sure to complete the following prerequisites before continuing:

Aggiungere la logica per elencare le etichette di riservatezzaAdd logic to list the sensitivity labels

Aggiungere la logica per elencare le etichette di riservatezza dell'organizzazione, usando l'oggetto motore dell'API File.Add logic to list your organization's sensitivity labels, using the File engine object.

  1. Aprire la soluzione Visual Studio creata nell'articolo precedente "Avvio rapido: Inizializzazione dell'applicazione client (C#)".Open the Visual Studio solution you created in the previous "Quickstart: Client application initialization (C#)" article.

  2. Usare Esplora soluzioni per aprire il file con estensione cs nel progetto che contiene l'implementazione del metodo Main().Using Solution Explorer, open the .cs file in your project that contains the implementation of the Main() method. Per impostazione predefinita il file ha lo stesso nome del progetto che lo contiene, specificato durante la creazione del progetto.It defaults to the same name as the project containing it, which you specified during project creation.

  3. Verso la fine del corpo Main(), sopra la sezione dell'arresto dell'applicazione della funzione Main() (nel punto in cui è stata interrotta la procedura di Avvio rapido precedente), inserire il codice seguente:Toward the end of the Main() body, above the application shutdown section of the Main() function (where you left off in the previous Quickstart), insert the following code:

// 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'applicazioneBuild and test the application

Infine, compilare e testare l'applicazione client.Finally, build and test your client application.

  1. Usare CTRL+MAIUSC+B (Compila soluzione) per compilare l'applicazione client.Use CTRL-SHIFT-B (Build Solution) to build your client application. Se non si registrano errori di compilazione, premere F5 (Avvia debug) per eseguire l'applicazione.If you have no build errors, use F5 (Start debugging) to run your application.

  2. Se il progetto viene compilato ed eseguito correttamente, l'applicazione potrebbe richiedere l'autenticazione tramite ADAL ogni volta che il SDK chiama il metodo AcquireToken().If your project builds and runs successfully, the application may prompt for authentication via ADAL each time the SDK calls your AcquireToken() method. Se esistono già credenziali memorizzate, nella cache non verrà richiesto di eseguire l'accesso e visualizzare l'elenco delle etichette.If cached credentials already exist, you won't be prompted to sign in and see the list of labels.

    Accesso per l'acquisizione del token in Visual StudioVisual Studio acquire token sign-in

    • Potrebbe anche essere necessario dare il consenso, per permettere all'applicazione di accedere alle API MIP mentre viene eseguita con l'account di accesso.You may also need to give consent, to allow the application to access the MIP APIs, while running under the sign-in account. Ciò si verifica quando non è già stato dato il consenso per la registrazione dell'applicazione in Azure AD (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.This happens when the Azure AD application registration isn't pre-consented (as outlined in "MIP SDK setup and configuration"), or you're signing in with an account from a different tenant (other than the one where your application is registered). È sufficiente fare clic su Accetta per registrare il consenso.Simply click Accept to record your consent.

      Consenso in Visual StudioVisual Studio consent

  3. Dopo l'autenticazione l'output della console visualizza le etichette di riservatezza, in modo simile all'esempio seguente:After authentication, your console output should show the sensitivity labels, similar to the following example:

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.

Nota

Copiare e salvare l'ID di una o più delle etichette di riservatezza (ad esempio, f42a3342-8706-4288-bd31-ebb85995028z), perché verranno usati nella guida introduttiva successiva.Copy and save the ID of one or more of the sensitivity labels (for example, f42a3342-8706-4288-bd31-ebb85995028z), as you will use it in the next Quickstart.

Risoluzione dei problemiTroubleshooting

Problemi durante l'esecuzione dell'applicazione C#Problems during execution of C# application

RiepilogoSummary Messaggio di erroreError message SoluzioneSolution
Token di accesso non validoBad access token An exception occurred... is the access token incorrect/expired?

Failed API call: profile_add_engine_async Failed with: [class mip::PolicySyncException] Failed acquiring policy, Request failed with http status code: 401, x-ms-diagnostics: [2000001;reason="OAuth token submitted with the request cannot be parsed.";error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (process 29924) exited with code 0.

Press any key to close this window . . .
An exception occurred... is the access token incorrect/expired?

Failed API call: profile_add_engine_async Failed with: [class mip::PolicySyncException] Failed acquiring policy, Request failed with http status code: 401, x-ms-diagnostics: [2000001;reason="OAuth token submitted with the request cannot be parsed.";error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (process 29924) exited with code 0.

Press any key to close this window . . .
Se il progetto viene compilato correttamente, ma viene visualizzato un output simile a quello riportato a sinistra, è probabile che il token nel metodo AcquireOAuth2Token() sia non valido o scaduto.If your project builds successfully, but you see output similar to the left, you likely have an invalid or expired token in your AcquireOAuth2Token() method. Tornare a Compilare e testare l'applicazione e rigenerare il token di accesso, aggiornare di nuovo AcquireOAuth2Token(), quindi ripetere compilazione e test.Go back to Build and test the application and regenerate the access token, update AcquireOAuth2Token() again, and rebuild/retest. È anche possibile esaminare e verificare il token e le relative attestazioni usando l'applicazione Web a pagina singola jwt.ms.You can also examine and verify the token and its claims, using the jwt.ms single-page web application.
Le etichette di riservatezza non sono configurateSensitivity labels aren't configured n/dn/a Se il progetto viene compilato correttamente, ma non è presente alcun output nella finestra della console, verificare che le etichette di riservatezza dell'organizzazione siano configurate correttamente.If your project builds successfully, but you have no output in the console window, be sure your organization's sensitivity labels are configured correctly. Vedere Installazione e configurazione di MIP SDK per informazioni dettagliate sulle impostazioni per la protezione e la tassonomia delle etichette.See MIP SDK setup and configuration, under "Define label taxonomy and protection settings" for details.

Passaggi successiviNext Steps

Ora che si è appreso come elencare le etichette di riservatezza per l'organizzazione, provare la guida introduttiva successiva:Now that you've learned how to list the sensitivity labels for your organization, try the next quickstart: