连接到企业无线网络 (技术预览)

您可以使用 REST API 调用将设备连接到公司 Wi-Fi 网络。例如，如果您有多个测试环境，则可能需要在运行自动化测试之前将设备连接到不同的网络。如果网络断开连接，您可能还需要切换到其他网络。

开始之前 - iOS 设备

iOS 设备需要特殊权限才能调用 API。因此，任何想要使用 API 连接到 Wi-Fi 网络的 iOS 设备上都必须安装 Wi-Fi 应用程序。

限制

请注意 WiFi 应用程序的以下限制: 

1.该应用程序仅支持 iOS 13 及更高版本。

2.该应用程序不应重新签名。它使用在应用程序运行之前需要信任的企业证书。

安装 WiFi 应用程序

  1. 找到 WiFi 应用程序。默认位置是 /opt/FunctionalTestingLabForMobileAndWeb/connector/Agent/WiFi/

  2. 通过运行命令安装应用程序 ideviceinstaller -i <ipaPath> 或者将应用程序上载到服务器并使用远程设备访问窗口将其安装在设备上。

  3. 该应用程序使用企业证书签名，因此您在第一次打开它时可能会收到不受信任的企业开发人员警报。要信任该应用程序，请转到设置 > 常规 > VPN 和设备管理并单击信任对话框中的 MicroFocus Ltd.，单击信任。

  4. 打开应用程序。显示警报。如果应用程序尝试在您的设备上打开代理应用程序，请单击打开。

  5. 输入必要的网络信息。打开调试模式。单击连接 WiFi。

    警告: 在生产环境中使用此应用程序时，请务必确保调试模式已关闭。

使用 REST API 在设备上设置 Wi-Fi 网络连接

使用 REST API 调用将设备连接到 Wi-Fi 网络。

/v2/devices/{deviceId}/jobs/{jobId}/WiFi/{ssid} 方法尝试与给定的 Wi-Fi 网络建立连接。如果连接成功，设备将连接到指定的网络。

请遵循以下指南来了解 WiFi 详情。

参数 详细信息
enterpriseType

使用的可扩展身份验证协议类型。

iOS: EAPTLS;EAPTTLS;EAPPEAP;EAPFAST。
一般情况下，取值为 EAPPEAP。

Android: PEAP; TLS; TTLS; PWD; SIM; AKA; WFA-UNAUTH-TLS;WAPI_CERT
enterpriseName 您的企业 Wi-Fi 网络用户名
enterprisePassphrase 您的企业 Wi-Fi 网络密码。
enterpriseDomain 企业 Wi-Fi 网络的服务器名称。

有关所需参数和响应主体的详细信息，请参阅 REST API 参考中的设备 PUT 部分。有关更多详细信息，请参阅 REST API 参考。