Outlook MAPI开发指南

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版本，如下图

Alt text

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客户端会弹出警告，如下图

Alt text

选择允许后，成功获得收件箱信息，如下图

Alt text

弹出警告的原因：当前系统的防病毒软件处于非活动状态或过期

参考资料：

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\<x.0>\Outlook\Security

64位操作系统安装32位Office的注册表位置：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office\<x.0>\Outlook\Security

<x.0>同Office的版本保持一致，例如Office2010的值为14.0，Office2013的值为15.0

注册表项：ObjectModelGuard，类型：REG_DWORD，值为2

在使用时需要注意的细节如下：

1.引用的Microsoft.Exchange.WebServices.dll要与Outlook客户端的版本保持一致

2.默认配置下，部分操作不会弹出警告

例如：

  • 列出收件箱邮件个数
  • 列出邮件主题
  • 列出邮件接收时间
  • 列出邮件附件名称

3.如果后台没有运行Outlook客户端

通过程序可读取当前Outlook客户端中的资源，但是获取资源后还会弹框提示要求输入凭据，如下图

Alt text

如果选择了记住凭据，那么后续操作不会要求输入凭据，关于凭据的使用可以参考之前的文章《渗透技巧——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，便于后续的二次开发。

LEAVE A REPLY

Written on April 17, 2020