Szybki start: wyświetlanie listy etykiet poufności (C#)

W tym przewodniku Szybki start pokazano, jak za pomocą zestawu SDK plików MIP wyświetlić listę etykiet poufności skonfigurowanych dla organizacji.

Wymagania wstępne

Jeśli jeszcze tego nie zrobiono, przed kontynuowaniem upewnij się, że zostały spełnione następujące wymagania wstępne:

Dodaj logikę, aby wyświetlić listę etykiet poufności

Dodaj logikę umożliwiającą wyświetlenie listy etykiet poufności w Twojej organizacji przy użyciu obiektu silnika plików.

  1. Otwórz rozwiązanie programu Visual Studio utworzone w poprzednim artykule "Szybki start: inicjowanie aplikacji klienckiej (C#)".

  2. W Eksplorator rozwiązań otwórz plik .cs w projekcie zawierający implementację Main() metody . Domyślnie ma taką samą nazwę jak projekt zawierający go, który został określony podczas tworzenia projektu.

  3. Pod koniec treści elementu Main(), przed sekcją zamykania aplikacji w funkcji Main() (w miejscu, w którym zakończył się poprzedni przewodnik Szybki start), wstaw następujący kod:

// 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));
        }
    }
}

Kompilowanie i testowanie aplikacji

Skompiluj i przetestuj aplikację kliencą.

  1. Użyj CTRL-SHIFT-B (Kompiluj rozwiązanie) do skompilowania aplikacji klienckiej. Jeśli nie masz błędów kompilacji, użyj klawisza F5 (Rozpocznij debugowanie), aby uruchomić aplikację.

  2. Jeśli projekt zostanie pomyślnie skompilowany i uruchomiony, aplikacja może wyświetlać monit o uwierzytelnienie za pomocą biblioteki Microsoft Authentication Library (MSAL) za każdym razem, gdy SDK wywołuje metodę AcquireToken(). Jeśli buforowane poświadczenia już istnieją, nie zostanie wyświetlony monit o zalogowanie się i zostanie wyświetlona lista etykiet.

    Visual Studio uzyskać monit logowania tokenu.

    • Może być również konieczne wyrażenie zgody, aby umożliwić aplikacji dostęp do interfejsów API MIP podczas działania na koncie używanym do logowania. Dzieje się tak, gdy rejestracja aplikacji Microsoft Entra nie jest wcześniej zatwierdzona (zgodnie z opisem w sekcji "Konfiguracja zestawu MIP SDK") lub logujesz się przy użyciu konta z innego dzierżawcy (innego niż ten, w którym zarejestrowano aplikację). Wybierz pozycję Akceptuj , aby zarejestrować swoją zgodę.

      Monit o wyrażenie zgody w programie Visual Studio.

  3. Po uwierzytelnieniu dane wyjściowe konsoli powinny wyświetlać etykiety poufności, podobnie jak w poniższym przykładzie:

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.

Uwaga

Skopiuj i zapisz identyfikator jednej lub większej liczby etykiet poufności (na przykład f42a3342-8706-4288-bd31-ebb85995028z), ponieważ użyjesz go w następnym przewodniku z serii Szybki start.

Rozwiązywanie problemów

Problemy podczas wykonywania aplikacji w języku C#

Podsumowanie Komunikat o błędzie Rozwiązanie
Nieprawidłowy token dostępu Wystąpił wyjątek... czy token dostępu jest niepoprawny/wygasł?

Nieudane wywołanie interfejsu API: profile_add_engine_async zakończone niepowodzeniem: [class mip::PolicySyncException] Nie można uzyskać zasad, żądanie zakończyło się niepowodzeniem z kodem stanu HTTP: 401, x-ms-diagnostics: [2000001;reason="Tokenu OAuth przesłanego z żądaniem nie można przeanalizować.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proces 29924) zakończył działanie z kodem 0.

Naciśnij dowolny klawisz, aby zamknąć to okno. . .		 Jeśli projekt zostanie pomyślnie skompilowany, ale zobaczysz dane wyjściowe podobne do tych po lewej stronie, token w metodzie AcquireOAuth2Token() jest prawdopodobnie nieprawidłowy lub wygasł. Wróć do pozycji Kompiluj i przetestuj aplikację i ponownie wygeneruj token dostępu, zaktualizuj AcquireOAuth2Token() ponownie i ponownie skompiluj/ponownie przetestuj. Możesz również sprawdzić i zweryfikować token i jego oświadczenia przy użyciu aplikacji internetowej jwt.ms jednostronicowej.
Etykiety poufności nie są skonfigurowane N/a Jeśli projekt zostanie pomyślnie skompilowany, ale w oknie konsoli nie są wyświetlane żadne dane, upewnij się, że etykiety poufności w organizacji są poprawnie skonfigurowane. Aby uzyskać szczegółowe informacje, zobacz Konfigurowanie i konfigurowanie zestawu MIP SDK w obszarze "Definiowanie taksonomii etykiet i ustawień ochrony".

Następne kroki

Teraz gdy wiesz, jak wyświetlić listę etykiet poufności w organizacji, wypróbuj następny przewodnik Szybki start:

Ustawianie i uzyskiwanie etykiety poufności

  • Ostatnia aktualizacja o