Szybki start: Lista etykiet wrażliwości (C#)

  • Artykuł
  • Czas czytania: 3 min

W tym przewodniku Szybki start pokazano, jak za pomocą zestawu SDK pliku MIP wyświetlić etykiety wrażliwości skonfigurowane dla organizacji.

Wymagania wstępne

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

  • Pełny przewodnik Szybki start: najpierw inicjowanie aplikacji klienckich (C#), co tworzy rozwiązanie Visual Studio startowe. Ten przewodnik Szybki start "Lista etykiet wrażliwości" opiera się na poprzedniej, aby zapewnić prawidłowe utworzenie rozwiązania startowego.
  • Opcjonalnie: Przejrzyj koncepcje etykiet klasyfikacji.

Dodaj logikę, aby wyświetlić etykiety wrażliwości

Dodaj logikę, aby wyświetlić etykiety wrażliwości Twojej organizacji przy użyciu obiektu Aparat plików.

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

  2. Za pomocą Eksploratorarozwiązań otwórz plik cs w projekcie, który zawiera implementację metody. Domyślna nazwa jest taka sama jak nazwa projektu zawierającego projekt, która jest określona podczas tworzenia projektu.

  3. Na końcu treści, powyżej sekcji zamykania aplikacji funkcji (na miejscu, w którym wcześniej szybki start został zakończony), wstaw Main()Main() 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));
        }
    }
}

Tworzenie i testowanie aplikacji

Na koniec skompilowanie i testowanie aplikacji klienckiej.

  1. Do tworzenia aplikacji klienckiej użyj klawiszy CTRL-SHIFT-B(rozwiązaniekompilacji). Jeśli nie występują błędy kompilacji, użyj klawisza F5(Rozpocznijdebugowanie), aby uruchomić aplikację.

  2. Jeśli projekt zostanie pomyślnie skompilowany i uruchomiony, aplikacja może za każdym razem, gdy zestaw SDK wywoła metodę, może zostać wyświetlony monit o uwierzytelnienie za pośrednictwem usługi ADAL. Jeśli poświadczenia buforowane już istnieją, nie zostanie wyświetlony monit o zalogowanie się i wyświetlanie listy etykiet.

    Visual Studio uzyskać logowanie tokenu

    • Podczas uruchamiania w ramach konta logowania może być również konieczne wyrażenie zgody w celu zezwolenia aplikacji na dostęp do interfejsów API miP. Dzieje się tak, gdy rejestracja aplikacji usługi Azure AD nie jest wstępnie ze zgodą (zgodnie z konspektem "Konfiguracja i konfiguracja zestawu SDK MIP") lub logujesz się przy użyciu konta z innej dzierżawy (innej niż ta, w której jest zarejestrowana aplikacja). Po prostu kliknij przycisk Zaakceptuj, aby nagrać swoją zgodę.

      Visual Studio zgody

  3. Po uwierzytelnieniu dane wyjściowe konsoli powinny pokazywać etykiety wrażliwoś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 identyfikator co najmniej jednej etykiety wrażliwości i zapisz go w następnym przewodniku f42a3342-8706-4288-bd31-ebb85995028z Szybki start.

Rozwiązywanie problemów

Problemy podczas wykonywania aplikacji C#

Podsumowanie Komunikat o błędzie Rozwiązanie
Token o złym dostępie Wystąpił wyjątek... czy token dostępu jest nieprawidłowy/wygasł?

Niepowodzenie wywołania interfejsu API: błąd profile_add_engine_async z: [class mip::P olicySyncException] Nie można uzyskać zasad, Żądanie nie powiodło się z kodem stanu http: 401, x-ms-diagnostics: [2000001;reason="Nie można przechwycić tokenu OAuth przesłanego z żądaniem". error_category="invalid_token"], korelacjaId:[35bc0023-3727-4eff-8062-000006d5d672]'

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

Naciśnij dowolny klawisz, aby zamknąć to okno. . .		 Jeśli projekt pomyślnie tworzy kompilacje, ale widzisz dane wyjściowe podobne do lewej, prawdopodobnie masz nieprawidłowy lub wygasły token w AcquireOAuth2Token() Twojej metodzie. Wróć do tematu Tworzenie i testowanie aplikacji, a następnie ponownie generuj token dostępu, ponownie zaktualizuj go oraz odbuduj/ponownie przetestuj. Możesz również zbadać i zweryfikować token oraz jego roszczenia, używając jwt.ms jednostronicowej aplikacji sieci Web.
Etykiety wrażliwości nie są skonfigurowane n/a Jeśli projekt pomyślnie konstruuje się, ale w oknie konsoli nie ma żadnych danych wyjściowych, upewnij się, że etykiety wrażliwości Twojej organizacji są skonfigurowane poprawnie. Aby uzyskać szczegółowe informacje,zobacz Konfigurowanie i konfigurowanie zestawu SDK programu MIP w obszarze "Definiowanie ustawień taksonomii i ochrony etykiet".

Następne kroki

Po tym, jak wyświetlić etykiety wrażliwości dla organizacji, wypróbuj następny szybki start:

Ustawianie i uzyskiwanie etykiety wrażliwości