Início rápido: listar rótulos de confidencialidade (C#)

Artigo
01/30/2024

Este Início Rápido mostra como usar o SDK de Arquivo da PIM para listar os rótulos de confidencialidade configurados para sua organização.

Pré-requisitos

Conclua os seguintes pré-requisitos antes de continuar, caso ainda não tenha feito isso:

Conclua primeiro o Início rápido: inicialização do aplicativo cliente (C#), que cria uma solução inicial do Visual Studio. Esse início rápido "Listar rótulos de confidencialidade" se baseia no anterior, referente à criação correta da solução de inicializador.
Como alternativa: examine os conceitos de rótulos de classificação.

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

Adicione lógica para listar os rótulos de confidencialidade da sua organização usando o objeto de mecanismo de Arquivo.

Abra a solução do Visual Studio que você criou no artigo anterior "Início rápido: inicialização do aplicativo cliente (C#)".
Usando o Gerenciador de Soluções, abra o arquivo .cs no projeto que contém a implementação do método Main(). Ele usa como padrão o mesmo nome que o projeto em que está contido, que você especificou durante a criação do projeto.
Perto do final do corpo Main(), acima da seção de desligamento do aplicativo da função Main() (no ponto em que você parou no 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));
        }
    }
}

Criar e testar o aplicativo

Por fim, crie e teste o seu aplicativo cliente.

Use CTRL-SHIFT-B (Compilar solução) para compilar o aplicativo cliente. Se não houver erros de build, use F5 (Iniciar depuração) para executar o aplicativo.
Se seu projeto for compilado e executado com êxito, o aplicativo poderá solicitar autenticação usando a MSAL (Biblioteca de Autenticação da Microsoft) sempre que o SDK chamar seu método AcquireToken(). Se já existirem credenciais armazenadas em cache, não será solicitado que você faça logon e veja a lista de rótulos.
- Talvez você também precise dar consentimento para permitir que o aplicativo acesse as APIs da PIM, enquanto estiver em execução na conta de entrada. Isso ocorre quando o registro de aplicativo do Microsoft Entra não tem consentimento prévio (conforme descrito em "Configuração e instalação do SDK da PIM") ou quando você está se conectando usando a conta de outro locatário (diferente daquele em que seu aplicativo está registrado). Basta clicar em Aceitar para registrar seu consentimento.
Após a autenticação, sua saída do console deverá mostrar os rótulos de confidencialidade, semelhantes ao seguinte exemplo:

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.

Observação

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

Solução de problemas

Problemas durante a execução do aplicativo C#

Resumo	Mensagem de erro	Solução
Token de acesso inválido	Ocorreu uma exceção... o token de acesso está incorreto/expirado? Chamada à API com falha: profile_add_engine_async falhou com: [class mip::PolicySyncException] Falha na aquisição de política, Falha na solicitação com o código de status http: 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 (processo 29924) saiu com o código 0. Pressione qualquer tecla para fechar essa janela. . .	Se o projeto foi compilado com sucesso, mas você viu uma saída semelhante à da esquerda, provavelmente você tem um token inválido ou expirado em seu método `AcquireOAuth2Token()`. Volte para Compilar e testar o aplicativo e gere novamente o token de acesso, atualize `AcquireOAuth2Token()` outra vez e recompile/teste de novo. Você também pode examinar e verificar o token e suas declarações usando o aplicativo Web de página única jwt.ms.
Os rótulos de confidencialidade não estão configurados	N/D	Se o projeto for compilado com sucesso, mas não houver saída na janela do console, verifique se os rótulos de confidencialidade da sua organização estão configurados corretamente. Confira Configuração e instalação do SDK da PIM, em "Definir configurações de taxonomia e proteção do rótulo" para obter detalhes.

Próximas etapas

Agora que você aprendeu como listar os rótulos de confidencialidade da sua organização, experimente o próximo início rápido:

Definir e obter um rótulo de confidencialidade

Compartilhar via