Sdílet prostřednictvím

Zpracování souborů e-mailové zprávy sady SDK

  • Článek

Sada MIP SDK podporuje dešifrování a šifrování e-mailových zpráv. Sada SDK podporuje soubory .msg vygenerované outlookem nebo Exchangem i soubory .rpmsg, i když mírně odlišnými metodami.

Mezi běžné případy použití pro tento scénář patří:

  • Dešifrování pošty a příloh pro kontrolu ochrany před únikem informací
  • Publikování chráněných zpráv přímo z obchodních aplikací
  • Dešifrujte, upravujte a znovu chraňte zprávy během přenosu.
  • Použití popisků u e-mailů ze služeb ochrany před únikem informací nebo služby poštovní brány

Příkaz podpory souborů MSG

Sada MIP SDK podporuje aplikaci ochrany a odebrání souborů MSG. Vzhledem k nejrůznějším typům kódování a proměnným ve formátu v průběhu let není možné zaručit, že sada MIP SDK může odebrat ochranu ze všech souborů MSG. Následující část popisuje podporu pro soubory MSG z různých zdrojů.

  • Odebrání ochrany ze souborů MSG chráněných sadou MIP SDK je plně podporované.
  • Odebrání ochrany ze souborů MSG vytvořených aktuálně podporovanými verzemi klienta Outlooku je plně podporováno.
  • Odebrání ochrany ze souborů MSG vytvořených verzemi mimo podporu klienta Outlooku je podporováno na základě maximálního úsilí.
  • Opětovná ochrana souborů MSG není u chráněných popisků k dispozici. Uživatelé musí před opětovnou ochranou souboru pomocí jiného popisku odemknout chráněný popisek a odebrat ho explicitně.

Označování souborů MSG

Sada MIP SDK podporuje čtení a zápis popisků u souborů MSG. Podřízené přílohy nezdědí popisek, ale dědí nastavení ochrany. Další podrobnosti najdete v souborové sadě SDK pro operace popisování a ochrany .msg souborů .

Operace popisování a ochrany v sadě File SDK pro soubory .msg

Sada File SDK podporuje operace označování a ochrany pro soubory .msg způsobem identickým s jakýmkoli jiným typem souboru, s tím rozdílem, že sada SDK potřebuje aplikaci k povolení příznaku funkce MSG.

Jak bylo popsáno dříve, vytvoření instance FileEngine vyžaduje objekt nastavení, FileEngineSettings. FileEngineSettings lze použít k předání parametrů pro vlastní nastavení tak, aby vyhovovala konkrétním potřebám aplikace. Pokud chcete sadě MIP SDK povolit zpracování souborů MSG, CustomSettings vlastnost objektu FileEngineSettings se používá k nastavení příznaku pro enable_msg_file_type povolení zpracování .msg souborů.

Pokud jste vytvořili FileEngineSettings objekt s názvem engineSettings, nastavili byste tuto vlastnost v .NET následujícím způsobem:

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

Pseudokód .msg operací ochrany souborů může vypadat takto:

  • Nastavte enable_msg_file_type příznak a mip::FileEngineSettings přidejte do mip::FileEngine souboru mip::FileProfile.
  • FileEngine Použijte k načtení seznamu popisků pro uživatele.
  • Konstrukce mip::FileHandler , která odkazuje na soubor, který má být označen.
  • Vyberte popisek a použijte metodu mip::FileHandler's SetLabel k použití popisku.

Projděte si rychlý start: Seznam popisků s informacemi o tom, jak vypsat popisky .

Změna výchozího chování zpracování příloh

Sada File SDK se ve výchozím nastavení pokusí zpracovat všechny přílohy, které jsou součástí souboru MSG, nebo soubor message.rpmsg při použití kontrolních rozhraní API. Nerekurzivně dešifruje přílohy, které jsou součástí souborů MSG připojených ke kořenovému msG. Úpravy výchozího chování zpracování se v tuto chvíli nepodporují.

Operace sady File SDK pro soubory .rpmsg

Sada MIP SDK zveřejňuje kontrolní funkci, která může dešifrovat vložený soubor message.rpmsg a prezentovat sadu bajtů streamů jako výstup. Je na příjemci sady SDK, aby extrahovali soubor message.rpmsg a předali ho do kontrolního rozhraní API. Existují varianty tohoto názvu souboru pro scénáře šifrování zpráv Office a rozhraní API také přijme soubory message_v2, v3 nebo v4.

Důležité

Rozhraní API pro kontrolu neposkytuje výstup, který bude mít za následek použitelný soubor, ani neumožňuje znovu chránit vstupní soubor. Výstupem jsou datové proudy bajtů, které pak vaše aplikace může dále zpracovat. Sada MIP SDK nepodporuje opětovné vytvoření souborů MSG ze souborů message.rpmsg .

Služby ochrany před únikem informací (DLP) obvykle zpracovávají zprávy kompatibilní s MIME při přenosu e-mailu. Když je pošta chráněná, zašifrovaný obsah zprávy se uloží do přílohy message.rpmsg. Tato příloha obsahuje šifrovaný text e-mailu a všechny přílohy, které byly součástí původní zprávy. Soubor rpmsg se pak připojí k e-mailu obálky prostého textu a odešle se do poštovní služby. Jakmile tato zpráva opustí hranice Exchange nebo Exchange Online, je ve formátu kompatibilním s MIME, aby bylo možné ji odeslat do cíle.

Ve většině případů potřebuje služba ochrany před únikem informací získat přílohy a bajty prostého textu ze zprávy, aby bylo možné kontrolovat a vyhodnocovat zásady ochrany před únikem informací. Rozhraní API pro kontrolu přebírá jako vstup message.rpmsg a vrací jako výstup datové proudy bajtů. Tyto bajtové datové proudy obsahují bajty prostého textu zprávy a přílohy. Je na vývojáři aplikace, aby tyto streamy zvládl a udělal s nimi něco užitečného (prověřovat, rekurzivně dešifrovat atd.).

Rozhraní Inspect API se implementuje prostřednictvím třídy, mip::FileInspectorkterá zveřejňuje operace pro kontrolu podporovaných typů souborů. mip::MsgInspector který rozšiřuje mip::FileInspector, zveřejňuje dešifrovací operace specifické pro formát souboru rpmsg. Sada MIP SDK nepodporuje žádné scénáře publikování souborů message.rpmsg . Kromě toho FileHandler::RemoveProtection() rozhraní API nepodporuje soubory message.rpmsg. Soubory Message.rpmsg lze dešifrovat pouze pro kontrolu a nebudou výstupem platného použitelného souboru. Pokud vaše aplikace vyžaduje výstup souboru, musíte předat soubor MSG a odebrat ochranu z daného objektu.

mip::MsgInspector třída zveřejňuje následující členy:

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

Další informace naleznete v sadě Microsoft Information Protection (MIP) SDK pro jazyk C++: Referenční informace.

Další kroky