Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este quickstart mostra-lhe como usar o MIP Protection SDK para listar os modelos de proteção disponíveis para o utilizador.
Pré-requisitos
Preencha 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 quickstart "List protection templates" baseia-se no quickstart anterior para criar corretamente a solução inicial.
- Opcional: Revise os conceitos dos modelos RMS.
Adicionar lógica para listar os modelos de proteção
Adicionar lógica a modelos de proteção de listas disponíveis para um utilizador usando o objeto do motor de proteção.
Abra a solução do Visual Studio que você criou no artigo anterior "Guia de início rápido - Inicialização do aplicativo cliente - SDK de proteção (C#)".
No Explorador de Soluções, abre o ficheiro .cs no teu projeto que contém a implementação do
Main()método. Por padrão, tem o mesmo nome do projeto que o contém, que especificou durante a criação do projeto.No final do
Main()corpo, acima da secção de encerramento da aplicação daMain()função (onde ficou 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
Crie e teste seu aplicativo cliente.
Use Ctrl+Shift+B (Build Solution) para criar seu aplicativo cliente. Se a compilação não tiver erros, use F5 (Iniciar depuração) para executar a sua aplicação.
Se o seu projeto for construído e executado com sucesso, a aplicação pode pedir autenticação usando MSAL sempre que o SDK chamar o seu
AcquireToken()método. Se já existirem credenciais em cache, não é solicitado a iniciar sessão e ver a lista de etiquetas.Também poderá precisar de dar consentimento para permitir que a aplicação aceda às APIs MIP enquanto está a correr na 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). Selecione 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.
Observação
Copie e guarde o ID de um ou vários modelos de proteção (por exemplo, bb7ed207-046a-4caf-9826-647cff56b990), para o utilizar 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 incorreto |
Ocorreu uma exceção... O token de acesso está incorreto/expirado? Chamada de API falhada: profile_add_engine_async falhou com: [class mip::PolicySyncException] Falha na obtenção da política, Solicitação falhada 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 teu projeto for compilado com êxito, mas surgir um resultado semelhante ao da esquerda, é provável que exista um token inválido ou expirado no teu método AcquireOAuth2Token().
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 um usuário autenticado, tente o próximo início rápido:
- Explore o exemplo .NET do SDK de Proteção MIP no GitHub.