安全的 Wi-Fi Enterprise 配置
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在 Android 11 QPR1 及更高版本中,系统会为基于 TLS 的 Wi-Fi Enterprise 配置(例如 PEAP、TLS 或 TTLS)强制实施严格的安全配置。使用 Wi-Fi 基础架构概览中指定的方法或使用 addNetwork
添加新的 Enterprise 配置时,调用方必须同时配置根 CA 证书,以及域名后缀匹配或备用主题匹配。如果新配置未正确设置,系统会拒绝该配置,并且不会添加或保存该配置。
此安全性要求使用应用提供的根 CA 以加密形式验证身份验证服务器的证书和域名。这样可确保用户连接到可信网络。
需要创建安全 Enterprise 配置的应用必须调用 setCaCertificate
或 setCaCertificates
。这会设置一个根 CA 证书或根 CA 证书列表。然后,应用必须调用 setAltSubjectMatch
或 setDomainSuffixMatch
来设置备用主题或域名后缀。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):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."]]