Outlook MAPI开发指南
作者：互联网
3gstudent 嘶吼专业版
0x00 前言
Outlook MAPI提供了一组访问Outlook的接口，用来扩展Outlook应用程序的开发，本文将会介绍Outlook MAPI的基本用法，开源一份Outlook MAPI的实现代码mapi_tool，便于后续的二次开发。
0x01 简介
本文将要介绍以下内容：
· 基本知识
· 使用Outlook MAPI访问Outlook资源
· 开源代码mapi_tool
· mapi_tool功能介绍
· 多种环境下的利用思路
0x02 基本知识
参考资料：
https://docs.microsoft.com/en-us/office/client-developer/outlook/mapi/outlook-mapi-reference
Outlook MAPI的使用前提：需要安装Outlook客户端。
Outlook MAPI同EWS的区别：
· Outlook MAPI用来访问Outlook客户端中的资源
· EWS用来访问Exchange服务器中的资源
关于EWS的使用可以参考之前的文章《Exchange Web Service(EWS)开发指南》。
Outlook客户端中的用户邮件存储在后缀名为ost的文件中，和Exchange服务器中的数据库保持一致
ost文件的默认保存位置：%LOCALAPPDATA%\Microsoft\Outlook\
MAPI主要包括以下三个功能：
· Address Books，设置E-mail type、protocol等参数
· Transport，文件的发送和接收
· Message Store，发送接收等信息的处理
0x03 使用Outlook MAPI访问Outlook资源
1.安装Outlook客户端并配置参数
2.启动Outlook客户端进行用户登录
3.使用C Sharp开发程序，实现读取收件箱邮件的功能
参考资料：
https://docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.outlook?view=outlook-pia
https://docs.microsoft.com/en-us/office/vba/api/outlook.namespace
开发环境：VS2015
新建工程，选择控制台应用程序，引用文件：Microsoft.Office.Interop.Outlook.dll
注：
安装Outlook客户端后，可在C:\Windows\assembly\GAC_MSIL\Microsoft.Office.Interop.Outlook\下获得Microsoft.Office.Interop.Outlook.dll。
Microsoft.Office.Interop.Outlook.dll要同Outlook的版本保持一致。
Microsoft.Office.Interop.Outlook.dll的文件属性-Details-Product name对应支持Outlook的版本，Product version对应具体的Outlook版本，如下图：
Product version对应具体的Outlook版本可参考：
https://docs.microsoft.com/en-us/Exchange/new-features/build-numbers-and-release-dates?redirectedfrom=MSDN&view=exchserver-2019
C Sharp代码示例：
using System;
using Microsoft.Office.Interop.Outlook;
namespace ConsoleApplication3
{
class Program
{
static void Main(string[] args)
{
Microsoft.Office.Interop.Outlook.Application app = new Microsoft.Office.Interop.Outlook.Application();
Microsoft.Office.Interop.Outlook.NameSpace ns = app.GetNamespace("MAPI");
Microsoft.Office.Interop.Outlook.MAPIFolder inbox = ns.GetDefaultFolder(Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox);
Microsoft.Office.Interop.Outlook.Items items = inbox.Items;
Console.WriteLine("Size:" + inbox.Items.Count);
foreach (var item in items)
{
var mail = item as Microsoft.Office.Interop.Outlook.MailItem;
if (mail != null)
{
if(mail.UnRead==true)
Console.WriteLine("[+] UnRead Mail");
else
Console.WriteLine("[+] Mail");
Console.WriteLine("[*] Subject:" + mail.Subject);
Console.WriteLine("[*] From:" + mail.SenderName);
Console.WriteLine("[*] To:" + mail.To);
Console.WriteLine("[*] CC:" + mail.CC);
Console.WriteLine("[*] ReceivedTime:" + mail.ReceivedTime);
if(mail.Attachments.Count>0)
{
Console.WriteLine("[>] Attachments:" + mail.Attachments.Count);
Microsoft.Office.Interop.Outlook.Attachments attachments = mail.Attachments;
foreach (Microsoft.Office.Interop.Outlook.Attachment att in attachments)
{
Console.WriteLine(" Name:" + att.FileName);
}
}
Console.WriteLine("[*] Body:\r\n" + mail.Body);
Console.WriteLine("[*] OutlookVersion:" + mail.OutlookVersion);
Console.WriteLine("[*] EntryID:" + mail.EntryID);
}
}
}
}
}
代码执行后将会列举收件箱中的邮件，输出以下内容：
· 收件箱邮件个数
· 是否已读
· 主题
· 发件人
· 收件人
· 抄送
· 接收时间
· 附件名称
· 正文内容
· Outlook版本
· EntryID
代码执行后，Outlook客户端会弹出警告，如下图：
选择允许后，成功获得收件箱信息，如下图：
弹出警告的原因：当前系统的防病毒软件处于非活动状态或过期。
参考资料：
https://support.microsoft.com/en-us/help/3189806/a-program-is-trying-to-send-an-e-mail-message-on-your-behalf-warning-i
两种关闭方法：
1.开启并更新防病毒软件
2.修改注册表关闭警告
注册表位置：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\
64位操作系统安装32位Office的注册表位置：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office\
注册表项：ObjectModelGuard，类型：REG_DWORD，值为2。
在使用时需要注意的细节如下：
1.引用的Microsoft.Exchange.WebServices.dll要与Outlook客户端的版本保持一致
2.默认配置下，部分操作不会弹出警告
例如：
· 列出收件箱邮件个数
· 列出邮件主题
· 列出邮件接收时间
· 列出邮件附件名称
3.如果后台没有运行Outlook客户端
通过程序可读取当前Outlook客户端中的资源，但是获取资源后还会弹框提示要求输入凭据，如下图：
如果选择了记住凭据，那么后续操作不会要求输入凭据，关于凭据的使用可以参考之前的文章《***技巧——Windows中Credential Manager的信息获取》。
0x04 开源实现代码mapi_tool
代码地址：https://github.com/3gstudent/Homework-of-C-Sharp/blob/master/mapi_tool.cs
在编译上面，为了增加通用性，代码支持使用csc.exe进行编译，
支持.Net 3.5或更高版本，编译命令：
C:\Windows\Microsoft.NET\Framework64\v3.5\csc.exe mapi_tool.cs /r:Microsoft.Office.Interop.Outlook.dll
or
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe mapi_tool.cs /r:Microsoft.Office.Interop.Outlook.dll
为了便于测试，我上传了Office2010下的Microsoft.Office.Interop.Outlook.dll和Office2013下的Microsoft.Office.Interop.Outlook.dll
在功能实现上，对是否弹出安全提示做了区分，
不会弹出安全提示的功能：
· 获得所有文件夹中的邮件长度
· 获得配置信息，包括CurrentProfileName、ExchangeMailboxServerName、ExchangeMailboxServerVersion
· 列出指定位置的邮件，包括邮件主题、接收时间、附件中的文件名称和EntryID
· 列出指定位置的未读邮件，包括邮件主题、接收时间、附件中的文件名称和EntryID
会弹出安全提示的功能：
· 获得配置信息，包括Account-DisplayName、Account-SmtpAddress、Account-AutoDiscoverXml、Account-AccountType
· 获得联系人信息
· 获得GlobalAddress
· 列出指定位置的邮件，包括邮件主题、发件人、收件人、抄送、接收时间、附件中的文件名称、正文内容、Outlook版本和EntryID
· 列出指定位置的未读邮件，包括邮件主题、发件人、收件人、抄送、接收时间、附件中的文件名称、正文内容、Outlook版本和EntryID
· 保存指定邮件中的附件
在代码开发上，需要注意以下细节：
1.保存附件时需要使用绝对路径
2.获得联系人列表时，数组开始的位置为1，而不是0
3.获得配置信息时，数组开始的位置为1，而不是0
0x05 多种环境下的利用思路
1.正在运行Outlook客户端
通过mapi_tool可以对Outlook客户端的资源进行访问，某些操作有可能会弹出安全提示。
关闭安全提示的两种方法：
· 开启并更新防病毒软件
· 修改注册表关闭警告
导出Outlook客户端所有邮件信息的方法：
(1)获得ost文件
ost文件的默认保存位置：%LOCALAPPDATA%\Microsoft\Outlook\
无法直接复制，提示文件被占用。
可以使用Joe Bialek的NinjaCopy复制被占用的文件。
(2)将ost文件转换成pst文件
工具有很多，这个提供一种：Advanced Exchange Recovery
(3)将pst文件导入Outlook客户端
2.没有启动Outlook客户端
通过mapi_tool可以对Outlook客户端的资源进行访问，某些操作有可能会弹出安全提示。
如果执行需要同服务器进行交互的操作，例如获取配置信息，会弹框提示要求输入凭据，如果凭据管理器已经存储了对应的凭据，就不会弹框提示。
查看已保存凭据的命令：
cmdkey /list
导出Outlook客户端所有邮件信息的方法：
(1)获得ost文件
可直接复制ost文件。
(2)将ost文件转换成pst文件
方法同上。
(3)将pst文件导入Outlook客户端
方法同上。
0x06 小结
本文介绍了使用Outlook MAPI访问Outlook资源的方法，开源代码mapi_tool，便于后续的二次开发。
标签：指南,Outlook,Office,Interop,MAPI,mail,Microsoft,客户端 来源： https://blog.51cto.com/u_15127538/2698207