Szybki start: szablony list (C#)
W tym przewodniku Szybki start pokazano, jak za pomocą zestawu MIP Protection SDK wyświetlić listę szablonów ochrony dostępnych dla użytkownika.
Wymagania wstępne
Jeśli jeszcze tego nie zrobiono, przed kontynuowaniem upewnij się, że zostały spełnione następujące wymagania wstępne:
- Ukończ szybki start: inicjowanie aplikacji klienckich — najpierw zestaw SDK ochrony (C#), który tworzy początkowe rozwiązanie programu Visual Studio. Ten przewodnik Szybki start dotyczący szablonów ochrony listy opiera się na poprzednim, umożliwiającym właściwe utworzenie rozwiązania startowego.
- Opcjonalnie: Zapoznaj się z pojęciami dotyczącymi szablonów usługi RMS.
Dodawanie logiki w celu wyświetlenia listy szablonów ochrony
Dodaj logikę, aby wyświetlić listę szablonów ochrony dostępnych dla użytkownika przy użyciu obiektu aparatu ochrony.
Otwórz rozwiązanie programu Visual Studio utworzone w poprzednim artykule "Szybki start — inicjowanie aplikacji klienckiej — zestaw SDK ochrony (C#)".
Za pomocą 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.Na końcu
Main()treści powyżej sekcjiMain()zamykania aplikacji funkcji (w której została przerwana w poprzednim przewodniku Szybki start), wstaw następujący kod:
// List protection templates using protectionEngine and display the list
var templates=protectionEngine.GetTemplates();
for(int i = 0; i < templates.Count; i++)
{
Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}
Console.WriteLine("Press a key to continue...");
Kompilowanie i testowanie aplikacji
Na koniec skompiluj i przetestuj aplikację kliencą.
Użyj klawiszy CTRL-SHIFT-B (rozwiązanie kompilacji), aby skompilować aplikację kliencą. Jeśli nie masz błędów kompilacji, użyj klawisza F5 (Rozpocznij debugowanie), aby uruchomić aplikację.
Jeśli projekt kompiluje i uruchamia się pomyślnie, aplikacja może monitować o uwierzytelnienie za pośrednictwem biblioteki ADAL za każdym razem, gdy zestaw SDK wywołuje metodę
AcquireToken(). Jeśli buforowane poświadczenia już istnieją, nie zostanie wyświetlony monit o zalogowanie się i wyświetlenie listy etykiet.
Może być również konieczne wyrażenie zgody, aby zezwolić aplikacji na dostęp do interfejsów API usługi MIP podczas uruchamiania na koncie logowania. Dzieje się tak, gdy rejestracja aplikacji Microsoft Entra nie jest wstępnie wyrażona (zgodnie z opisem w sekcji "Konfiguracja i konfiguracja zestawu MIP SDK") lub logujesz się przy użyciu konta z innej dzierżawy (innej niż ta, w której zarejestrowano aplikację). Po prostu kliknij przycisk Akceptuj , aby zarejestrować swoją zgodę.
Po uwierzytelnieniu dane wyjściowe konsoli powinny wyświetlać szablony ochrony dla uwierzytelnioowanego użytkownika, podobnie jak w poniższym przykładzie:
0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.
Uwaga
Skopiuj i zapisz identyfikator co najmniej jednego szablonu ochrony (na przykład bb7ed207-046a-4caf-9826-647cff56b990), ponieważ będzie on używany w następnym przewodniku 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 Niepowodzenie z: [klasa mip::P olicySyncException] Nieudane uzyskiwanie zasad, Żądanie nie powiodło się z kodem stanu http: 401, x-ms-diagnostics: [2000001; reason="Token OAuth przesłany z żądaniem nie można przeanalizować". error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' 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 skompilowane, ale zobaczysz dane wyjściowe podobne do lewej, prawdopodobnie masz nieprawidłowy lub wygasły token w metodzie AcquireOAuth2Token() . 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. |
Następne kroki
Teraz, gdy wiesz już, jak wyświetlić listę szablonów ochrony dostępnych dla uwierzytelnioowanego użytkownika, wypróbuj następny przewodnik Szybki start: