Início rápido: Listar etiquetas de sensibilidade – SDK de Políticas (C++)

Este guia rápido mostra como usar o SDK de Política de MIP para listar as etiquetas de sensibilidade configuradas para sua organização.

Pré-requisitos

Caso ainda não tenha feito isso, certifique-se de concluir os seguintes pré-requisitos antes de continuar:

• Primeiro, complete o Início rápido: Inicialização do aplicativo cliente — SDK de Políticas (C++), que cria uma solução inicial do Visual Studio.
• Opcional: revise 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 de mecanismo de Política.

1. Abra a solução do Visual Studio que você criou no início rápido anterior.

2. Na função main(), após o mecanismo ser carregado com êxito, adicione o seguinte código:

   // List sensitivity labels
   cout << "\nSensitivity labels for your organization:\n";
   auto labels = engine->ListSensitivityLabels();
   for (const auto& label : labels)
   {
       cout << label->GetName() << " : " << label->GetId() << endl;
   
       for (const auto& child : label->GetChildren())
       {
           cout << "->  " << child->GetName() << " : " << child->GetId() << endl;
       }
   }
   

3. Opcionalmente, filtre rótulos por formato de conteúdo (por exemplo, "email" ou "file"):

   // List labels for email content only
   std::vector<std::string> contentFormats = { "email" };
   auto emailLabels = engine->ListSensitivityLabels(contentFormats);
   

Criar e testar o aplicativo

Crie e teste seu aplicativo cliente.

1. Use Ctrl+Shift+B (Build Solution) para criar o aplicativo. Se você não tiver erros de compilação, use F5 (Iniciar depuração) para executar.

2. Na primeira execução, o aplicativo solicita autenticação. Forneça credenciais para uma conta de usuário em seu locatário.

3. O resultado exibe os rótulos de confidencialidade configurados para sua organização, como:

   Sensitivity labels for your organization:
   Public : <label-id>
   General : <label-id>
   ->  Anyone (unrestricted) : <label-id>
   Confidential : <label-id>
   ->  All Employees : <label-id>
   ->  Recipients Only : <label-id>
   Highly Confidential : <label-id>
   ->  All Employees : <label-id>
   ->  Recipients Only : <label-id>
   

Verificando o comportamento do rótulo

Você também pode consultar informações de tipo de proteção de rótulo para determinar como cada rótulo se comporta. A partir do SDK do MIP 1.18, a Label classe fornece métodos para verificar o tipo de proteção:

for (const auto& label : labels)
{
    cout << label->GetName();
    
    if (label->HasDoNotForwardProtection())
        cout << " [Do Not Forward]";
    else if (label->HasEncryptOnlyProtection())
        cout << " [Encrypt Only]";
    else if (label->HasAdhocProtection())
        cout << " [Custom Protection]";
    
    cout << endl;
}

Próximas Etapas 

• Ações de política de computação (C++)
• Tipos de proteção de rótulo
• Conceitos de rótulo de classificação
• Explore o exemplo em C++ do SDK da Política MIP no GitHub.