zestaw SDK Microsoft Information Protection — pojęcia związane z obiektami profilu i silnika

Profile

Klasa MipContext przechowuje ustawienia specyficzne dla zestawu SDK. Profil jest klasą główną dla wszystkich operacji etykietowania i ochrony specyficznych dla programu MIP w zestawie MIP SDK. Przed użyciem dowolnego z trzech zestawów interfejsów API aplikacja kliencka musi utworzyć profil. Profil lub inne obiekty dodane do profilu wykonują przyszłe operacje. Użyj tylko jednego obiektu profilu na proces. Utworzenie więcej niż jednego może spowodować nieoczekiwane zachowanie.

Zestaw MIP SDK ma trzy typy profilów:

Interfejs API, z którego korzysta aplikacja, decyduje o tym, którą klasę profilu należy zastosować.

Sam profil zapewnia następujące funkcje:

  • Przechowywanie stanu: Określa, czy stan ma być przechowywany w pamięci czy zapisywany na dysku oraz czy ma być szyfrowany, jeśli jest zapisywany na dysku.
  • Delegat obsługi zgody: Określa element mip::ConsentDelegate, który ma być używany do operacji związanych ze zgodą.
  • Obserwator profilu pliku: definiuje implementację mip::FileProfile::Observer do użycia na potrzeby asynchronicznych wywołań zwrotnych dla operacji profilu.

Ustawienia profilu

  • MipContext MipContext: obiekt, który został zainicjowany do przechowywania informacji o aplikacji, ścieżki stanu itp.
  • CacheStorageType: definiuje sposób przechowywania stanu: w pamięci, na dysku lub na dysku jako zaszyfrowane.
  • consentDelegate: współużytkowany wskaźnik klasy mip::ConsentDelegate.
  • observer: udostępniony wskaźnik do implementacji profilu Observer (w PolicyProfile systemach, ProtectionProfile i FileProfile).
  • applicationInfo: obiekt mip::ApplicationInfo. Informacje o aplikacji, która korzysta z zestawu SDK i której identyfikator oraz nazwa odpowiadają identyfikatorowi i nazwie rejestracji aplikacji Microsoft Entra.

Silniki

Mechanizmy zestawu SDK plików, zasad i ochrony udostępniają interfejs do wykonywania operacji przez określoną tożsamość. Dodaj jeden mechanizm w obiekcie profilu dla każdego użytkownika lub nazwy głównej usługi logujących się do aplikacji. Operacje delegowane można wykonywać przy użyciu programu mip::ProtectionSettings i programu obsługi plików lub ochrony. Aby uzyskać więcej informacji, zobacz sekcję ustawień ochrony w temacie „Pojęcia związane z FileHandler”.

SDK ma trzy klasy silnika, po jednej dla każdego interfejsu API. Na poniższej liście przedstawiono klasy silników i kilka funkcji skojarzonych z każdą z nich.

  • mip::ProtectionEngine
  • mip::PolicyEngine
    • ListSensitivityLabels(): Pobiera listę etykiet dla załadowanego silnika.
    • GetSensitivityLabel(): pobiera etykietę z istniejącej zawartości.
    • ComputeActions(): Podany z identyfikatorem etykiety i opcjonalnymi metadanymi zwraca listę akcji, które powinny wystąpić dla określonego elementu.
  • mip::FileEngine
    • ListSensitivityLabels(): Pobiera listę etykiet dla załadowanego silnika.
    • CreateFileHandler(): Tworzy mip::FileHandler dla określonego pliku lub strumienia.

Aby utworzyć silnik, przekaż określony obiekt ustawień silnika, który zawiera ustawienia dla typu silnika, który ma zostać utworzony. Obiekt ustawień umożliwia programiście określenie szczegółów dotyczących identyfikatora silnika, implementacji mip::AuthDelegate, ustawień regionalnych, ustawień niestandardowych oraz innych szczegółów specyficznych dla interfejsu API.

Stany aparatu

Silnik może mieć jeden z dwóch stanów:

  • CREATED: Utworzono oznacza, że zestaw SDK dysponuje wystarczającymi informacjami o stanie lokalnym po wywołaniu wymaganych usług serwera zaplecza.
  • LOADED: Zestaw SDK utworzył wymagane struktury danych, aby aparat działał.

Silnik musi być zarówno utworzony, jak i załadowany, aby wykonywać jakiekolwiek operacje. Klasa Profile udostępnia kilka metod zarządzania aparatami: AddEngineAsync, DeleteEngineAsynci UnloadEngineAsync.

W poniższej tabeli opisano możliwe stany aparatu i metody, które mogą zmienić ten stan:

Stan aparatu BRAK UTWORZONO ZAŁADOWANY
BRAK AddEngineAsync
UTWORZONO DeleteEngineAsync AddEngineAsync
ZAŁADOWANY DeleteEngineAsync UnloadEngineAsync

Identyfikator silnika

Każdy aparat ma unikatowy identyfikator , idużywany we wszystkich operacjach zarządzania aparatem. Aplikacja może udostępnić element id. Jeśli aplikacja go nie udostępnia, pakiet SDK może go wygenerować. Wszystkie pozostałe właściwości silnika, takie jak adres e-mail w informacjach o tożsamości, stanowią dla pakietu SDK nieprzejrzyste dane. Zestaw SDK nie wykonuje logiki w celu zachowania żadnych innych właściwości unikatowych ani wymuszania innych ograniczeń.

Ważne

Użyj identyfikatora silnika unikalnego dla użytkownika i używaj tego identyfikatora silnika za każdym razem, gdy użytkownik wykonuje operację przy użyciu zestawu SDK. Jeśli nie podasz istniejącego, unikalnego identyfikatora silnika dla użytkownika lub usługi, pakiet SDK spowoduje dodatkowe żądania do usługi. Te rundy usług mogą spowodować obniżenie wydajności i ograniczenie przepustowości.

// Create the FileEngineSettings object
FileEngine::Settings engineSettings(mip::Identity(mUsername), // This will be the engine ID. UPN, email address, or other unique user identifiers are recommended. 
													          mAuthDelegate,            // authDelegate implementation 
													          "",                       // ClientData
													          "en-US",                  // Client Locale
                                    false);                   // Load Sensitive Information Types

Metody zarządzania aparatem

SDK udostępnia trzy metody zarządzania silnikiem: AddEngineAsync, DeleteEngineAsync i UnloadEngineAsync.

AddEngineAsync

Ta metoda ładuje istniejący silnik lub tworzy go, jeśli jeszcze nie istnieje w stanie lokalnym.

Jeśli aplikacja nie udostępnia id w FileEngineSettings, AddEngineAsync generuje nowy element id. Następnie sprawdza, czy aparat z tym id już istnieje w lokalnej pamięci podręcznej magazynu. Jeśli tak, ładuje ten silnik. Jeśli silnik nie istnieje w lokalnej pamięci podręcznej, zostanie utworzony nowy silnik przez wywołanie niezbędnych interfejsów API i usług backendowych.

W obu przypadkach jeśli metoda powiedzie się, silnik jest ładowany i gotowy do użycia.

DeleteEngineAsync

Usuwa silnik z danym id. Wszystkie ślady aparatu są usuwane z lokalnej pamięci podręcznej.

UnloadEngineAsync

Zwalnia struktury danych w pamięci dla aparatu przy użyciu danego idelementu . Lokalny stan tego silnika pozostaje nienaruszony i można go ponownie załadować za pomocą AddEngineAsync.

Ta metoda pozwala aplikacji rozważnie zarządzać użyciem pamięci, poprzez zwolnienie silników, które nie są spodziewane do użycia w najbliższym czasie.

Następne kroki

  • Ostatnia aktualizacja o