Przetwarzanie pliku wiadomości e-mail zestawu SDK pliku

  • Artykuł
  • Czas czytania: 3 min

Zestaw SDK miP obsługuje odszyfrowywanie i szyfrowanie wiadomości e-mail. Oba pliki msg, generowane przez pliki Outlook lub Exchange, i pliki rpmsg są obsługiwane przez zestaw SDK, chociaż są one obsługiwane przez nieco inne metody.

Typowe przypadki użycia w tym scenariuszu to:

  • Odszyfrowywanie wiadomości e-mail i załączników na potrzeby inspekcji ochrony przed utratą danych (DLP).
  • Publikowanie chronionych wiadomości bezpośrednio z aplikacji biznesowych
  • Odszyfrowywanie, modyfikowanie i ponowne chroninie przesyłanych wiadomości.
  • Stosowanie etykiet do wiadomości e-mail z usługi DLP lub bramy poczty.

Oświadczenie o pomocy technicznej dla plików MSG

Zestaw MIP SDK obsługuje aplikację ochrony i usuwanie plików MSG. Ze względu na różne typy kodowania i zmienne w formacie na przestrzeni lat nie można zagwarantować, że zestaw SDK programu MIP będzie w stanie usunąć ochronę wszystkich plików MSG. W poniższej sekcji opisano możliwości obsługi plików MSG z różnych źródeł.

  • Ochrona plików MSG, które były chronione za pomocą zestawu SDK MIP, jest w pełni obsługiwana.
  • Usunięcie ochrony plików MSG utworzonych przez obecnie obsługiwane wersje klienta Outlook jest w pełni obsługiwane.
  • Usuwanie ochrony plików MSG utworzonych za pomocą nieoparzysłych wersji klienta Outlook jest obsługiwane według najlepszych starań, ale bez względu na to.

Oznaczanie plików MSG

Począwszy od zestawu MIP SDK 1.10,czytanie i pisanie etykiet w plikach MSG jest obsługiwane. Załączniki podrzędne nie odziedziczą etykiety, ale odziedziczą ustawienia ochrony. Aby uzyskać dodatkowe informacje, zapoznaj się z tematem Operacje oznaczania etykiet i ochrony w zestawie SDK pliku dla plików msg.

Operacje oznaczania i ochrony w zestawie SDK pliku dla plików msg

Zestaw SDK plików obsługuje operacje oznaczania i ochrony dla plików msg w sposób identyczny z każdym innym typem pliku, z tym że zestaw SDK potrzebuje aplikacji do włączenia flagi funkcji MSG.

Jak wspomniano wcześniej, aby utworzyć mip::FileEngine wystąpienia, należy utworzyć obiekt ustawień, mip::FileEngineSettings . mip::FileEngineSettings mogą być używane do przekazywać parametry ustawień niestandardowych w celu zaspokojenia konkretnych potrzeb aplikacji. Aby umożliwić przetwarzanie plików MSG za pomocą zestawu SDK programu MIP, jest używana właściwość obiektu w celu umożliwienia przetwarzania CustomSettingsFileEngineSettings plików enable_msg_file_type msg.

Operacja .msg na ochronie plików kodem może wyglądać tak:

  • Ustaw enable_msg_file_type flagę mip::FileEngineSettings w i dodaj mip::FileEngine do mip::FileProfile .
  • Użyj narzędzia FileEngine do zdalnego dostępu do listy etykiet dla użytkownika.
  • mip::FileHandlerKonstruowanie wskazuje plik, który ma zostać oznaczony etykietą.
  • Wybierz etykietę i zastosuj mip::FileHandler ją SetLabel za pomocą metody.

Zobacz Szybki start: Lista etykiet, aby uzyskać informacje na temat sposobu etykiet listy.

Operacje zestawu SDK plików dla plików rpmsg

Zestaw SDK protokołu MIP udostępnia funkcję inspekcji, która może odszyfrowywać osadzony plik message.rpmsg i prezentować jako wynik zestaw strumieni bajtów. Wyodrębnianie pliku message.rpmsg i przesłanie go do interfejsu API inspekcji należy do klienta zestawu SDK. Odmiany tej nazwy pliku istnieją dla scenariuszy szyfrowania Office wiadomości, a interfejs API będzie również akceptował pliki message_v2, v3 lub v4.

Ważne

Interfejs API inspekcji nie zawiera danych wyjściowych, które spowoduje, że plik będzie użyteczny, ani nie umożliwia ponownej ochrony pliku wejściowego. Wyprowadza strumienie bajtów, które aplikacja może następnie przetwarzać. Ponowne tworzenia plików MSG z pliku message.rpmsg nie jest obsługiwane przez zestaw MIP SDK.

Zazwyczaj usługi bramy poczty i ochrony przed utratą danych (DLP, data loss prevention) obsługują wiadomości zgodne z standardem MIME podczas przesyłania poczty 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 oraz wszystkie załączniki, które stanowiły część oryginalnej wiadomości. Plik rpmsg zostanie dołączony do wiadomości e-mail zwykłego tekstu zawijacza i wysyłany do usługi poczty. Wiadomość, która opuszcza Exchange lub Exchange Online, jest w formacie zgodnym z miME, dzięki czemu może zostać wysłana do miejsca docelowego.

W większości przypadków usługa DLP wymaga dostępu do załączników i bajtów zwykłego tekstu wiadomości w celu inspekcji i oceny pod względem zasad DLP. Interfejs API inspekcji pobiera wartość message.rpmsg jako dane wejściowe i zwraca strumienie bajtów jako dane wyjściowe. Te strumienie bajtowe zawierają zwykły tekst wiadomości i załączników. To deweloper aplikacji może obsługiwać te strumienie i zrobić coś przydatnego (inspekcję, odszyfrowywanie cykliczne itp.).

Interfejs Inspect API jest implementowane za pośrednictwem klasy, która udostępnia operacje inspekcji mip::FileInspector obsługiwanych typów plików. mip::MsgInspector która rozszerza mip::FileInspector , udostępnia operacje odszyfrowywania specyficzne dla formatu pliku rpmsg. Zestaw SDK programu MIP nie obsługuje żadnych scenariuszy publikowania plików message.rpmsg. Ponadto interfejs FileHandler::RemoveProtection() API nie obsługuje plików message.rpmsg. Pliki Message.rpmsg można odszyfrowywać tylko w celu inspekcji i nie spowoduje wyprowadzić prawidłowego, możliwego do użycia pliku. Jeśli aplikacja wymaga pliku wyjściowego, należy przekazać plik MSG i usunąć ochronę tego obiektu.

mip::MsgInspector class exposes below members:

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 szczegółowych informacji, zobacz Dokumentacja interfejsu API.

Następne kroki