Guia de início rápido: modelos de lista (C#)

Artigo
01/30/2024

Este Guia de início rápido mostra como usar o SDK de proteção MIP para listar os modelos de proteção disponíveis para o usuário.

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 do aplicativo cliente - SDK de proteção (C#) primeiro, que cria uma solução inicial do Visual Studio. Este Guia de início rápido "Lista de modelos de proteção" baseia-se no anterior, para a criação adequada da solução inicial.
Opcionalmente: Revise os conceitos de Modelos do RMS.

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

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

Abra a solução Visual Studio que você criou no artigo anterior "Guia de início rápido - Inicialização do aplicativo cliente - SDK de proteção (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 QuickStart 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...");

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 seu projeto for compilado e executado com êxito, o aplicativo poderá solicitar autenticação via ADAL cada vez 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 modelos de proteção para o usuário autenticado, semelhante ao exemplo a seguir:

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.

Nota

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

Passos Seguintes

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

Guia de início rápido - Criptografar e descriptografar texto

Partilhar via