你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

排查 Azure 自动化托管标识问题

本文介绍将托管标识与自动化账户一起使用时可能会遇到的问题的解决方案。 有关将托管标识与自动化帐户一起使用的常规信息,请查看 Azure 自动化帐户身份验证概述

方案:具有系统分配的托管标识的 runbook 失败,出现 400 错误消息

问题

具有系统分配的托管标识的 runbook 失败,并出现错误 unable to acquire for tenant organizations with error ManagedIdentityCredential authentication failed. Managed System Identity not found! Status 400 (Bad Request)

原因

创建系统分配的托管标识后,尚未分配权限。

解决方法

请确保为系统分配的托管标识分配适当的权限。 对 Azure 自动化帐户使用系统分配的托管标识

场景:Runbook 中的托管标识无法对 Azure 进行身份验证

问题

在 Runbook 中使用托管标识时,会收到错误:connect-azaccount : ManagedIdentityCredential authentication failed: Failed to get MSI token for account d94c0db6-5540-438c-9eb3-aa20e02e1226 and resource https://management.core.windows.net/. Status: 500 (Internal Server Error)

原因

在以下情况下可能发生这种问题:

  • 原因 1:使用尚未创建的自动化帐户系统托管标识,且 Code Connect-AzAccount -Identity 尝试对 Azure 进行身份验证并在 Azure 或混合 Runbook 辅助角色上运行 Runbook。

  • 原因 2:自动化帐户分配有用户托管标识,而不是系统托管标识,并且 Code Connect-AzAccount -Identity 尝试使用 Azure VM 系统托管标识在 Azure 虚拟机混合 Runbook 辅助角色上运行 Runbook。

解决方法

  • 解决方法 1:必须创建自动化帐户系统托管标识并向其授予对 Azure 资源的访问权限。

  • 解决方法 2:根据需求,可以:

    • 创建自动化帐户系统托管标识并使用它进行身份验证。

    • 删除自动化帐户用户分配的托管标识。

场景:找不到用户分配的托管标识,无法将其添加到自动化帐户

问题

想要将用户分配的托管标识添加到自动化帐户。 但无法在“自动化”边栏选项卡中找到该帐户。

原因

如果对用户分配的托管标识没有以下权限(用于在“自动化”边栏选项卡中对其进行查看),则会出现此问题。

  • Microsoft.ManagedIdentity/userAssignedIdentities/*/read
  • Microsoft.ManagedIdentity/userAssignedIdentities/*/assign/action

注意

默认情况下,将上述权限授予托管标识操作员和托管标识参与者。

解决方法

确保拥有标识操作员角色权限,以便将用户分配的托管标识添加到自动化帐户。

场景:Runbook 失败,并出现错误消息“此 .Client.SubscriptionId 不可为 NULL。“

问题

你的 Runbook 使用托管标识 Connect-AzAccount - 该标识尝试管理 Azure 对象,无法成功工作,并且记录以下错误 - this.Client.SubscriptionId cannot be null.

get-azvm : 'this.Client.SubscriptionId' cannot be null. At line:5 char:1 + get-azvm + ~~~~~~~~ + CategoryInfo : CloseError: (:) [Get-AzVM], ValidationException + FullyQualifiedErrorId : Microsoft.Azure.Commands.Compute.GetAzureVMCommand

原因

在托管标识(或 Runbook 中使用的其他帐户)尚未被授予任何访问订阅的权限时,可能会发生这种情况。

解决方法

请在订阅中向该托管标识(或 Runbook 中使用的其他帐户)授予相应的角色成员身份。 了解详细信息

显示 Azure 角色分配的屏幕截图。

显示如何添加角色分配的屏幕截图。

场景:无法获取帐户的 MSI 令牌

问题

在自动化帐户中使用用户分配的托管标识时,你会收到类似以下内容的错误:Failed to get MSI token for account a123456b-1234-12a3-123a-aa123456aa0b

原因

在为自动化帐户启用系统分配的托管标识之前使用用户分配的托管标识。

解决方法

为自动化帐户启用系统分配的托管标识。 然后使用用户分配的托管标识。

方案:尝试将托管标识与自动化帐户一起使用时失败

问题

尝试在自动化帐户中使用托管标识时,遇到如下错误:

Connect-AzureRMAccount : An error occurred while sending the request. At line:2 char:1 + Connect-AzureRMAccount -Identity + 
CategoryInfo : CloseError: (:) [Connect-AzureRmAccount], HttpRequestException + FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzureRmAccountCommand

原因

导致这种情况的最常见原因是,在尝试使用标识之前未启用该标识。 若要验证这一点,请在受影响的自动化帐户中运行以下 PowerShell Runbook。

$resource= "?resource=https://management.azure.com/"
$url = $env:IDENTITY_ENDPOINT + $resource
$Headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$Headers.Add("X-IDENTITY-HEADER", $env:IDENTITY_HEADER)
$Headers.Add("Metadata", "True")

try
{
    $Response = Invoke-RestMethod -Uri $url -Method 'GET' -Headers $Headers
}
catch
{
    $StatusCode = $_.Exception.Response.StatusCode.value__
    $stream = $_.Exception.Response.GetResponseStream()
    $reader = New-Object System.IO.StreamReader($stream)
    $responseBody = $reader.ReadToEnd()
    
    Write-Output "Request Failed with Status: $StatusCode, Message: $responseBody"
}

如果问题是你在尝试使用标识之前未启用该标识,则会看到如下所示的结果:

Request Failed with Status: 400, Message: {"Message":"No managed identity was found for Automation account xxxxxxxxxxxx"}

解决方法

必须为自动化帐户启用标识,然后才能使用托管标识服务。 请查看为 Azure 自动化帐户启用托管标识

后续步骤

如果本文未解决你的问题,请尝试通过以下渠道之一获取更多支持:

  • 通过 Azure 论坛获取 Azure 专家的解答。
  • 连接 @AzureSupport。 这是官方的 Microsoft Azure 帐户,它可以连接到 Azure 社区中的合适资源,为你提供解答、支持和专家建议。
  • 提出 Azure 支持事件。 请转到 Azure 支持站点并选择“获取支持”。