Краткое руководство: вывод списка меток конфиденциальности (C#)

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

Необходимые условия

Если вы еще не сделали этого, перед продолжением обязательно выполните следующие предварительные требования:

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

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

  1. Откройте решение Visual Studio, созданное в предыдущей статье "Краткое руководство. Инициализация клиентского приложения (C#)".

  2. С помощью обозревателя решений откройте файл .cs в проекте, который содержит реализацию Main() метода. По умолчанию используется то же имя, что и проект, содержащий его, указанный во время создания проекта.

  3. Ближе к концу тела 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));
        }
    }
}

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

Наконец, создайте и протестируйте клиентское приложение.

  1. Используйте CTRL-SHIFT-B (Построить решение) для создания клиентского приложения. Если у вас нет ошибок сборки, используйте F5 (начать отладку) для запуска приложения.

  2. Если проект успешно собирается и запускается, приложение может запрашивать аутентификацию с помощью Microsoft Authentication Library (MSAL) каждый раз, когда пакет SDK вызывает ваш метод AcquireToken(). Если кэшированные учетные данные уже существуют, вам не будет предложено войти и просмотреть список меток.

    Получение токена для входа в Visual Studio

    • Кроме того, вам может потребоваться предоставить согласие, чтобы разрешить приложению доступ к API MIP во время выполнения под учетной записью входа. Это происходит, когда регистрация приложения Microsoft Entra не предоставляется предварительно (как описано в разделе "Настройка и настройка пакета SDK MIP") или вы входите с учетной записью из другого клиента (отличного от того, где зарегистрировано приложение). Просто нажмите кнопку "Принять" , чтобы записать свое согласие.

      Согласие Visual Studio

  3. После проверки подлинности выходные данные консоли должны отображать метки конфиденциальности, аналогичные следующему примеру:

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.

Note

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

Troubleshooting

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

Сводка Сообщение об ошибке Solution
Недопустимый токен доступа Произошло исключение... токен доступа неправильный или истек срок его действия?

Сбой вызова API: profile_add_engine_async завершился с ошибкой: [class mip::PolicySyncException] Не удалось получить политику, сбой запроса, код состояния HTTP: 401, x-ms-diagnostics: [2000001;reason="Токен OAuth, отправленный с запросом, не удается разобрать.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (процесс 29924) завершился с кодом 0.

Нажмите любую клавишу, чтобы закрыть это окно. . .		 Если проект успешно выполняется, но вы видите такие выходные данные, как на изображении слева, скорее всего, в вашем методе AcquireOAuth2Token() используется недействительный или истекший токен. Вернитесь к сборке и тестированию приложения, повторно создайте токен доступа, снова обновите AcquireOAuth2Token(), затем перестройте/протестируйте заново. Вы также можете изучить и проверить токен и его утверждения с помощью одностраничного веб-приложения jwt.ms.
Метки конфиденциальности не настроены n/a Если проект успешно выполняет сборку, но в окне консоли нет выходных данных, убедитесь, что метки конфиденциальности вашей организации настроены правильно. Дополнительные сведения см. в разделе "Настройка и настройка пакета SDK MIP" в разделе "Определение параметров таксономии меток и защиты".

Дальнейшие шаги

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

Установка и получение метки чувствительности

  • Last updated on