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

Este guia de início rápido mostra como usar o SDK de Arquivos do MIP para listar os rótulos de confidencialidade configurados para sua organização.

Pré-requisitos

Caso ainda não tenha feito isso, certifique-se de concluir os seguintes pré-requisitos antes de continuar:

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 do mecanismo de arquivo.

  1. Abra a solução do Visual Studio que você criou no artigo "Início Rápido: Inicialização do aplicativo cliente (C#)" anterior.

  2. Em Gerenciador de Soluções, abra o arquivo .cs em seu projeto que contém a implementação do Main() método. Ele usa como padrão o mesmo nome do projeto que o contém, que você especificou durante a criação do projeto.

  3. Perto do final do corpo de Main(), antes da seção de encerramento do aplicativo da função Main() (onde você parou no guia de início rápido anterior), insira o código a seguir:

// 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

Crie e teste seu aplicativo cliente.

  1. 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 sua aplicação.

  2. Se o projeto for compilado e executado com êxito, o aplicativo poderá solicitar autenticação usando Biblioteca do Microsoft Authenticator (MSAL) sempre que o SDK chamar seu AcquireToken() método. Se as credenciais armazenadas em cache já existirem, você não precisará fazer login e verá a lista de rótulos.

    Prompt de login do token de aquisição do Visual Studio.

    • Talvez você também precise conceder consentimento para permitir que o aplicativo acesse as APIs do MIP enquanto estiver em execução na conta usada para fazer login. Isso acontece quando o registro de aplicativo do Microsoft Entra não é pré-consentido (conforme descrito em "Configuração e configuração do SDK do MIP"), ou você está entrando com uma conta de um locatário diferente (diferente daquela em que seu aplicativo está registrado). Selecione Aceitar para registrar seu consentimento.

      Visual Studio aviso de consentimento.

  3. Após a autenticação, a saída do console deve mostrar os rótulos de sensibilidade, semelhantes 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.

Observação

Copie e salve a ID de um ou mais dos rótulos de confidencialidade (por exemplo), f42a3342-8706-4288-bd31-ebb85995028zporque você a usará no próximo 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 da API: profile_add_engine_async falhou com: [classe mip::PolicySyncException] Falha ao obter a política, a solicitação falhou com o 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:[aaaa0000-bb11-2222-33cc-444444dddddd]"

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (processo 29924) foi encerrado com o código 0.

Pressione qualquer tecla para fechar esta janela. . .		 Se o seu projeto for compilado com sucesso, mas você vir uma saída semelhante à mostrada à esquerda, o token no método AcquireOAuth2Token() provavelmente é inválido ou está expirado. Volte para Compilar e testar o aplicativo e regenerar o token de acesso, atualizar AcquireOAuth2Token() novamente e recompilar/testar novamente. 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 confidencialidade não estão configurados n/a Se o projeto for compilado com sucesso, mas nenhuma saída for exibida na janela do console, verifique se os rótulos de confidencialidade da sua organização estão configurados corretamente. Para obter detalhes, consulte configuração e configuração do SDK do MIP em "Definir configurações de proteção e taxonomia de rótulo".

Próximas Etapas 

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

Definir e obter um rótulo de confidencialidade

  • Last updated on