为Azure DevOps PAT令牌过期配置邮件通知提醒

核心思路 #

先从API拿到的PAT详情里提取过期时间，和当前日期计算剩余天数，触发提前30天/7天的提醒逻辑，再通过定时任务自动执行整个流程。

1. 计算过期触发阈值 #

遍历获取到的所有PAT，对每个PAT计算expirationDate与当前日期的差值：

• 当剩余天数等于30天时，发送「提前一个月」提醒
• 当剩余天数等于7天时，发送「提前一周」提醒
• 可额外加个到期前1天的最终提醒，确保用户不会错过

2. 定时触发方案（推荐云端服务） #

Azure DevOps Pipeline（最便捷）

创建一个定时触发的管道，每天运行一次：

• 在管道触发设置里用cron表达式配置定时，比如每天凌晨2点执行：0 2 * * *
• 管道里添加PowerShell/Python任务，整合你已有的PAT获取逻辑、阈值判断、邮件发送逻辑
• 优势：和Azure DevOps生态无缝衔接，无需额外维护服务器

Azure Function（更灵活）

创建一个定时触发的云函数，每天执行一次：

• 用C#/Python/JavaScript编写函数逻辑，调用PAT API、计算剩余天数、发送邮件
• 优势：轻量级，按需付费，适合复杂逻辑扩展

本地定时任务（备选）

如果团队有固定服务器，用Windows任务计划程序或Linux的cron定时运行脚本，但可靠性不如云端服务。

3. 邮件发送实现 #

用公司内部SMTP服务或Office 365 SMTP发送邮件，以下是PowerShell示例片段：

# 假设已通过API获取到PAT列表，每个PAT包含DisplayName、ExpirationDate、OwnerEmail
$currentDate = Get-Date
# 定义提醒阈值
$reminderSettings = @(
    @{Days=30; Message="一个月"},
    @{Days=7; Message="一周"},
    @{Days=1; Message="一天"}
)

foreach ($pat in $patList) {
    $daysLeft = ($pat.ExpirationDate - $currentDate).Days
    # 跳过已过期的PAT
    if ($daysLeft -lt 0) { continue }
    
    foreach ($setting in $reminderSettings) {
        if ($daysLeft -eq $setting.Days) {
            $subject = "【提醒】您的Azure DevOps PAT '$($pat.DisplayName)' 将在$($setting.Message)后过期"
            $body = @"
您好：
您的PAT「$($pat.DisplayName)」将于 $($pat.ExpirationDate.ToString("yyyy-MM-dd")) 过期，请及时登录Azure DevOps更新。

更新路径：Azure DevOps组织主页 → 用户设置 → 个人访问令牌 → 编辑或重新生成
"@
            # 替换成公司SMTP配置
            Send-MailMessage -To $pat.OwnerEmail `
                            -From "devops-alerts@yourcompany.com" `
                            -Subject $subject `
                            -Body $body `
                            -SmtpServer "smtp.yourcompany.com" `
                            -Port 587 `
                            -UseSsl
        }
    }
}

4. 避坑优化 #

• 避免重复提醒：把已发送的PAT ID、提醒日期存在文件或数据库里，下次运行时跳过已处理记录
• 抄送管理员：给团队DevOps管理员抄送提醒，防止用户遗漏
• 日志记录：每次运行时记录触发提醒的PAT信息，方便排查问题

内容的提问来源于stack exchange，提问作者Kaycee