Java获取SAML断言用户属性问题：ADFS 2.0集成后无法获取邮箱

你已经成功把Java应用和ADFS 2.0的SAML SSO跑通了，但在Servlet里用SAP的UserManagement API拿邮箱属性时返回null，这个问题我碰到过类似的，给你梳理几个排查方向和解决办法：

1. 先确认ADFS有没有把属性发出来 #

首先得排查根源：ADFS那边是不是真的把邮箱这类属性塞进SAML断言里了？

• 你可以在ADFS服务器的事件查看器里找ADFS相关日志，检查断言内容里有没有邮箱相关的属性节点。
• 用浏览器的SAML调试插件（比如Chrome的SAML Panel）抓一下SAML响应，看看<AttributeStatement>区块里有没有类似这样的内容：

<AttributeStatement>
  <Attribute Name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress">
    <AttributeValue>your-user@domain.com</AttributeValue>
  </Attribute>
</AttributeStatement>

如果ADFS根本没发这个属性，那得先去ADFS的声明规则里加个映射，把AD用户的邮箱字段对应到SAML断言的属性里。

2. 检查SAP UM API用的属性名称是否匹配 #

SAP的UserProvider API用的属性名，可能和ADFS发的不一样。比如ADFS常用的邮箱属性名是带命名空间的长字符串，而不是简单的email。

你可以先打印出当前用户的所有属性名称，看看实际有哪些可用：

try {
    user = userProvider.getUser(request.getRemoteUser());
    // 打印所有属性名称
    Set<String> allAttrs = user.getAttributeNames();
    System.out.println("当前用户可用属性：" + allAttrs);
    // 逐个打印属性值
    for(String attrName : allAttrs) {
        System.out.println(attrName + " = " + user.getAttribute(attrName));
    }
} catch (UnsupportedUserAttributeException | PersistenceException e) {
    e.printStackTrace();
}

运行这段代码后，控制台会输出所有属性，找到对应的邮箱属性名，替换掉你代码里的"email"就行。

3. 确认UserProvider的实例是否正确 #

有时候@Resource注入的UserProvider可能没关联到当前的SAML上下文，你可以试试用UserManagementAccessor来获取实例，确保拿到的是正确的：

try {
    // 用UserManagementAccessor获取UserProvider
    UserProvider userProvider = UserManagementAccessor.getUserProvider();
    User user = userProvider.getUser(request.getRemoteUser());
    // 替换成刚才打印出来的正确属性名
    String email = user.getAttribute("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress");
    System.out.println("用户邮箱：" + email);
} catch (Exception e) {
    e.printStackTrace();
}

4. 检查SP端的属性映射配置 #

作为SAML服务提供者（SP）的Java应用，需要确保配置了属性映射，把ADFS发的SAML属性对应到SAP UM的用户属性里。比如在SP的元数据或者配置文件中，要明确指定哪些SAML属性对应到UM的email字段。

如果是在SAP Cloud Platform上，你可以去租户的信任配置里，检查断言属性映射规则，确保ADFS发送的属性被正确映射到UM的用户属性中。

一般来说，最常见的问题就是属性名称不匹配，或者ADFS没配置发送属性。先通过打印所有属性确认实际的属性名，再调整代码应该就能解决了。

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