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 da Proteção MIP para listar os modelos de proteção disponíveis para o usuário.
Pré-requisitos
Conclua os seguintes pré-requisitos antes de continuar:
- 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 guia de início rápido "Listar modelos de proteção" baseia-se no início rápido anterior para criar corretamente a solução inicial.
- Opcional: examine os conceitos de modelos do RMS .
Adicionar lógica para listar os modelos de proteção
Adicione lógica para listar modelos de proteção disponíveis para um usuário usando o objeto do 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#)".
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.No final do
Main()corpo, acima da seção de desligamento do aplicativo daMain()função (de onde 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
Crie e teste seu aplicativo cliente.
Use Ctrl+Shift+B (Build Solution) para criar seu aplicativo cliente. Se o build não tiver erros, use F5 (Iniciar depuração) para executar seu aplicativo.
Se o projeto for compilado e executado com êxito, o aplicativo poderá solicitar a autenticação usando a MSAL 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 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.
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.
Observação
Copie e salve o 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.
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. |
Próximas Etapas
Agora que você aprendeu a listar os modelos de proteção disponíveis para um usuário autenticado, experimente o próximo início rápido:
- Conheça o exemplo .NET do SDK de Proteção do MIP no GitHub.