Szybki start: szablony list (C#)
W tym przewodniku Szybki start pokazano, jak za pomocą zestawu SDK ochrony przed zabezpieczeniami MIP wyświetlić listę szablonów ochrony dostępnych dla użytkownika.
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: inicjowanie aplikacji klienckich — najpierw zestaw SDK ochrony (C#), który tworzy Visual Studio startowego. Ten przewodnik Szybki start "Szablony ochrony listy" opiera się na poprzednim, aby zapewnić prawidłowe utworzenie rozwiązania startowego.
- Opcjonalnie: Zapoznaj się z pojęciami szablonów usługi RMS.
Dodawanie logiki do listy szablonów ochrony
Dodaj logikę do szablonów ochrony listy dostępnych dla użytkownika przy użyciu obiektu aparatu ochrony.
Otwórz Visual Studio rozwiązania utworzonego w poprzednim artykule "Szybki start — inicjowanie aplikacji klienckiej — zestaw SDK ochrony (C#)".
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.
Na końcu treści, powyżej sekcji zamykania aplikacji funkcji (na miejscu, w którym ten szybki start został zakończony), wstaw
Main()Main()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...");
Tworzenie i testowanie aplikacji
Na koniec skompilowanie i testowanie aplikacji klienckiej.
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ę.
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.
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ę.
Po uwierzytelnieniu dane wyjściowe konsoli powinny pokazywać szablony ochrony dla uwierzytelnionego 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 jednego lub większej liczby szablonów ochrony (na przykład ), jak w przypadku następnego bb7ed207-046a-4caf-9826-647cff56b990 przewodnika 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. |
Następne kroki
Po tym, jak wyświetlić listę szablonów ochrony dostępnych dla uwierzytelnionego użytkownika, wypróbuj następny szybki start: