如何在ASP.NET Core项目中读取Azure AD用户的wWWHomePage属性？

针对你遇到的Microsoft Graph API默认不返回wWWHomePage属性的问题，这里有几个可行的解决方案，完全适配你的Azure部署ASP.NET Core Web API场景：

方案一：显式指定要获取的属性（稳定版Graph API） #

Microsoft Graph的用户默认查询只会返回常用属性集合，wWWHomePage不在其中，但稳定版API其实是支持这个属性的，你只需要通过$select参数显式指定要获取它即可。

代码示例 #

首先确保你的项目已经通过Microsoft.Identity.Web配置了GraphServiceClient的依赖注入，然后在API控制器中编写如下代码：

using Microsoft.Graph;
using Microsoft.Identity.Web;

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    private readonly GraphServiceClient _graphServiceClient;

    public UsersController(GraphServiceClient graphServiceClient)
    {
        _graphServiceClient = graphServiceClient;
    }

    [HttpGet("{userId}/homepage")]
    [AuthorizeForScopes(Scopes = new[] { "User.Read.All" })]
    public async Task<IActionResult> GetUserHomePage(string userId)
    {
        try
        {
            // 通过Select方法指定要获取wWWHomePage属性
            var user = await _graphServiceClient.Users[userId]
                .Request()
                .Select(u => new { u.WWWHomePage })
                .GetAsync();

            if (user == null)
            {
                return NotFound($"用户 {userId} 不存在");
            }

            return Ok(new { UserId = userId, HomePageUrl = user.WWWHomePage });
        }
        catch (ServiceException ex)
        {
            return StatusCode((int)ex.StatusCode, $"Graph API请求失败：{ex.Message}");
        }
    }
}

权限配置 #

确保你的Azure AD应用注册已经添加了应用权限（因为是Web API后台调用）User.Read.All，并且已经获得管理员同意。

方案二：使用Beta版Graph API（如果稳定版未支持） #

如果稳定版API确实无法获取该属性，可以尝试使用Beta版端点，Beta版本通常会包含更多尚未正式发布的属性支持。

修改GraphServiceClient配置 #

在注册GraphServiceClient时，指定Beta版的Base URL：

// 在Program.cs中配置
builder.Services.AddMicrosoftGraph(options =>
{
    options.BaseUrl = "https://graph.microsoft.com/beta";
})
.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddMicrosoftIdentityWebApi(builder.Configuration);

之后的调用逻辑和方案一完全一致，同样通过Select指定wWWHomePage即可。

注意：Beta版API不保证稳定性，生产环境使用前请充分测试。

常见问题排查 #

• 如果遇到403错误：检查应用权限是否正确添加，且管理员已同意。
• 如果返回的wWWHomePage为null：确认目标用户的该属性在Azure AD中确实有值。

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