안전한 Wi-Fi Enterprise 구성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Android 11 QPR1 이상에서는 시스템이 TLS 기반 Wi-Fi Enterprise 구성 (예: PEAP, TLS 또는 TTLS)에 엄격한 보안 구성을 요구합니다. Wi-Fi 인프라 개요에 지정된 메서드 또는 addNetwork를 사용하여 새 엔터프라이즈 구성을 추가할 때 호출자는 루트 CA 인증서와 도메인 서픽스 일치 또는 대체 주체 일치를 모두 구성해야 합니다. 새 구성이 제대로 설정되지 않으면 시스템에서 구성을 거부하고 추가 또는 저장되지 않습니다.
이 보안 요구사항은 앱에서 제공하는 루트 CA를 사용하여 인증 서버의 인증서 및 도메인 이름을 암호화 방식으로 검증합니다. 이렇게 하면 사용자가 신뢰할 수 있는 네트워크에 연결됩니다.
안전한 엔터프라이즈 구성을 만들어야 하는 앱은 setCaCertificate 또는 setCaCertificates를 호출해야 합니다.
루트 CA 인증서 또는 루트 CA 인증서 목록이 설정됩니다. 그런 다음 앱은 setAltSubjectMatch 또는 setDomainSuffixMatch를 호출하여 대체 제목이나 도메인 이름 서픽스를 설정해야 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],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."]]
