Краткое руководство. Перечисление меток конфиденциальности (C#)

Статья
01/30/2024

В этом кратком руководстве показано, как использовать пакет SDK MIP File для перечисления меток конфиденциальности, настроенных для вашей организации.

Необходимые компоненты

Прежде чем продолжить, выполните следующие предварительные требования:

Сначала изучите статью Краткое руководство. Инициализация клиентских приложений (C#), в которой показано, как создать начальное решение в Visual Studio. Это краткое руководство "Перечисление меток конфиденциальности" основано на предыдущем для правильного создания начального решения.
(Необязательно.) Просмотрите понятия меток классификации.

Добавление логики для перечисления меток конфиденциальности

Добавьте логику для перечисления меток конфиденциальности вашей организации с помощью объекта подсистемы File.

Откройте решение Visual Studio, созданное при работе с предыдущей статьей "Краткое руководство. Инициализация клиентских приложений (C#)".
С помощью Обозревателя решений откройте файл .cs в проекте, содержащем реализацию метода Main(). По умолчанию он имеет то же имя, что и содержащий его проект, который вы указали при создании проекта.
В конце блока Main(), перед блоком завершения работы приложения функции Main() (где вы закончили работу в предыдущем руководстве) вставьте следующий код:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Создание и тестирование приложения

Наконец, выполните сборку клиентского приложения и протестируйте его.

Нажмите клавиши CTRL+SHIFT+B (Собрать решение), чтобы выполнить сборку клиентского приложения. Если ошибок сборки нет, нажмите клавишу F5 (Начать отладку), чтобы запустить приложение.
Если проект успешно создан и запущен, приложение может запрашивать проверку подлинности через Библиотеку проверки подлинности Майкрософт (MSAL) каждый раз, когда пакет SDK вызывает метод AcquireToken(). Если учетные данные уже есть в кэше, вам не будет предложено войти, чтобы посмотреть список меток.
- Кроме того, вам может потребоваться предоставить разрешение на доступ приложения к API MIP во время работы с учетной записью, использовавшейся для входа. Это происходит, когда регистрация приложения Microsoft Entra не предоставляется предварительно (как описано в разделе "Настройка и настройка пакета SDK MIP") или вы входите с учетной записью из другого клиента (отличного от того, где зарегистрировано приложение). Просто щелкните Принять, чтобы записать согласие.
После проверки подлинности в выходных данных консоли должны отображаться метки конфиденциальности, как в примере ниже:

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

Примечание.

Скопируйте и сохраните идентификатор одной или нескольких меток конфиденциальности (например, f42a3342-8706-4288-bd31-ebb85995028z), так как вы будете использовать его в следующем кратком руководстве.

Устранение неполадок

Проблемы при выполнении приложения C#

Итоги	Сообщение об ошибке	Решение
Неправильный маркер доступа	Выдано исключение… Маркер доступа неправильный или истек срок его действия? Failed API call: profile_add_engine_async Failed with: [class mip::PolicySyncException] Failed acquiring policy, Request failed with http status code: 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 (process 29924) exited with code 0. Нажмите любую клавишу, чтобы закрыть это окно. . .	Если ваш проект создан успешно, но отображается результат, аналогичный показанному слева, скорее всего, в методе `AcquireOAuth2Token()` используется недействительный маркер или маркер, срок действия которого истек. Вернитесь в раздел Сборка и тестирование приложения и заново создайте маркер доступа, обновите `AcquireOAuth2Token()` еще раз, а также повторно выполните сборку и тестирование приложения. Вы также можете проверить и подтвердить маркер и его утверждения с помощью одностраничного веб-приложения jwt.ms.
Метки конфиденциальности не настроены	Н/Д	Если проект создан успешно, но в окне консоли нет выходных данных, убедитесь, что метки конфиденциальности вашей организации настроены правильно. Дополнительные сведения см. в статье Установка и настройка пакета SDK MIP в разделе "Определение таксономии меток и параметров защиты".

Дальнейшие действия

Теперь, когда вы узнали, как перечислить метки конфиденциальности для вашей организации, переходите к следующему краткому руководству:

Настройка и получение метки конфиденциальности

Поделиться через