Guia de início rápido: listar rótulos de sensibilidade (C#)

Artigo
01/30/2024

Este Guia de início rápido mostra como usar o MIP File SDK para listar os rótulos de sensibilidade configurados para sua organização.

Pré-requisitos

Se ainda não o fez, certifique-se de que preenche os seguintes pré-requisitos antes de continuar:

Guia de início rápido completo : inicialização de aplicativo cliente (C#) primeiro, que cria uma solução inicial do Visual Studio. Este Guia de início rápido "Listar rótulos de sensibilidade" baseia-se no anterior, para a criação adequada da solução inicial.
Opcionalmente: Revise os conceitos de rótulos de classificação.

Adicionar lógica para listar os rótulos de sensibilidade

Adicione lógica para listar os rótulos de sensibilidade da sua organização, usando o objeto File engine.

Abra a solução Visual Studio que você criou no artigo anterior "Guia de início rápido: inicialização de aplicativo cliente (C#)".
Usando o Gerenciador de Soluções, abra o arquivo de .cs em seu projeto que contém a implementação do Main() método. O padrão é o mesmo nome do projeto que o contém, que você especificou durante a criação do projeto.
No final do Main() corpo, acima da seção de desligamento Main() do aplicativo da função (onde você parou no Guia de início rápido anterior), insira o seguinte código:

// 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));
        }
    }
}

Crie e teste o aplicativo

Finalmente, crie e teste seu aplicativo cliente.

Use CTRL-SHIFT-B (Build Solution) para criar seu aplicativo cliente. Se você não tiver erros de compilação, use F5 (Iniciar depuração) para executar seu aplicativo.
Se o projeto for compilado e executado com êxito, o aplicativo poderá solicitar autenticação usando a Microsoft Authentication Library (MSAL) sempre que o SDK chamar seu AcquireToken() método. Se as credenciais em cache já existirem, você não será solicitado a entrar e ver a lista de rótulos.
- Você também pode precisar dar consentimento, para permitir que o aplicativo acesse as APIs MIP, enquanto estiver sendo executado sob a conta de login. Isso acontece quando o registro do aplicativo Microsoft Entra não é pré-consentido (conforme descrito em "Instalação e configuração do MIP SDK") ou quando você está entrando com uma conta de um locatário diferente (diferente daquele em que seu aplicativo está registrado). Basta clicar em Aceitar para registar o seu consentimento.
Após a autenticação, a saída do console deve mostrar os rótulos de sensibilidade, semelhante ao exemplo a seguir:

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

Copie e salve a ID de um ou mais rótulos de sensibilidade (por exemplo, f42a3342-8706-4288-bd31-ebb85995028z), como você usará no próximo Guia de início rápido.

Resolução de problemas

Problemas durante a execução do aplicativo C#

Resumo	Mensagem de erro	Solução
Token de acesso incorreto	Ocorreu uma exceção... O token de acesso está incorreto/expirado? Falha na chamada de API: profile_add_engine_async Falha com: [class mip::P olicySyncException] Falha na aquisição da política, Falha na solicitação com código de status http: 401, x-ms-diagnostics: [2000001; reason="O token OAuth enviado com a solicitação não pode ser analisado."; error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (processo 29924) saiu com o código 0. Pressione qualquer tecla para fechar esta janela. . .	Se o seu projeto é compilado com êxito, mas você vê uma saída semelhante à esquerda, você provavelmente tem um token inválido ou expirado em seu `AcquireOAuth2Token()` método. Volte para Compilar e testar o aplicativo e regenere o token de acesso, atualize `AcquireOAuth2Token()` novamente e reconstrua/teste. Você também pode examinar e verificar o token e suas declarações, usando o jwt.ms aplicativo Web de página única.
Os rótulos de sensibilidade não estão configurados	n/d	Se o projeto for compilado com êxito, mas você não tiver saída na janela do console, verifique se os rótulos de sensibilidade da sua organização estão configurados corretamente. Consulte Instalação e configuração do MIP SDK, em "Definir taxonomia de rótulo e configurações de proteção" para obter detalhes.

Passos Seguintes

Agora que você aprendeu a listar os rótulos de sensibilidade para sua organização, tente o próximo guia de início rápido:

Definir e obter um rótulo de sensibilidade