Sdílet prostřednictvím

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

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.

Poznámka:

Od verze MIP SDK 1.17 se podporují .eml soubory. Zpracování se podobá .msg pro scénáře popisování/ochrany a .rpmsg pro scénáře kontroly v závislosti na formátu kontejneru.

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 v operacích popisování a ochrany pro .msg soubory .

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. Ve výchozím nastavení se dešifrují pouze položky kořenové úrovně a první úroveň příloh.

Chcete-li toto chování upravit, lze použít vlastní nastavení container_decryption_option. V jazyce C++ se zobrazí prostřednictvím výčtu mip::ContainerDecryptionOption.

Název možnosti Popis
All Dešifruje soubor MSG a přílohy. Pokud je příloha msG, rekurzivně dešifruje msG a její přílohy. Před vyvoláním se vrátí maximálně deset úrovní. mip::BadInputError("Max depth reached on nested msg attachments")
Default Stejné jako Msg.
Msg Dešifruje MSG a přílohy první úrovně. Nerekurzivně dešifruje připojené soubory MSG.
Top Dešifrujte pouze soubor MSG a nešifrujte přílohy.

Následující příklad ukazuje, jak nastavit aplikaci v .NET pro dešifrování pouze kořenového souboru MSG.

engineSettings.CustomSettings.Add(new KeyValuePair<string, string>("container_decryption_option", "Top"));

A v jazyce C++:

vector<pair<string, string>> customSettings;
customSettings.emplace_back(mip::GetCustomSettingContainerDecryptionOption(),
        mip::ContainerDecryptionOptionString(mip::ContainerDecryptionOption::Top));
engineSettings.SetCustomSettings(customSettings);

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. Varianty tohoto názvu souboru existují pro scénáře šifrování zpráv Purview a rozhraní API také přijme soubory message_v2, v3 nebo v4.

Important

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 .

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

  • Last updated on