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

Este quickstart mostra-lhe como usar o MIP Policy SDK para listar as etiquetas de sensibilidade configuradas para a sua organização.

Pré-requisitos

Se ainda não o fizeste, certifica-te de cumprir os seguintes pré-requisitos antes de continuar:

• Complete Início Rápido: Inicialização da aplicação cliente - Policy SDK (C++) primeiro, que constrói uma solução inicial do Visual Studio.
• Opcionalmente: Rever conceitos de etiquetas de classificação .

Adicionar lógica para listar as etiquetas de sensibilidade

Adicione lógica para listar as etiquetas de sensibilidade da sua organização usando o objeto do motor de políticas.

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

2. Na main() função, após o motor carregar com sucesso, 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, filtrar os rótulos pelo formato do conteúdo (por exemplo, "email" ou "file"):

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

Construir e testar a aplicação

Constrói e testa a tua aplicação cliente.

1. Use Ctrl+Shift+B (Build Solution) para construir a aplicação. Se não tiveres erros de compilação, usa F5 (Start debug) para correr.

2. Na primeira execução, a aplicação solicita autenticação. Forneça credenciais para uma conta de utilizador no seu tenant.

3. A saída mostra as etiquetas de sensibilidade configuradas para a sua organização, semelhante a:

   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>
   

Verificação do comportamento do rótulo

Também pode consultar informações sobre o tipo de proteção de etiquetas para determinar como cada etiqueta se comporta. A partir do MIP SDK 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;
}

Passos seguintes

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