Przetwarzanie plików wiadomości e-mail zestawu SDK

  • Artykuł

Zestaw MIP SDK obsługuje odszyfrowywanie i szyfrowanie wiadomości e-mail. Oba pliki .msg generowane przez program Outlook lub Exchange oraz pliki rpmsg są obsługiwane przez zestaw SDK, chociaż za pośrednictwem nieco różnych metod.

Typowe przypadki użycia dla tego scenariusza to:

  • Odszyfrowywanie wiadomości e-mail i załączników na potrzeby inspekcji ochrony przed utratą danych (DLP).
  • Publikowanie chronionych komunikatów bezpośrednio z aplikacji biznesowych
  • Odszyfrowywanie, modyfikowanie i ponowne włączanie ochrony komunikatów podczas przesyłania.
  • Zastosuj etykiety do wiadomości e-mail z usług DLP lub poczty.

Instrukcja obsługi plików MSG

Zestaw MIP SDK obsługuje aplikację ochrony i usuwanie plików MSG. Biorąc pod uwagę różne typy kodowania i zmienne w formacie lat, nie można zagwarantować, że zestaw MIP SDK może usunąć ochronę ze wszystkich plików MSG. W poniższej sekcji opisano obsługę plików MSG z różnych źródeł.

  • Usuwanie ochrony z plików MSG chronionych za pomocą zestawu MIP SDK jest w pełni obsługiwane.
  • Usuwanie ochrony z plików MSG utworzonych przez obecnie obsługiwane wersje klienta programu Outlook jest w pełni obsługiwane.
  • Usunięcie ochrony z plików MSG utworzonych przez wersje poza obsługą klienta programu Outlook jest obsługiwane w sposób optymalny.
  • Ponowne włączanie ochrony plików MSG nie jest dostępne w przypadku etykiet chronionych. Użytkownicy muszą jawnie wyłączyć ochronę i usunąć chronioną etykietę przed ponownym zabezpieczeniem pliku za pomocą innej etykiety.

Etykietowanie plików MSG

Zestaw MIP SDK obsługuje odczytywanie i zapisywanie etykiet w plikach MSG. Załączniki podrzędne nie dziedziczą etykiety, ale dziedziczą ustawienia ochrony. Aby uzyskać więcej informacji, zobacz Operacje etykietowania i ochrony w zestawie SDK plików, aby uzyskać więcej informacji na temat plików .msg.

Operacje etykietowania i ochrony w zestawie SDK plików dla plików .msg

Zestaw FILE SDK obsługuje operacje etykietowania i ochrony dla plików .msg w sposób identyczny z dowolnym innym typem pliku, z tą różnicą, że zestaw SDK wymaga aplikacji włączenia flagi funkcji MSG.

Jak wspomniano wcześniej, utworzenie wystąpienia FileEngine obiektu wymaga obiektu ustawień . FileEngineSettings FileEngineSettings Może służyć do przekazywania parametrów dla ustawień niestandardowych w celu spełnienia określonych potrzeb aplikacji. Aby umożliwić zestawOWI MIP SDK przetwarzanie plików MSG, CustomSettings właściwość FileEngineSettings obiektu służy do ustawiania flagi na enable_msg_file_type potrzeby włączania przetwarzania plików .msg.

Jeśli utworzono FileEngineSettings obiekt o nazwie engine Ustawienia należy ustawić tę właściwość na platformie .NET w następujący sposób:

engineSettings.CustomSettings = new List<KeyValuePair<string, string>>();
engineSettings.CustomSettings.Add(new KeyValuePair<string, string>("enable_msg_file_type", "true"));

Pseudokod .msg operacji ochrony plików może wyglądać następująco:

  • Ustaw enable_msg_file_type flagę w pliku mip::FileEngineSettings i dodaj element mip::FileEngine do mip::FileProfileelementu .
  • Użyj elementu , FileEngine aby pobrać listę etykiet dla użytkownika.
  • Konstrukcja mip::FileHandler wskazująca plik, który ma być oznaczony etykietą.
  • Wybierz etykietę i użyj mip::FileHandlermetody "s SetLabel ", aby zastosować etykietę.

Zapoznaj się z przewodnikiem Szybki start: wyświetlanie listy etykiet , aby uzyskać informacje na temat sposobu wyświetlania list etykiet.

Zmienianie domyślnych zachowań obsługi załączników

Domyślnie zestaw SDK plików próbuje przetworzyć wszystkie załączniki będące częścią pliku MSG lub plik message.rpmsg podczas korzystania z interfejsów API inspekcji. Nie rekursywnie odszyfrowuje załączników, które są częścią plików MSG dołączonych do głównej grupy msg. Modyfikacja domyślnego zachowania obsługi nie jest obecnie obsługiwana.

Operacje zestawu SDK plików dla plików rpmsg

Zestaw MIP SDK uwidacznia funkcję inspekcji, która umożliwia odszyfrowywanie osadzonego pliku message.rpmsg i prezentowanie zestawu strumieni bajtów jako danych wyjściowych. Do użytkownika zestawu SDK należy wyodrębnienie pliku message.rpmsg i przekazanie go do interfejsu API inspekcji. Istnieją odmiany tej nazwy pliku dla scenariuszy szyfrowania komunikatów pakietu Office, a interfejs API będzie również akceptować pliki message_v2, v3 lub v4.

Ważne

Interfejs API inspekcji nie udostępnia danych wyjściowych, które spowodują użycie pliku, ani nie umożliwia ponownej ochrony pliku wejściowego. Generuje strumienie bajtów, które aplikacja może następnie przetworzyć dalej. Ponowne tworzenie plików MSG z plików message.rpmsg nie jest obsługiwane przez zestaw MIP SDK.

Często usługi bramy poczty i ochrony przed utratą danych (DLP) obsługują komunikaty zgodne z protokołem MIME podczas przesyłania wiadomości e-mail. Gdy poczta jest chroniona, zaszyfrowana zawartość wiadomości jest przechowywana w załączniku message.rpmsg. Ten załącznik zawiera zaszyfrowaną treść wiadomości e-mail i wszelkie załączniki, które były częścią oryginalnej wiadomości. Plik rpmsg jest następnie dołączony do wiadomości e-mail otoki zwykłego tekstu i wysyłany do usługi poczty. Gdy ten komunikat opuści granicę programu Exchange lub exchange Online, będzie on w formacie zgodnym z programem MIME, aby można go było wysłać do miejsca docelowego.

W większości przypadków usługa DLP musi pobrać załączniki i bajty w postaci zwykłego tekstu z komunikatu, aby sprawdzić i ocenić zasady DLP. Interfejs API inspekcji przyjmuje parametr message.rpmsg jako dane wejściowe i zwraca strumienie bajtów jako dane wyjściowe. Te strumienie bajtów zawierają bajty zwykłego tekstu komunikatu i załączników. Deweloper aplikacji może obsługiwać te strumienie i robić z nimi coś przydatnego (inspekcja, rekursywnie odszyfrowywanie itp.).

Interfejs Inspect API jest implementowany za pomocą klasy , mip::FileInspectorktóra uwidacznia operacje inspekcji obsługiwanych typów plików. mip::MsgInspector rozszerzenie , uwidacznia operacje mip::FileInspectorodszyfrowywania specyficzne dla formatu pliku rpmsg. Zestaw MIP SDK nie obsługuje żadnych scenariuszy publikowania dla plików message.rpmsg . FileHandler::RemoveProtection() Ponadto interfejs API nie obsługuje plików message.rpmsg. Pliki Message.rpmsg można odszyfrować tylko w celu przeprowadzenia inspekcji i nie wyjadą prawidłowego, użytecznego pliku. Jeśli aplikacja wymaga danych wyjściowych pliku, musisz przekazać plik MSG i usunąć ochronę z tego obiektu.

mip::MsgInspector klasa uwidacznia poniższe elementy członkowskie:

public const std::vector<uint8_t>& GetBody()
public BodyType GetBodyType() const
public BodyType GetBodyType() const
public InspectorType GetInspectorType() const
public std::shared_ptr<Stream> GetFileStream() const

Aby uzyskać więcej informacji, zobacz dokumentację interfejsu API.

Następne kroki