Início Rápido: Modelos de Lista (C#)

Artigo
01/30/2024

Este Início Rápido mostra como usar o SDK de Proteção da PIM para listar os modelos de proteção disponíveis para o usuário.

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 – SDK de proteção (C#), que cria uma solução inicial do Visual Studio. Este início rápido "Listar modelos de proteção" depende do anterior para a criação adequada da solução inicial.
Opcionalmente: examine os conceitos de modelos de RMS.

Adicionar lógica para listar os modelos de proteção

Adicione lógica para listar os modelos de proteção disponíveis para um usuário usando o objeto Mecanismo de proteção.

Abra a solução do Visual Studio que você criou no artigo anterior "Início Rápido – inicialização do aplicativo cliente – SDK de proteção (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 protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

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 o projeto for criado e executado com sucesso, o aplicativo poderá solicitar a autenticação por meio da ADAL sempre que o SDK chamar o 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, a saída do console deve mostrar os modelos de proteção para o usuário autenticado, semelhante ao seguinte exemplo:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Observação

Copie e salve a ID de um ou mais modelos de proteção (por exemplo, bb7ed207-046a-4caf-9826-647cff56b990) para 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.

Próximas etapas

Agora que você aprendeu a listar os modelos de proteção disponíveis para um usuário autenticado, vá para o próximo início rápido:

Início Rápido – Criptografar e Descriptografar texto

Compartilhar via