Azure HTTP Trigger优化：复用安全令牌及使用应用ID密钥登录

一、复用安全令牌避免重复慢启动 #

Azure函数实例会被平台复用，可通过静态变量缓存Exchange Online会话，减少重复连接的耗时。核心思路是在实例生命周期内保持有效会话，仅当会话失效时重新建立连接：

• 用静态变量存储会话对象和过期时间
• 每次执行前检查会话是否存在且未过期
• 无效时重新连接，有效则直接复用

二、使用应用ID和密钥（服务主体）认证 #

完全可以用Azure AD服务主体替代普通用户账户认证，步骤如下：

1. 在Azure AD注册应用程序，记录应用ID和客户端密钥
2. 给应用分配Exchange Online权限：需添加Exchange.ManageAsApp应用权限，并在Exchange Online中分配RBAC角色（如View-Only Organization Management）
3. 使用Connect-ExchangeOnline的-AppId、-Organization、-AppSecret参数完成认证

修改后的完整代码 #

using namespace System.Net

# 静态变量缓存Exchange会话，跨请求复用
static $exchangeSession = $null
static $sessionExpiry = $null

param($Request, $TriggerMetadata)

$body = @{}

# 从应用设置读取敏感信息（避免硬编码）
$appId = $env:EXCHANGE_APP_ID
$appSecret = $env:EXCHANGE_APP_SECRET | ConvertTo-SecureString -AsPlainText -Force
$organization = "contoso.com"

try {
    $currentTime = Get-Date
    # 检查会话是否有效：不存在或已过期则重新连接
    if (-not $exchangeSession -or $currentTime -ge $sessionExpiry) {
        # 清理旧会话（如果存在）
        if ($exchangeSession) {
            Disconnect-ExchangeOnline -Confirm:$false -ErrorAction SilentlyContinue
        }
        # 服务主体方式连接Exchange Online
        Connect-ExchangeOnline -AppId $appId -AppSecret $appSecret -Organization $organization -ShowBanner:$false
        $exchangeSession = Get-PSSession | Where-Object { $_.ConfigurationName -eq 'Microsoft.Exchange' }
        # 设置会话过期时间（令牌默认1小时，留5分钟缓冲）
        $sessionExpiry = $currentTime.AddMinutes(55)
    } else {
        # 复用现有会话
        Import-PSSession $exchangeSession -DisableNameChecking -ErrorAction Stop
    }

    $filter = $Request.Body
    $wildCard = $filter.wildCard

    $SharedMailboxes = Get-Mailbox -RecipientTypeDetails SharedMailbox -ResultSize:1000 $wildcard | 
    Select-Object Identity, User, AccessRights, SamaccountName, PrimarySmtpAddress, City, UsageLocation, IsDirSynced, DisplayName, HiddenFromAddressListsEnabled, GrantSendOnBehalfTo, EmployeeID

    $body.values = $SharedMailboxes
}
catch {
    Write-Error $_.Exception.Message
    $body.error = $_.Exception.Message
    # 异常时重置会话，避免下次复用无效连接
    $exchangeSession = $null
    $sessionExpiry = $null
}
finally {
    # 不要在此处断开会话，否则无法复用；实例回收时会自动释放会话
    # Disconnect-ExchangeOnline -Confirm:$false
}

Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $body
})

关键注意事项 #

• 静态变量作用域：仅在同一函数实例内有效，多实例场景下每个实例会维护独立会话
• 权限配置：服务主体需在Exchange Online分配对应RBAC角色，示例命令：

  New-ManagementRoleAssignment -Role "View-Only Organization Management" -Application "你的应用名称"
  

• 安全存储：应用ID和密钥不要硬编码，应存储在Azure函数的「应用设置」中，通过环境变量读取
• 过期处理：设置55分钟过期时间是为了提前触发重连，避免使用即将过期的令牌

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