Bitzsoft.Integrations.EnterpriseMail.Microsoft365 1.0.0-alpha.9

Bitzsoft.Integrations.EnterpriseMail.Microsoft365

Microsoft 365 企业邮箱集成，基于 Microsoft Graph API v1.0 实现 IEnterpriseMailProvider。

功能特性

• Microsoft Graph API v1.0，通过 OAuth 2.0 客户端凭据流认证
• 邮件操作：发送、列表、详情、搜索、删除、移动
• 文件夹管理：列表、创建、删除
• 附件管理：列表、下载
• OData $top / $skip 标准分页

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseMail.Microsoft365

PackageReference

<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Microsoft365" Version="1.0.0" />

配置

{
  "Microsoft365": {
    "TenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "ClientId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "ClientSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "DefaultUserEmail": "user@company.com"
  }
}

注册服务

// 方式一：委托配置
services.AddBitzsoftMicrosoft365Mail(options =>
{
    options.TenantId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
    options.ClientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
    options.ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
    options.DefaultUserEmail = "user@company.com";
});

// 方式二：IConfiguration 绑定
services.AddBitzsoftMicrosoft365Mail(configuration, "Microsoft365");

第三方请求日志

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftMicrosoft365Mail(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 8192;
    opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftMicrosoft365Mail(options => { /* ... */ });

使用示例

using Bitzsoft.Integrations.EnterpriseMail;
using Bitzsoft.Integrations.EnterpriseMail.Microsoft365;
using Bitzsoft.Integrations.EnterpriseMail.Models;

// 通过 DI 注入 IEnterpriseMailProvider
public class MailService
{
    private readonly IEnterpriseMailProvider _mail;

    public MailService(IEnterpriseMailProvider mail) => _mail = mail;

    public async Task<MailListResult> ListAsync()
    {
        // OData $top/$skip 分页，无需线性遍历
        return await _mail.ListMessagesAsync("inbox", pageIndex: 1, pageSize: 20);
    }

    public async Task SearchAsync(string keyword)
    {
        // Graph $search + 客户端过滤
        var result = await _mail.SearchAsync(new MailSearchRequest
        {
            Keyword = keyword,
            UnreadOnly = true,
        });
    }
}

核心类型一览

依赖

• Bitzsoft.Integrations.EnterpriseMail，企业邮箱抽象层
• Bitzsoft.Integrations.Compatibility，基础工具库
• Microsoft.Extensions.Http，命名 HttpClient 工厂

注意事项

• 使用 $top / $skip 实现分页，无需线性遍历
• Graph $search 与 $filter 不能组合使用，复杂搜索通过客户端过滤实现
• SendAsync 返回 202 Accepted，无法获取发送后的邮件 MessageId
• 使用前需在 Azure AD 中注册应用并授予 Mail.ReadWrite、Mail.Send 等权限
• Provider 名称：Microsoft365

相关包

• Bitzsoft.Integrations.EnterpriseMail — 核心抽象层
• Bitzsoft.Integrations.EnterpriseMail.Feishu — 飞书邮箱实现
• Bitzsoft.Integrations.EnterpriseMail.Alibaba — 阿里邮箱实现
• Bitzsoft.Integrations.EnterpriseMail.Tencent — 腾讯企业邮箱实现
• Bitzsoft.Integrations.EnterpriseMail.NetEase — 网易企业邮箱实现
• Bitzsoft.Integrations.EnterpriseMail.All — 全部供应商聚合包