csmallwood1/o365-middleware-remote

Citrix Workspace Microapps O365集成中间件示例

本镜像提供了将Microsoft Office 365集成到Citrix Workspace的示例代码，基于Flask构建多租户中间件服务，实现O365与Citrix Workspace Microapps的无缝对接。

核心功能

• 实时体验：通过Microsoft Graph事件订阅和Microapps webhook实现近实时同步
• 多租户支持：可同时服务多个Citrix Workspace和O365环境
• 日历功能：
  • 查看未来7天的日历和事件
  • 会议提醒通知
  • 直接从Workspace加入虚拟会议
  • 新会议请求通知及响应（接受/暂定/拒绝）
  • 删除会议事件
  • 直接访问网页版Outlook事件
• 邮件功能：
  • 未读高优先级邮件通知
  • 未读经理邮件通知
  • 直接访问网页版Outlook邮件
  • 发送邮件

使用场景

适用于企业用户在Citrix Workspace中统一管理O365日历和邮件，提升办公协作效率，减少切换不同应用的成本。

配置说明

前提条件

• 拥有Citrix Workspace及Microapp权限（可参考开发者指南获取免费开发者实例）
• Office 365账号（可通过Microsoft 365开发者计划获取测试实例）
• Azure Active Directory（AAD）管理员权限
• 可公开访问的主机用于部署Flask中间件

部署步骤

1. 克隆代码仓库

bash
git clone https://github.com/robertbreker/microapps-middleware-sample-o365.git

2. 部署中间件（示例Docker运行命令）

bash
cd microapps-middleware-sample-o365
docker build -t csmallwood1/o365-middleware-remote .
docker run -d -p 5000:5000 --name o365-middleware csmallwood1/o365-middleware-remote

3. 在Azure Portal配置应用客户端
   • 进入AAD应用注册
   • 新建注册，填写名称（如"microapps-middleware-sample-o365"）
   • 记录"应用（客户端）ID"
   • 生成客户端密钥并记录其值
4. 配置API权限
   • 添加Microsoft Graph应用权限：Calendars.Read、Mail.Read、User.Read.All
   • 添加Microsoft Graph delegated权限：Calendars.ReadWrite、Mail.Send
5. 配置认证重定向URI
   • 添加两个重定向URI：
     • https://..iws.cloud.com/app/api/auth/serviceAction/callback
     • https://..iws.cloud.com/admin/api/gwsc/auth/serverContext
6. 导入集成包到Citrix Workspace
   • 登录Citrix Cloud，进入Microapps管理界面
   • 导入SampleO365Middleware.service.mapp文件
   • 配置客户端ID和密钥，完成认证
   • 设置webhook监听器和数据加载参数

设计说明

中间件（app.py）作为Microapps与Microsoft Graph的桥梁，实现以下流程：

• Microapps处理源系统（SoR）认证
• 中间件定期通过Microapps的数据端点获取有效令牌并缓存
• 中间件为每个用户订阅Graph事件（每24小时 renewal）
• 收到Graph事件回调后，中间件获取相关数据并转发给Microapps
• 服务操作通过中间件传递到源系统