ポリシーを使用して、デバイスで Wi-Fi ネットワークを設定できます。Android Management API は、Open Network Configuration を使用します。これは、元々 Chromium プロジェクトの一部として開発された標準の JSON ベースの形式です。Open Network Configuration の詳細については、仕様をご覧ください。
ポリシーにオープン ネットワーク構成を含めるには、Policy リソースに openNetworkConfiguration フィールドを設定します。
完全管理対象デバイスの場合、必要に応じて、Policy リソースで wifiConfigDisabled を true に設定して、ユーザーがデバイスで Wi-Fi 設定を手動で構成できないようにすることができます。
サポートされている機能
Android Management API は、Open Network Configuration 仕様のサブセットのみをサポートしています。
- 最上位のオブジェクト:
Typeは省略するか、UnencryptedConfigurationに設定する必要があります。ポリシー全体が Android Management API サービス内で暗号化されるため、ポリシー内のネットワーク構成を暗号化する必要はありません。さらに、パスフレーズや秘密鍵などの機密情報に対して 2 つ目の暗号化レイヤがあります。
NetworkConfigurationオブジェクト:GUID、Name、Type、WiFiはサポートされているフィールドで、すべて必須です。ProxySettingsは、オプション フィールドです。この場合、ManualとPAC（プロキシ自動構成）のみがサポートされます。TypeはWiFiに設定する必要があります。他のタイプのネットワークはサポートされていません。
WiFiオブジェクト:SSIDとHexSSIDがサポートされており、少なくとも 1 つは存在する必要があります。HexSSIDとSSIDの両方が設定されている場合、値は一貫している必要があります。
HiddenSSIDのみがサポートされています。AllowGatewayARPPollingはご利用になれません。SignalStrengthはご利用になれません。Securityは必須で、次の値がサポートされています。 - なし - WEP-PSK - WPA-PSK - WPA-EAP - WEP-8021X - WPA3-Enterprise_192WEP-PSKパスフレーズの場合、40 ビット（10 桁）または 104 ビット（26 桁）のパスフレーズのみがサポートされます。- 仕様では、
WEP-PSKパスフレーズは接頭辞0xで始まる必要があります。ただし、Android フレームワークとの整合性を確保するため、この接頭辞は必須ではありません。 - MAC のランダム化モードを設定するには、
HardwareまたはAutomaticの値を設定したプロパティMACAddressRandomizationModeを使用します。このプロパティは現在、Open Network Configuration（ONC）仕様では使用できませんが、AMAPI で提供されており、Wi-Fi ネットワークの構成時に指定できます。これは、すべての管理モードの Android 13 以降にのみ適用されます。Hardwareは、ネットワークに接続するときに出荷時 MAC アドレスを使用します。Automaticを使用すると、Wi-Fi フレームワークが MAC のランダム化戦略を自動的に決定します。これは、ネットワークへの接続時に使用される、ランダムに生成された MAC アドレスで、永続的または非永続的のいずれかです。
EAPオブジェクト:ClientCertPatternはご利用になれません。- 認証情報は常に保存されるため、
SaveCredentialsはサポートされていません。 UseSystemCAsはご利用になれません。ServerCARefのみがサポートされています。ServerCARefsのみがサポートされています。DomainSuffixMatchがサポートされています。このフィールドが指定されていない（または値が空のリストである）エンタープライズ ワイヤレス構成は安全でないものと見なされ、プラットフォームによって拒否されます。値は有効なドメイン名（example.com、subdomain.example.com など）にする必要があります。ClientCertTypeでサポートされている値は、Ref、KeyPairAliasです。Innerでサポートされている値は、MSCHAPv2、PAPです。Outerでサポートされている値は、EAP-AKA、EAP-TLS、EAP-TTLS、EAP-SIM、PEAPです。
Certificateオブジェクト:Removeはサポートされていません。代わりに、構成で証明書を省略します。TrustBitsはご利用になれません。
例
複数の Wi-Fi ネットワーク
このポリシー フラグメントの例は、異なるセキュリティ スキームで構成された 3 つの Wi-Fi ネットワークを示しています。Open Network Configuration JSON は、Policy JSON の openNetworkConfiguration フィールド内にネストされています。
"openNetworkConfiguration": {
"NetworkConfigurations": [
{
"GUID": "a",
"Name": "Example A",
"Type": "WiFi",
"WiFi": {
"SSID": "Example A",
"Security": "None",
"AutoConnect": true
}
},
{
"GUID": "b",
"Name": "Example B",
"Type": "WiFi",
"WiFi": {
"SSID": "Example B",
"Security": "WEP-PSK",
"Passphrase": "1234567890"
}
},
{
"GUID": "c",
"Name": "Example C",
"Type": "WiFi",
"WiFi": {
"SSID": "Example C",
"Security": "WPA-PSK",
"Passphrase": "baseball"
}
},
{
"GUID": "networkA",
"Name": "networkA",
"Type": "WiFi",
"WiFi": {
"SSID": "networkA",
"Security": "WPA-PSK",
"Passphrase": "pwd1234567",
"MACAddressRandomizationMode": "Hardware"
}
}
]
}
EAP 認証
このポリシー フラグメントの例は、EAP-TLS 認証で構成されたワイヤレス ネットワークを示しています。この例では、NetworkConfigurations オブジェクトに加えて、クライアント証明書とサーバー証明書の 2 つの Certificates オブジェクトが含まれています。
"openNetworkConfiguration": {
"Type": "UnencryptedConfiguration",
"NetworkConfigurations": [
{
"GUID": "a",
"Name": "Example A",
"Type": "WiFi",
"WiFi": {
"SSID": "Example A",
"EAP": {
"Outer": "EAP-TLS",
"Identity": "example",
"DomainSuffixMatch": [
"example.com",
"example.org"
],
"ServerCARefs": ["abc123"],
"ClientCertType": "Ref",
"ClientCertRef": "xyz456"
},
"Security": "WPA-EAP"
}
}
],
"Certificates": [
{
"GUID": "abc123",
"Type": "Server",
"X509": "TWFuIGlzIGRpc3Rpbmd1a"
},
{
"GUID": "xyz456",
"Type": "Client",
"PKCS12": "6PQIEQYJKoZbdDu8gwggRlqCCAPEbAAcGClgvcNAQc"
}
]
}
ClientCertType フィールドは KeyPairAlias に設定することもできます。ClientCertKeyPairAlias フィールドを使用すると、Wi-Fi 認証に使用される、インストール済み（DevicePolicyManager.installKeyPair を参照）または生成された（DevicePolicyManager.generateKeyPair を参照）KeyChain 鍵ペアのエイリアスを指定できます。Android 12 以降では、ClientCertKeyPairAlias で指定されたエイリアスを持つ KeyChain 鍵ペアが Wi-Fi ネットワークの認証のために付与され、対応する Wi-Fi ネットワークの認証に使用されます。Android 12 より前では、理由が API_LEVEL の nonComplianceDetail が報告されます。指定された鍵ペアのエイリアスが既存の鍵に対応していない場合、INVALID_VALUE の理由と ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY の具体的な理由を含む nonComplianceDetail が報告されます。ポリシーの例を次に示します。
"openNetworkConfiguration": {
"Type": "UnencryptedConfiguration",
"NetworkConfigurations": [
{
"GUID": "a",
"Name": "Example A",
"Type": "WiFi",
"WiFi": {
"SSID": "Example A",
"EAP": {
"Outer": "EAP-TLS",
"Identity": "example",
"DomainSuffixMatch": [
"example.com",
"example.org"
],
"ServerCARefs": ["abc123"],
"ClientCertType": "KeyPairAlias",
"ClientCertKeyPairAlias": "key-alias"
},
"Security": "WPA-EAP"
}
}
],
"Certificates": [
{
"GUID": "abc123",
"Type": "Server",
"X509": "TWFuIGlzIGRpc3Rpbmd1a"
}
]
}
Security フィールドは、WPA3 192 ビット モードで構成された WPA-EAP ネットワークである WPA3-Enterprise_192 にすることもできます。
"openNetworkConfiguration": {
"Type": "UnencryptedConfiguration",
"NetworkConfigurations": [
{
"Type": "WiFi",
"Name": "Example A",
"GUID": "A",
"WiFi": {
"SSID": "Example A",
"EAP": {
"Outer": "EAP-TLS",
"Identity": "example",
"ServerCARefs": ["abc123"],
"ClientCertType": "Ref",
"ClientCertRef": "xyz456",
"DomainSuffixMatch": ["example.com"]
},
"Security": "WPA3-Enterprise_192",
"AutoConnect": true
}
}
],
"Certificates": [
{
"GUID": "abc123",
"Type": "Server",
"X509": "TWFuIGlzIGRpc3Rpbmd1a"
},
{
"GUID": "xyz456",
"Type": "Client",
"PKCS12": "6PQIEQYJKoZbdDu8gwggRlqCCAPEbAAcGClgvcNAQc"
}
]
}