py-ews Docker镜像文档

镜像概述

py-ews Docker镜像是一个集成了Python EWS（Exchange Web Services）客户端库的容器化解决方案，旨在简化与Microsoft Exchange Web Services和Office 365的交互过程。该镜像基于Python环境构建，预装了必要的依赖库，可直接用于开发或部署与Exchange/Office 365相关的自动化任务。

核心功能与特性

• 简化EWS交互：封装Exchange Web Services API，提供简洁的Python接口，降低与Exchange服务器交互的复杂度
• Office 365兼容：支持与Office 365服务的集成，兼容现代认证机制
• Python环境集成：基于官方Python镜像构建，包含完整的Python运行时环境及依赖管理
• 轻量级设计：优化镜像体积，仅包含核心功能组件，适合容器化部署

使用场景

• 邮件自动化处理（如批量发送、接收、解析邮件）
• 日历事件管理（创建、更新、查询日历项）
• 联系人信息同步与管理
• Exchange/Office 365相关的自动化脚本运行环境
• 开发与测试Exchange Web Services客户端应用

使用方法

镜像拉取

docker pull demisto/py-ews:latest

注：实际镜像名称可能需根据官方仓库调整，建议通过GitHub资源页获取最新镜像标签

基本运行示例

docker run -it --rm demisto/py-ews python -c "import pyews; print('py-ews library version:', pyews.__version__)"

典型应用示例

以下示例展示如何在容器中运行一个简单的邮件查询脚本：

1. 创建本地脚本文件（如ews_mail_query.py）：

from pyews import EWSConnection

# 配置连接参数
ews_url = "[***]"
username = "***"
password = "your_password"

# 建立连接
conn = EWSConnection(ews_url, username, password)

# 查询收件箱最新邮件
messages = conn.get_messages(folder='inbox', count=5)
for msg in messages:
    print(f"Subject: {msg.subject}, Sender: {msg.sender}")

2. 挂载脚本并运行容器：

docker run -it --rm -v $(pwd)/ews_mail_query.py:/app/script.py demisto/py-ews python /app/script.py

配置说明

环境变量

可通过环境变量配置常用连接参数（根据实际库支持情况调整）：

• EWS_URL：Exchange Web Services端点URL（默认：[***]）
• EWS_USERNAME：认证用户名
• EWS_PASSWORD：认证密码
• EWS_VERSION：EWS协议版本（如Exchange2016）

持久化配置

如需持久化配置文件，可挂载外部配置目录：

docker run -it --rm -v $(pwd)/config:/app/config demisto/py-ews python /app/script.py

参考资源

• 镜像源码及Dockerfile：GitHub - demisto/content/py-ews
• py-ews库文档：请参考镜像内置库文档或官方Python包说明