Jamf Return to Service擦除Mac后WiFi自动配置失败求助

使用Jamf MDM的Return to Service命令擦除Mac设备，期望实现无人干预自动配置。通过Jamf Swagger API调用后，设备成功擦除，但WiFi配置文件未自动加载，导致设备无法连接WiFi完成重新注册。

调用的Python代码（基于Jamf封装库）：

pro.create_mdm_command(
    {
        "commandData": {
            "commandType": "ERASE_DEVICE",
            "returnToService": {
                "enabled": True,
                "mdmProfileData": "iamnotshowingthisbutididbase64encodeit",
                "wifiProfileData": "iamnotshowingthisbutibase64encodeit"
            },
            "pin": "123456"
        },
        "clientData": [{ "managementId": " -6043-4dae-8341-265768a15e5f" }]
    }
)

执行步骤：

1. 在Jamf中配置WiFi配置文件；
2. 下载wifi profile的mobile.config并转为XML格式；
3. 对XML进行base64编码；
4. 通过Jamf API Swagger完成用户认证；
5. 获取Jamf managementId；
6. 将所有参数整合到Shell脚本中执行。

1. 修正Management ID格式错误 #

代码中managementId字段前存在多余空格（" -6043-4dae-8341-265768a15e5f"），这会导致设备无法被正确识别，命令仅执行擦除但不会推送后续配置。直接去掉空格，使用完整正确的managementId。

2. 重新生成正确的WiFi配置文件编码 #

Mac的WiFi配置无需手动转为XML，.mobileconfig本身就是符合要求的XML plist格式文件。正确的编码步骤：

• 直接从Jamf导出WiFi配置文件（保持.mobileconfig格式）；
• 使用终端命令直接编码整个文件：

  base64 -i your-wifi-profile.mobileconfig > encoded-wifi.txt
  

• 将生成的编码内容完整填入wifiProfileData字段，确保无换行、截断或额外字符。

3. 验证Jamf版本与Mac RTS支持 #

确认你的Jamf Pro版本支持Mac设备的Return to Service WiFi配置：

• Jamf Pro 10.30及以上版本对Mac的RTS功能支持更完善；
• 旧版本可能存在Mac WiFi配置推送的bug，建议升级到兼容版本。

4. 检查API角色权限 #

确保调用API的角色拥有以下核心权限：

• MDM Commands: Send
• Return to Service: Create
• Configuration Profiles: Read
  缺少任何一项都可能导致配置无法正常推送。

5. 验证WiFi配置Payload有效性 #

使用Apple的Profile Creator工具或Jamf内置的配置编辑器，检查WiFi配置的Payload：

• 确保Payload类型为com.apple.wifi.managed；
• 包含正确的SSID、安全类型（WPA2/WPA3）、密码（若需认证）；
• 无无效字段或语法错误，避免配置被系统拒绝。

6. 查看Jamf日志排查错误 #

在Jamf Pro后台的MDM命令日志中，查看该ERASE_DEVICE命令的详细执行记录：

• 检查是否存在"Invalid profile data"或"WiFi profile rejected"等错误提示；
• 确认MDM Profile是否成功推送，若MDM配置未生效，WiFi配置也无法被加载。

7. 测试手动推送验证配置有效性 #

先通过Jamf手动将WiFi配置推送到目标Mac设备，确认配置能正常生效后，再通过API执行Return to Service命令，排除配置本身的问题。

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