0x00 前言 在之前的文章《Zimbra SOAP API开发指南》和《Zimbra-SOAP-API开发指南2》介绍了Zimbra SOAP API的调用方法,开源代码Zimbra_SOAP_API_Manage。本文将要在此基础上扩充功能,添加邮件操作的相关功能。 0x01 简介 本文将要介绍以下内容: 查看邮件 发送邮件 删除邮件 0x02 查看邮件 Zimbra SOAP API说明文档:https://files.zimbra.com/docs/soap_api/9.0.0/api-reference/index.html 结合Zimbra SOAP API说明文档和调试结果得出以下实现流程: 调用Search命令获得邮件对应的Item id,通过Item id作为邮件的识别标志。 获得Item id后可以对邮件做进一步操作,如查看邮件细节、移动邮件、删除邮件等。 1.获得邮件对应的Item id 需要使用Search命令。 说明文档:https://files.zimbra.com/docs/soap_api/8.8.15/api-reference/zimbraMail/Search.html 需要用到以下参数: (1)query 表示查看的位置,示例如下: (2)limit 表示返回的查询结果数量,示例如下: 如果不指定该属性,默认为10 测试代码: 返回内容示例: 对以上格式分析,发现标签 格式分析如下: 时间格式转换的示例代码: 综合以上内容,得出提取Item id、发件人、标题、正文内容和发送时间的实现代码: 2.查看邮件内容 测试发现,查看邮件细节可以不依赖Zimbra SOAP API,访问固定url即可。 通过这种方式可以获得完整的邮件内容,包括Base64编码的附件内容。 实现代码: 0x03 发送邮件 在发送带有附件的邮件时,需要先上传附件,再发送。 1.上传附件 上传功能通过FileUploadServlet实现,对应代码位置:/opt/zimbra/lib/jars/zimbrastore.jar中/com.zimbra/cs/service/FileUploadServlet.class 上传细节可参考:https://github.com/Zimbra/zm-mailbox/blob/develop/store/docs/file-upload.txt 上传的url: https:// 如果添加参数fmt=raw,extended,返回结果示例: 经过比较,发现添加参数fmt=raw,extended能够额外获得文件类型,示例:"ct":"image/jpeg" 所以在上传时,使用url: https://< url >/service/upload?fmt=raw,extended 综合以上内容,得出以下实现代码: 2.发送带有附件的邮件 需要使用SendMsg命令。 说明文档:https://files.zimbra.com/docs/soap_api/8.8.15/api-reference/zimbraMail/SendMsg.html 需要用到以下参数: (1)e 表示发件人和收件人等相关信息,示例如下: (2)su 表示邮件标题,示例如下: (3)mp 表示正文内容,示例如下: (4)noSave 如果设置为1,表示邮件发送后,不在发件箱保存副本,示例代码: (5)attach 指定发送附件的aid,示例代码: 综合以上内容,得出发送带有附件邮件的实现代码: 0x04 删除邮件 需要使用ConvAction命令。 说明文档:https://files.zimbra.com/docs/soap_api/8.8.15/api-reference/zimbraMail/ConvAction.html 需要用到以下参数: (1)tcon 通过浏览器删除邮件的流程是先点击删除邮件,将邮件移动至垃圾箱,再从垃圾箱中点击删除邮件,完成邮件的彻底删除。 通过Zimbra-SOAP-API可以简化以上流程,直接删除邮件。 实现代码: 0x05 开源代码 新的代码已上传至github,地址如下: https://github.com/3gstudent/Homework-of-Python/blob/master/Zimbra_SOAP_API_Manage.py 优化了代码结构,增加了以下功能: DeleteMail,删除指定邮件 SearchMail,获得邮箱信息,包括Item id、发件人、标题、正文内容和发送时间 SendTestMailToSelf,向当前邮箱发送一封带有附件的邮件 uploadattachment,上传附件 uploadattachmentraw,上传附件的另一种实现,用于特定条件 viewmail,查看邮件完整细节 0x06 小结 本文扩充了Zimbra SOAP API的调用方法,添加三个实用功能:查看邮件、发送邮件和删除邮件,记录实现细节。 |