Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este Início Rápido mostra como usar o SDK de Arquivo 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:
- 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 do motor de arquivo.
Abra a solução do Visual Studio que você criou no artigo "Início Rápido: Inicialização do aplicativo cliente (C#)" anterior.
Usando o 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.Perto do final do corpo
Main(), acima da seção de desligamento do aplicativo da funçãoMain()(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 seu aplicativo cliente.
Use CTRL-SHIFT-B (Build Solution) para criar seu aplicativo cliente. Se você não tiver erros de build, 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 MSAL (Biblioteca de Autenticação da Microsoft) sempre que o SDK chamar seu
AcquireToken()método. Se as credenciais armazenadas em cache já existirem, você não será solicitado a entrar e ver a lista de rótulos.Talvez você também precise dar consentimento para permitir que o aplicativo acesse as APIs de MIP enquanto estiver executando na conta em que você está logado. 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). Basta clicar em Aceitar para registrar seu consentimento.
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 o ID de um ou mais rótulos de confidencialidade (por exemplo, f42a3342-8706-4288-bd31-ebb85995028z), pois você o 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? 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) foi encerrado com o código 0. Pressione qualquer tecla para fechar esta 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 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 não houver saída na janela do console, verifique se os rótulos de confidencialidade da sua organização estão configurados corretamente. Consulte a configuração e a configuração do SDK do MIP em "Definir configurações de proteção e taxonomia de 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:

