安全 Wi-Fi Enterprise 設定
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在 Android 11 QPR1 以上版本中,系統會針對 TLS 型 Wi-Fi Enterprise 設定 (例如 PEAP、TLS 或 TTLS) 強制執行嚴格的安全性設定。使用 Wi-Fi 基礎架構總覽或 addNetwork
中指定的方法新增 Enterprise 設定時,呼叫端必須同時設定根憑證授權單位憑證,以及網域後置字串比對或替代主體比對。如果新設定未妥善設定,系統會拒絕該設定,也不會新增或儲存。
這項安全性要求會使用應用程式提供的根 CA,以加密方式驗證驗證伺服器的憑證和網域名稱。以確保使用者連線至信任的網路。
需要建立企業安全設定的應用程式必須呼叫 setCaCertificate
或 setCaCertificates
。這項操作會設定根 CA 憑證或根 CA 憑證的清單。接著,應用程式必須呼叫 setAltSubjectMatch
或 setDomainSuffixMatch
來設定替代主旨或網域名稱後置字串。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Secure Wi-Fi Enterprise configuration\n\nOn Android 11 QPR1 and higher, the system mandates strict security\nconfigurations for TLS-based Wi-Fi Enterprise configurations (like PEAP, TLS,\nor TTLS). When adding a new Enterprise configuration using the methods\nspecified in the [Wi-Fi infrastructure overview](/guide/topics/connectivity/wifi-infrastructure) or using\n[`addNetwork`](/reference/android/net/wifi/WifiManager#addNetwork(android.net.wifi.WifiConfiguration)), the caller must configure both a\nRoot CA certificate, and either a domain suffix match or an alternate subject\nmatch. If the new configuration isn't set up properly, the system rejects it\nand it's not added or saved.\n\nThis security requirement uses the Root CA provided by the app to\ncryptographically validate the authentication server's certificate and domain\nname. This ensures that the user is connected to a trusted network.\n\nAn app that needs to create a secure Enterprise configuration must call either\n[`setCaCertificate`](/reference/android/net/wifi/WifiEnterpriseConfig#setCaCertificate(java.security.cert.X509Certificate)) or [`setCaCertificates`](/reference/android/net/wifi/WifiEnterpriseConfig#setCaCertificates(java.security.cert.X509Certificate%5B%5D)).\nThis sets a Root CA certificate or a\nlist of Root CA certificates. The app must then call either\n[`setAltSubjectMatch`](/reference/android/net/wifi/WifiEnterpriseConfig#setAltSubjectMatch(java.lang.String)) or\n[`setDomainSuffixMatch`](/reference/android/net/wifi/WifiEnterpriseConfig#setDomainSuffixMatch(java.lang.String)) to set an alternate subject or a domain name suffix."]]