Dosya SDK'sı e-posta iletisi dosyası işleme

  • Makale

MIP SDK,e-posta iletileri için şifre çözmeyi ve şifrelemeyi destekler. Hem Outlook veya Exchange tarafından oluşturulan .msg dosyaları hem de .rpmsg dosyaları SDK tarafından desteklenir ancak biraz farklı yöntemlerle desteklenir.

Bu senaryo için yaygın kullanım örnekleri şunlardır:

  • Veri kaybı önleme (DLP) incelemesi için posta ve eklerin şifresini çözme.
  • Korumalı iletileri doğrudan iş kolu uygulamalarından yayımlama
  • Aktarımdaki iletilerin şifresini çözme, değiştirme ve yeniden koruma.
  • DLP veya posta ağ geçidi hizmetlerinden gelen e-postalara etiket uygulama.

MSG Dosya Destek Bildirimi

MIP SDK'sı, MSG dosyaları için koruma uygulamasını ve kaldırılmasını destekler. Yıllar içinde çeşitli kodlama türleri ve değişkenleri göz önünde bulundurulduğunda, MIP SDK'sının tüm MSG dosyalarından korumayı kaldırabileceğini garanti etmek mümkün değildir. Aşağıdaki bölümde çeşitli kaynaklardan GELEN MSG dosyaları için desteklenebilirlik açıklanmaktadır.

  • MIP SDK ile korunan MSG dosyalarından korumanın kaldırılması tam olarak desteklenir.
  • Outlook istemcisinin şu anda desteklenen sürümleri tarafından oluşturulan MSG dosyalarından korumanın kaldırılması tam olarak desteklenir.
  • Outlook istemcisinin destek dışı sürümleri tarafından oluşturulan MSG dosyalarından korumanın kaldırılması en iyi çaba temelinde desteklenir.
  • MSG dosyalarının yeniden korunması korumalı etiketlerle kullanılamaz. Kullanıcılar, dosyayı başka bir etiketle yeniden korumadan önce korumalı etiketin korumasını kaldırmalı ve açıkça kaldırmalıdır.

MSG Dosyalarını Etiketleme

MIP SDK'sı, MSG dosyalarında etiket okumayı ve yazmayı destekler. Alt ekler etiketi devralmaz, ancak koruma ayarlarını devralır. Daha fazla ayrıntı için dosya .msg için Dosya SDK'sında Etiketleme ve Koruma İşlemleri'ni gözden geçirin.

.msg dosyaları için Dosya SDK'sında Etiketleme ve Koruma İşlemleri

Dosya SDK'sı, .msg dosyalar için etiketleme ve koruma işlemlerini, SDK'nın MSG özellik bayrağını etkinleştirmek için uygulamaya ihtiyacı olması dışında diğer tüm dosya türleriyle aynı şekilde destekler.

Daha önce açıklandığı gibi örneği FileEngine için bir ayarlar nesnesi gerekir. FileEngineSettings FileEngineSettings belirli uygulama gereksinimlerini karşılamak üzere özel ayarların parametrelerini geçirmek için kullanılabilir. MIP SDK'sının MSG dosyalarını işlemesini etkinleştirmek için nesnesinin FileEngineSettings özelliği, CustomSettings .msg dosyalarının işlenmesini etkinleştirmek üzere bayrağını ayarlamak için enable_msg_file_type kullanılır.

Altyapı adlı bir FileEngineSettings nesne oluşturduysanız Ayarlar bu özelliği .NET'te aşağıdaki gibi ayarlarsınız:

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

.msg dosya koruma işlemleri sözde kodu şöyle görünebilir:

  • bayrağını mip::FileEngineSettings ayarlayın enable_msg_file_type ve öğesine mip::FileEnginemip::FileProfileekleyin.
  • Kullanıcının etiket listesini getirmek için öğesini FileEngine kullanın.
  • mip::FileHandler Etiketlenecek dosyaya işaret eden yapı.
  • Bir etiket seçin ve etiketi uygulamak için 'nin SetLabel yöntemini kullanınmip::FileHandler.

Etiketleri listeleme hakkında bilgi için Hızlı Başlangıç: Liste etiketleri bölümüne bakın.

Varsayılan Ek İşleme Davranışlarını Değiştirme

Varsayılan olarak, Dosya SDK'sı inceleme API'lerini kullanırken bir MSG dosyasının veya message.rpmsg dosyasının parçası olan tüm ekleri işlemeye çalışır. Kök MSG'ye bağlı MSG dosyalarının parçası olan eklerin şifresini yinelemeli olarak çözmez. Varsayılan işleme davranışının değiştirilmesi şu anda desteklenmiyor.

.rpmsg dosyaları için Dosya SDK'sı işlemleri

MIP SDK, embedded message.rpmsg dosyasının şifresini çözebilen ve çıkış olarak bir bayt akışı kümesi sunabilen bir inceleme işlevi sunar. message.rpmsg dosyasını ayıklamak ve inceleme API'sine geçirmek SDK tüketicisine bağlı. Office İleti Şifrelemesi senaryolarında bu dosya adının çeşitlemeleri vardır ve API message_v2, v3 veya v4 dosyalarını da kabul eder.

Önemli

Denetleme API'si kullanılabilir bir dosyayla sonuçlanacak bir çıkış sağlamaz ve giriş dosyasını yeniden korumanıza izin vermez. Uygulamanızın daha sonra işleyebileceği bayt akışlarını oluşturur. MSG dosyalarını message.rpmsg dosyalarından yeniden oluşturma IŞLEMI MIP SDK'sı tarafından desteklenmez.

Genellikle posta ağ geçidi ve veri kaybı önleme (DLP) hizmetleri, e-posta aktarılırken MIME uyumlu iletileri işler. Posta korunduğunda, iletinin şifrelenmiş içeriği message.rpmsg ekinde depolanır. Bu ek, şifrelenmiş e-posta gövdesini ve özgün iletinin parçası olan ekleri içerir. Rpmsg dosyası daha sonra düz metin sarmalayıcı e-postasına eklenir ve posta hizmetine gönderilir. Bu ileti Exchange veya Exchange Online sınırından ayrıldıktan sonra, hedefine gönderilebilmesi için MIME uyumlu biçimde olur.

Çoğu durumda DLP hizmetinin DLP ilkelerini incelemek ve değerlendirmek için iletiden ekleri ve düz metin baytlarını alması gerekir. İnceleme API'si message.rpmsg dosyasını giriş olarak alır ve bayt akışlarını çıkış olarak döndürür. Bu bayt akışları, iletinin ve eklerin düz metin baytlarını içerir. Bu akışları işlemek ve bunlarla yararlı bir şey yapmak (inceleme, özyinelemeli olarak şifre çözme vb.) uygulama geliştiricisine bağlıdır.

Inspect API, mip::FileInspectordesteklenen dosya türlerini incelemek için işlemleri kullanıma sunan bir sınıfı aracılığıyla uygulanır. mip::MsgInspector genişletir mip::FileInspector, rpmsg dosya biçimine özgü şifre çözme işlemlerini kullanıma sunar. MIP SDK'sı message.rpmsg dosyaları için yayımlama senaryolarını desteklemez. Ayrıca API, FileHandler::RemoveProtection() message.rpmsg dosyalarını desteklemez. Message.rpmsg dosyalarının şifresi yalnızca inceleme için çözülebilir ve geçerli, kullanılabilir bir dosya çıkışı vermez. Uygulamanız bir dosya çıkışı gerektiriyorsa, bir MSG dosyası geçirmeniz ve bu nesneden korumayı kaldırmanız gerekir.

mip::MsgInspector sınıfı aşağıdaki üyeleri kullanıma sunar:

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

Daha fazla bilgi için bkz . API başvurusu.

Sonraki Adımlar