Trang này được dịch bởi Cloud Translation API.

Định cấu hình mạng

Bạn có thể sử dụng chính sách để định cấu hình mạng Wi-Fi trên một thiết bị. API quản lý Android sử dụng Cấu hình mạng mở, một định dạng dựa trên JSON chuẩn ban đầu được phát triển trong dự án Chromium. Hãy tham khảo quy cách để biết toàn bộ thông tin chi tiết về Cấu hình mạng mở.

Để đưa Cấu hình mạng mở vào chính sách, hãy đặt trường openNetworkConfiguration trên tài nguyên Policy.

Đối với các thiết bị được quản lý toàn bộ, bạn có thể tuỳ ý ngăn người dùng định cấu hình cài đặt Wi-Fi theo cách thủ công trên thiết bị của họ bằng cách đặt wifiConfigDisabled thành true trong tài nguyên Policy.

Việc tắt khả năng định cấu hình chế độ cài đặt Wi-Fi trong khi không khai báo bất kỳ mạng Wi-Fi nào trong openNetworkConfiguration sẽ tắt Wi-Fi trên thiết bị và ngăn thiết bị truy cập vào bất kỳ mạng Wi-Fi nào.

Tính năng được hỗ trợ

API Quản lý Android chỉ hỗ trợ một tập hợp con của quy cách Cấu hình mạng mở.

Đối tượng cấp cao nhất:
- Bạn phải bỏ qua hoặc đặt Type thành UnencryptedConfiguration. Bạn không cần mã hoá cấu hình mạng trong một chính sách vì toàn bộ chính sách được mã hoá trong dịch vụ Android Management API. Ngoài ra, còn có một lớp mã hoá thứ hai cho thông tin nhạy cảm như cụm mật khẩu và khoá riêng tư.
Đối tượng NetworkConfiguration:
- GUID, Name, Type và WiFi là các trường được hỗ trợ và đều bắt buộc.
- ProxySettings là trường không bắt buộc. Nếu bạn sử dụng tính năng này, hệ thống sẽ chỉ hỗ trợ Manual và PAC (Tự động định cấu hình proxy).
- Bạn phải đặt Type thành WiFi. Các loại mạng khác không được hỗ trợ.
Đối tượng WiFi:
- SSID và HexSSID được hỗ trợ và phải có ít nhất một trong số đó.
  - Nếu bạn đặt cả HexSSID và SSID, thì các giá trị phải nhất quán.
- HiddenSSID được hỗ trợ.
- AllowGatewayARPPolling không được hỗ trợ.
- SignalStrength không được hỗ trợ.
- Bạn phải nhập Security và các giá trị sau được hỗ trợ: - Không có - WEP-PSK - WPA-PSK - WPA-EAP - WEP-8021X - WPA3-Enterprise_192
- Đối với cụm mật khẩu WEP-PSK, chỉ hỗ trợ cụm mật khẩu 40 bit (10 chữ số) hoặc 104 bit (26 chữ số).
- Quy cách nêu rõ rằng cụm mật khẩu WEP-PSK phải bắt đầu bằng tiền tố 0x. Tuy nhiên, để đảm bảo tính nhất quán với Khung Android, bạn không bắt buộc phải sử dụng tiền tố này.
- Để đặt chế độ ngẫu nhiên MAC, hãy sử dụng thuộc tính MACAddressRandomizationMode được đặt bằng các giá trị Hardware hoặc Automatic. Thuộc tính này hiện không có trong thông số kỹ thuật Cấu hình mạng mở (ONC) nhưng được cung cấp trong AMAPI và có thể được chỉ định trong khi định cấu hình mạng WiFi. Điều này chỉ áp dụng cho Android 13 trở lên trên tất cả chế độ quản lý.
  - Hardware sử dụng địa chỉ MAC ban đầu khi kết nối với mạng.
  - Automatic cho phép khung Wi-Fi tự động quyết định chiến lược ngẫu nhiên MAC. Đây có thể là địa chỉ MAC bền vững hoặc không bền vững được tạo ngẫu nhiên và được dùng trong khi kết nối với mạng.
Đối tượng EAP:
- ClientCertPattern không được hỗ trợ.
- SaveCredentials không được hỗ trợ vì thông tin xác thực luôn được lưu.
- UseSystemCAs không được hỗ trợ.
- ServerCARef được hỗ trợ.
- ServerCARefs được hỗ trợ.
- DomainSuffixMatch được hỗ trợ. Cấu hình mạng không dây doanh nghiệp không có trường này (hoặc có danh sách trống làm giá trị) được coi là không an toàn và bị nền tảng từ chối. Giá trị phải là tên miền hợp lệ (ví dụ: "example.com", "subdomain.example.com").
- Các giá trị sau đây được hỗ trợ cho ClientCertType: Ref, KeyPairAlias
- Các giá trị sau đây được hỗ trợ cho Inner: MSCHAPv2, PAP
- Các giá trị sau đây được hỗ trợ cho Outer: EAP-AKA, EAP-TLS, EAP-TTLS, EAP-SIM, PEAP
Đối tượng Certificate:
- Remove không được hỗ trợ. Thay vào đó, hãy bỏ qua chứng chỉ trong cấu hình.
- TrustBits không được hỗ trợ.

Ví dụ

Nhiều mạng Wi-Fi

Mảnh chính sách mẫu này cho thấy 3 mạng Wi-Fi được định cấu hình bằng các giao thức bảo mật khác nhau. JSON Cấu hình mạng mở được lồng trong trường openNetworkConfiguration của JSON Policy.

"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"
      }
    }
  ]
}

Xác thực EAP

Mảnh chính sách mẫu này cho thấy một mạng không dây được định cấu hình bằng phương thức xác thực EAP-TLS. Ngoài đối tượng NetworkConfigurations, ví dụ này còn bao gồm hai đối tượng Certificates cho chứng chỉ máy khách và máy chủ.

"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"
      }
   ]
}

Bạn cũng có thể đặt trường ClientCertType thành KeyPairAlias và sử dụng trường ClientCertKeyPairAlias để chỉ định bí danh của một cặp khoá KeyChain đã cài đặt (xem DevicePolicyManager.installKeyPair) hoặc được tạo (xem DevicePolicyManager.generateKeyPair) dùng để xác thực Wi-Fi. Trên Android 12 trở lên, cặp khoá KeyChain có bí danh được chỉ định bằng ClientCertKeyPairAlias sẽ được cấp để xác thực vào mạng Wi-Fi và được dùng để xác thực vào mạng Wi-Fi tương ứng. Dưới Android 12, hệ thống sẽ báo cáo một nonComplianceDetail với lý do API_LEVEL. nonComplianceDetail với lý do INVALID_VALUE và lý do cụ thể ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY sẽ được báo cáo nếu bí danh cặp khoá đã chỉ định không tương ứng với khoá hiện có. Sau đây là ví dụ về chính sách:

"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"
      }
   ]
}

Trường Security cũng có thể là WPA3-Enterprise_192, là một mạng WPA-EAP được định cấu hình bằng chế độ WPA3 192 bit.

"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"
      }
   ]
}