为GitLab配置Microsoft Graph作为邮件收发工具

先决条件

---

1. Microsoft/Office 365订阅（Exchange是必须的）并添加一个gitlab专用的账户，本文使用E5开发者订阅
2. 部署好的GitLab，参考上一篇文章

步骤

---

一、 配置Microsoft Entra

1. 注册应用程序

登录Azure门户，进入Microsoft Entra ID，选择管理-应用注册-新注册

填写你想要的名称，点击注册

2. 配置应用程序权限

进入新注册的应用程序，选择API
权限-添加权限，选择Microsoft Graph

选择应用程序权限下的并添加权限

MailboxFolder.ReadWrite.All
Mail.ReadWrite
Mail.Send

代表组织授管理员同意

3. 生成密钥

选择左侧的证书和密码，选择客户端密码-新客户端密码并添加一个客户端密码

即时记下值中的内容，离开页面后将不可见

二、 配置GitLab

1. 通用配置

gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'  
#这里发件人的显示名称对于Microsoft Graph无效，需要在Exchange中手动修改
gitlab_rails['gitlab_email_display_name'] = 'Example Gitlab' 
gitlab_rails['gitlab_email_reply_to'] = 'gitlab@example.com'

2. GitLab发件配置

gitlab_rails['microsoft_graph_mailer_enabled'] = true  
gitlab_rails['microsoft_graph_mailer_user_id'] = "发件用户ID"  
gitlab_rails['microsoft_graph_mailer_tenant'] = "租户ID"  
gitlab_rails['microsoft_graph_mailer_client_id'] = "应用程序(客户端) ID"  
gitlab_rails['microsoft_graph_mailer_client_secret'] = "客户端密码值"
gitlab_rails['microsoft_graph_mailer_azure_ad_endpoint'] = "https://login.microsoftonline.com"  
gitlab_rails['microsoft_graph_mailer_graph_endpoint'] = "https://graph.microsoft.com"

其中，发件用户ID可以在Microsoft Entra ID中选择管理-用户-所有用户-发件用户-对象ID获取

租户ID和应用程序ID在刚刚注册的应用程序概述中获取

3. GitLab收件自动化配置

gitlab_rails['incoming_email_enabled'] = true  
gitlab_rails['incoming_email_address'] = "gitlab+%{key}@example.com"  
gitlab_rails['incoming_email_email'] = "gitlab@example.com"
gitlab_rails['incoming_email_mailbox_name'] = "收件箱名称"  
gitlab_rails['incoming_email_inbox_method'] = 'microsoft_graph'  
gitlab_rails['incoming_email_inbox_options'] = {  
    'azure_ad_endpoint': 'https://login.microsoftonline.com',  
    'graph_endpoint': 'https://graph.microsoft.com',  
    'tenant_id': '租户ID',  
    'client_id': '应用程序(客户端) ID',  
    'client_secret': '客户端密码值',  
    'poll_interval': 60  # Optional  
 }

其中，收件箱名称在使用非默认的inbox（收件箱）时需要手动获取收件箱的ID，例如在邮箱新建了一个文件夹ABC，这里不能填ABC否则Graph Api会报错

接下来在Postman中调用Microsoft Graph手动获取邮箱文件夹ID

先登录获取token

GET https://login.microsoftonline.com/5bbef931-9b10-4928-834d-92698bc78da7/oauth2/v2.0/token

Body选择x-www-form-urlencoded，添加如下参数

参数	值
grant_type	client_credentials
client_id	应用程序（客户端）ID
client_secret	客户端密码值
scope	https://graph.microsoft.com/.default

请求后获取access_token

然后获取邮箱文件夹ID

GET https://graph.microsoft.com/v1.0/users/gitlab@example.com/mailFolders

Header中添加Authorization 值为刚刚获取的token

请求后得到所有文件夹的信息，记录下我们所需的文件夹的ID填入配置中

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('gitlab@example.com')/mailFolders",
    "value": [
        {
            "id": "xxx",
            "displayName": "ABC",
            "parentFolderId": "xxx",
            "childFolderCount": 0,
            "unreadItemCount": 0,
            "totalItemCount": 0,
            "sizeInBytes": 0,
            "isHidden": false
        },
        {
            "id": "xxx",
            "displayName": "发件箱",
            "parentFolderId": "xxx",
            "childFolderCount": 0,
            "unreadItemCount": 0,
            "totalItemCount": 0,
            "sizeInBytes": 0,
            "isHidden": false
        },...
    ]
}

4. 重新应用GitLab配置并测试

进入GitLab容器并运行命令gitlab-ctl reconfigure

等待配置重新应用后运行命令gitlab-rails console进入GitLab命令行，可能需要几分钟进行初始化

执行测试命令

Notify.test_email('your-email@example.com', 'Test Email', 'This is a test email.').deliver_now

若配置正常会提示邮件发送成功

---

本文可能随时更新，原始地址：https://blog.akadot.net/post/2025/2/6/config-microsoft-graph-as-the-send-and-incoming-email-tool

欢迎转载、引用，请务必申明出处与作者

园子博客是为了优化SEO，最新文章请访问我的博客：https://blog.akadot.net