大网数据广告活动
Azure 存储与备份

使用 Azure AD 域服务通过 SMB 授权访问文件数据

· 52CE 我爱测

了解如何通过 Azure Active Directory 域服务,通过服务器消息块对 Azure 文件 (SMB) 启用基于身份的身份验证。 已加入域的 Windows 虚拟机 (Vm) 然后可以使用 Azure AD 凭据访问 Azure 文件共享。

Azure 文件  通过以下两种类型的域服务,支持通过服务器消息块进行基于身份的身份验证 (SMB) :本地 Active Directory 域服务 (AD DS) Azure Active Directory (Azure AD) 和域服务。强烈建议您查看 "工作原理" 部分,选择适当的域服务进行身份验证。 安装程序不同,具体取决于所选的域服务。 本文重点介绍如何启用和配置 Azure AD DS,以便通过 Azure 文件共享进行身份验证。

如果你不熟悉 Azure 文件共享,我们建议在阅读以下文章之前阅读我们的 规划指南 。

Note: Azure 文件仅支持具有仅限 RC4-HMAC Azure AD DS 的 Kerberos 身份验证。 目前尚不支持 AES Kerberos 加密。 Azure 文件支持对 Azure AD DS 进行身份验证,与 Azure AD 完全同步。 如果已在 Azure AD DS 中启用范围内同步,仅同步 Azure AD 的有限标识,则不支持身份验证和授权。

先决条件

在 Azure 文件共享的 SMB 上启用 Azure AD 之前,请确保已完成以下先决条件:

  1. 选择或创建 Azure AD 租户。

    可以使用新的或现有的租户进行通过 SMB 的 Azure AD 身份验证。 要访问的租户和文件共享必须与同一订阅相关联。

    若要创建一个新的 Azure AD 租户,可以添加 Azure AD 租户和 Azure AD 订阅。 如果现有 Azure AD 租户,但想要创建新的租户用于 Azure 文件共享,请参阅 创建 Azure Active Directory 租户。

  2. 启用 Azure AD 租户上的 Azure AD 域服务。

    若要支持使用 Azure AD 凭据进行身份验证,必须启用 Azure AD 租户的 Azure AD 域服务。 如果你不是 Azure AD 租户的管理员,请与管理员联系并按照分步指南操作,以使用 Azure 门户启用 Azure Active Directory 域服务。

    完成 Azure AD DS 部署通常需要大约15分钟。 在继续下一步之前,请验证 Azure AD DS 的运行状况状态显示为"已启用密码哈希同步"。

  3. 使用 Azure AD DS 将 Azure VM 加入域。

    若要通过使用 Azure AD 虚拟机中的凭据来访问文件共享,你的 VM 必须已加入域 Azure AD DS。 有关如何将 VM 加入域的详细信息,请参阅将 Windows Server 虚拟机加入托管域。

    NOTE 仅支持在 Windows 7 或 Windows Server 2008 R2 以上的操作系统版本上运行的 Azure Vm 在 Azure 文件共享上 Azure AD DS 身份验证。

  4. 选择或创建 Azure 文件共享。

    选择与 Azure AD 租户相同订阅关联的新的或现有文件共享。 有关创建新的文件共享的信息,请参阅在 Azure 文件中创建文件共享。 为了获得最佳性能,建议将文件共享与计划从中访问共享的 VM 位于同一区域。

  5. 通过使用存储帐户密钥装载 Azure 文件共享来验证 Azure 文件连接。

    要验证是否已正确配置 VM 和文件共享,请尝试使用存储帐户密钥装载文件共享。 有关详细信息,请参阅在 Windows 中装载 Azure 文件共享并对其进行访问。

区域可用性

使用 Azure AD DS 的 azure 文件身份验证在 所有 Azure 公共、Gov 和中国地区都可用。

工作流概述

在 Azure 文件共享的 SMB 上启用 Azure AD DS 身份验证之前,请验证是否正确配置了 Azure AD 和 Azure 存储环境。 建议你逐步完成 先决条件 ,确保你已完成所有必需的步骤。

接下来,执行以下操作以使用 Azure AD 凭据授予对 Azure 文件资源的访问权限:

  1. 启用针对存储帐户的 SMB Azure AD DS 身份验证,以便向关联的 Azure AD DS 部署注册存储帐户。
  2. 将共享的访问权限分配给 Azure AD 标识(用户、组或服务主体)。
  3. 通过 SMB 为目录和文件配置 NTFS 权限。
  4. 从加入域的 VM 装载 Azure 文件共享。

下图说明了用于实现 Azure 文件的通过 SMB 进行 Azure AD DS 身份验证的端到端工作流。

显示通过 SMB 为 Azure 文件启用 Azure AD 的工作流的图表

为帐户启用 Azure AD DS 身份验证

若要启用对 Azure 文件的 SMB Azure AD DS 身份验证,可以通过使用 Azure 门户、Azure PowerShell 或 Azure CLI 来设置存储帐户的属性。 将此属性隐式设置为具有关联 Azure AD DS 部署的存储帐户。 然后,将对存储帐户中的所有新的和现有文件共享启用通过 SMB 进行的 Azure AD DS 身份验证。

请记住,仅当已成功将 Azure AD DS 部署到 Azure AD 租户之后,才能通过 SMB 启用 Azure AD DS 身份验证。 有关详细信息,请参阅 先决条件。

Portal

若要通过 Azure 门户启用 SMB Azure AD DS 身份验证,请执行以下步骤:

  1. 在 Azure 门户中,请前往现有的存储帐户,或者 创建一个存储帐户。
  2. 在“设置”部分选择“配置”。
  3. 在 " 文件共享基于标识的访问 " 下,将 Azure Active Directory 域服务) ( 的切换切换到 " 已启用"。
  4. 选择“保存”。

下图显示了如何为存储帐户启用通过 SMB 进行的 Azure AD DS 身份验证。

启用 Azure 门户中的 SMB Azure AD DS 身份验证

PowerShell

若要启用 Azure PowerShell 的 SMB Azure AD DS 身份验证,请安装最新 Az 模块 (2.4 或更高版本) 或 (1.5 或更高版本的) 。 有关安装 PowerShell 的详细信息,请参阅 在 Windows 上通过 PowerShellGet 安装 Azure PowerShell。

若要创建新的存储帐户,请调用 AzStorageAccount,然后将 EnableAzureActiveDirectoryDomainServicesForFile 参数设置为 true。 在下面的示例中,请记住将占位符值替换为自己的值。 (如果你使用的是以前的预览模块,则启用该功能的参数为 EnableAzureFilesAadIntegrationForSMB。 )

# Create a new storage account
New-AzStorageAccount -ResourceGroupName "<resource-group-name>" `
    -Name "<storage-account-name>" `
    -Location "<azure-region>" `
    -SkuName Standard_LRS `
    -Kind StorageV2 `
    -EnableAzureActiveDirectoryDomainServicesForFile $true

若要在现有存储帐户上启用此功能,请使用以下命令:

# Update a storage account
Set-AzStorageAccount -ResourceGroupName "<resource-group-name>" `
    -Name "<storage-account-name>" `
    -EnableAzureActiveDirectoryDomainServicesForFile $true

Azure CLI

若要启用 Azure CLI 通过 SMB 进行 Azure AD 身份验证,请安装最新的 CLI 版本 (版本2.0.70 或更高版本) 。 有关安装 Azure CLI 的详细信息,请参阅 安装 Azure CLI。

若要创建新的存储帐户,请调用 az storage account create,并将 --enable-files-aadds 属性设置为 true。 在下面的示例中,请记住将占位符值替换为自己的值。 (如果你使用的是以前的预览模块,则功能启用参数为 文件-aad。 )

# Create a new storage account
az storage account create -n <storage-account-name> -g <resource-group-name> --enable-files-aadds $true

若要在现有存储帐户上启用此功能,请使用以下命令:

# Update a new storage account
az storage account update -n <storage-account-name> -g <resource-group-name> --enable-files-aadds $true

为标识分配访问权限

若要使用基于身份的身份验证访问 Azure 文件资源, (用户、组或服务主体) 的标识必须在共享级别具有必要的权限。 此过程类似于指定 Windows 共享权限,你可以在其中指定特定用户对文件共享的访问类型。 本部分中的指导演示如何将文件共享的读取、写入或删除权限分配给标识。

我们引入了三个 Azure 内置角色用于向用户授予共享级权限:

  • 存储文件数据 Smb 共享读取器 允许通过 Smb 在 Azure 存储文件共享中进行读取访问。
  • 存储文件数据 SMB 共享参与者 允许通过 SMB 在 Azure 存储文件共享中进行读取、写入和删除访问。
  • 存储文件数据 SMB 共享提升的参与者 允许通过 SMB 在 Azure 存储文件共享中读取、写入、删除和修改 NTFS 权限。

Important: 对文件共享的完全管理控制(包括获取文件所有权的能力)需要使用存储帐户密钥。 Azure AD 凭据不支持管理控制。

你可以使用 Azure 门户、PowerShell 或 Azure CLI 将内置角色分配给用户的 Azure AD 标识,以便授予共享级别权限。 请注意,共享级别 Azure 角色分配可能需要一些时间才能生效。

Note: 如果计划使用本地 AD DS 进行身份验证,请记住将 AD DS 凭据同步到 Azure AD 。 从 AD DS 到 Azure AD 的密码哈希同步是可选的。 将向从本地 AD DS 同步的 Azure AD 标识授予共享级权限。

一般的建议是使用对 AD 组(代表一组用户和标识)的高级访问权限管理的共享级别权限,然后利用 NTFS 权限对目录/文件级别上的粒度访问控制。

将 Azure 角色分配给 AD 标识

Portal

若要将 Azure 角色分配到 Azure AD 标识,请使用 Azure 门户,请执行以下步骤:

  1. 在 Azure 门户中,请切换到文件共享,或 创建文件共享。
  2. 选择“访问控制 (IAM)”。
  3. 选择 "添加角色分配"
  4. 在 " 添加角色分配 " 边栏选项卡中,从 " 角色 " 列表中选择适当的内置角色 (存储文件数据 smb 共享读取器、存储文件数据 smb 共享参与者) 。 将 " 分配访问权限 " 设置为默认设置: Azure AD 用户、组或服务主体。 按名称或电子邮件地址选择目标 Azure AD 标识。
  5. 选择 " 保存 " 以完成角色分配操作。

PowerShell

以下 PowerShell 示例演示了如何基于登录名将 Azure 角色分配到 Azure AD 标识。 有关使用 PowerShell 分配 Azure 角色的详细信息,请参阅 使用 RBAC 和 Azure PowerShell 管理访问权限。

在运行以下示例脚本之前,请记得将占位符值(包括括号)替换为自己的值。

#Get the name of the custom role
$FileShareContributorRole = Get-AzRoleDefinition "<role-name>" #Use one of the built-in roles: Storage File Data SMB Share Reader, Storage File Data SMB Share Contributor, Storage File Data SMB Share Elevated Contributor
#Constrain the scope to the target file share
$scope = "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/fileServices/default/fileshares/<share-name>"
#Assign the custom role to the target identity with the specified scope.
New-AzRoleAssignment -SignInName <user-principal-name> -RoleDefinitionName $FileShareContributorRole.Name -Scope $scope

Azure CLI

以下 CLI 2.0 命令显示了如何基于登录名将 Azure 角色分配到 Azure AD 标识。 有关将 Azure 角色分配到 Azure CLI 的详细信息,请参阅 使用 RBAC 和 Azure CLI 管理访问权限。

在运行以下示例脚本之前,请记得将占位符值(包括括号)替换为自己的值。

#Assign the built-in role to the target identity: Storage File Data SMB Share Reader, Storage File Data SMB Share Contributor, Storage File Data SMB Share Elevated Contributor
az role assignment create --role "<role-name>" --assignee <user-principal-name> --scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/fileServices/default/fileshares/<share-name>"

通过 SMB 配置 NTFS 权限

使用 RBAC 分配共享级别权限后,必须在根目录、目录或文件级别分配正确的 NTFS 权限。 将共享级权限视为用于确定用户是否可以访问共享的高级身份确认程序。 NTFS 权限的作用更精细,以确定用户可以在目录或文件级别执行哪些操作。

Azure 文件支持全套 NTFS 基本和高级权限。 你可以通过装入并使用 Windows 文件资源管理器或运行 Windows icacls 或 Set-ACL 命令来查看和配置 Azure 文件共享中的目录和文件的 NTFS 权限。

若要使用超级用户权限配置 NTFS,必须使用已加入域的 VM 中的存储帐户密钥装载共享。 按照下一部分中的说明从命令提示符装载 Azure 文件共享,并相应地配置 NTFS 权限。

文件共享的根目录支持以下权限集:

  • BUILTIN\Administrators:(OI)(CI)(F)
  • NT AUTHORITY\SYSTEM:(OI)(CI)(F)
  • BUILTIN\Users:(RX)
  • BUILTIN\Users:(OI)(CI)(IO)(GR,GE)
  • NT AUTHORITY\Authenticated Users:(OI)(CI)(M)
  • NT AUTHORITY\SYSTEM:(F)
  • CREATOR OWNER:(OI)(CI)(IO)(F)

从命令提示符装载文件共享

使用 Windows net use 命令装载 Azure 文件共享。 请记住,将以下示例中的占位符值替换为自己的值。 有关装载文件共享的详细信息,请参阅 将 Azure 文件共享用于 Windows。

$connectTestResult = Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 445
if ($connectTestResult.TcpTestSucceeded)
{
 net use <desired-drive letter>: \\<storage-account-name>.file.core.windows.net\<fileshare-name>
} 
else 
{
 Write-Error -Message "Unable to reach the Azure storage account via port 445. Check to make sure your organization or ISP is not blocking port 445, or use Azure P2S VPN, Azure S2S VPN, or Express Route to tunnel SMB traffic over a different port."
}

如果在连接到 Azure 文件时遇到问题,请参阅在 Windows 上为 Azure 文件装载错误发布的疑难解答工具。 我们还提供了有关在阻止端口445时解决方案的 指南 。

为 Windows 文件资源管理器配置 NTFS 权限

使用 Windows 文件资源管理器向文件共享下的所有目录和文件(包括根目录)授予完全权限。

  1. 打开 Windows 文件资源管理器,右键单击文件/目录,然后选择 " 属性"。
  2. 选择“安全”选项卡。
  3. 选择 " 编辑"。 更改权限。
  4. 您可以更改现有用户的权限,也可以选择 " 添加 ... " 向新用户授予权限。
  5. 在添加新用户的提示窗口中,在 " 输入要选择的对象名称 " 框中输入要向其授予权限的目标用户名,然后选择 " 检查名称 " 以查找目标用户的完整 UPN 名称。
  6. 选择“确定” 。
  7. 在 " 安全 " 选项卡中,选择要授予新用户的所有权限。
  8. 选择 应用。

使用 icacls 配置 NTFS 权限

使用以下 Windows 命令为文件共享(包括根目录)下的所有目录和文件授予完全权限。 请务必将示例中的占位符值替换为你自己的值。

icacls <mounted-drive-letter>: /grant <user-email>:(f)

有关如何使用 icacls 设置 NTFS 权限以及不同类型的支持权限的详细信息,请参阅 icacls 的命令行参考。

从加入域的 VM 装载文件共享

以下过程验证是否正确设置了文件共享和访问权限,并且可以从已加入域的 VM 访问 Azure 文件共享。 请注意,共享级别 Azure 角色分配可能需要一些时间才能生效。

使用已向其授予权限的 Azure AD 标识登录到 VM,如下图所示。 如果为 Azure 文件启用了本地 AD DS 身份验证,请使用 AD DS 凭据。 对于 Azure AD DS 身份验证,请用 Azure AD 凭据登录。

显示用户身份验证的 Azure AD 登录屏幕的屏幕截图

使用以下命令装载 Azure 文件共享。 请务必将占位符值替换为你自己的值。 由于已经过身份验证,因此不需要提供存储帐户密钥、本地 AD DS 凭据或 Azure AD DS 凭据。 通过本地 AD DS 或 Azure AD DS 进行身份验证时,支持单一登录体验。 如果遇到 AD DS 凭据装入问题,请参阅 在 Windows 中对 Azure 文件问题进行故障排除 以获得指导。

$connectTestResult = Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 445
if ($connectTestResult.TcpTestSucceeded)
{
 net use <desired-drive letter>: \\<storage-account-name>.file.core.windows.net\<fileshare-name>
} 
else 
{
 Write-Error -Message "Unable to reach the Azure storage account via port 445. Check to make sure your organization or ISP is not blocking port 445, or use Azure P2S VPN, Azure S2S VPN, or Express Route to tunnel SMB traffic over a different port."
}

你现在已成功启用通过 SMB Azure AD DS 身份验证,并分配了自定义角色,该角色提供对具有 Azure AD 标识的 Azure 文件共享的访问权限。 若要向其他用户授予对文件共享的访问权限,请按照 " 分配访问权限 " 中的说明,使用一个标识,并在 SMB 部分配置 NTFS 权限。

后续步骤

若要详细了解 Azure 文件以及如何通过 SMB 使用 Azure AD,请参阅以下资源:

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 roygara)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 01/03/2021
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。