chrome.networking.onc

Mô tả

API chrome.networking.onc được dùng để định cấu hình kết nối mạng (Cellular, Ethernet, VPN hoặc Wi-Fi). API này dùng được trong các phiên kiosk tự động chạy trên Chrome OS.

Cấu hình kết nối mạng được chỉ định theo quy cách Cấu hình mạng mở (ONC).

LƯU Ý: Hầu hết các thuộc tính trong từ điển và giá trị enum đều sử dụng quy ước UpperCamelCase (các chữ viết liền với chữ cái đầu viết hoa) để khớp với quy cách ONC thay vì quy ước lowerCamelCase của JavaScript.

Quyền

networking.onc

Phạm vi cung cấp

Chrome 59 trở lên Chỉ ChromeOS

Loại

ActivationStateType

Enum

"Đã kích hoạt"

"Kích hoạt"

"Chưa kích hoạt"

"Đã kích hoạt một phần"

CaptivePortalStatus

Enum

"Không xác định"

"Ngoại tuyến"

"Trực tuyến"

"Cổng thông tin"

"ProxyAuthBắt buộc"

CellularProperties

Thuộc tính

  • ActivationState

    ActivationStateType không bắt buộc

    Trạng thái kích hoạt tài khoản nhà mạng.

  • ActivationType

    chuỗi không bắt buộc

    Loại kích hoạt mạng di động.

  • AllowRoaming

    boolean không bắt buộc

    Liệu chuyển vùng có được cho phép mạng hay không.

  • AutoConnect

    boolean không bắt buộc

    Liệu mạng di động có được kết nối tự động hay không (khi trong phạm vi).

  • Gia đình

    chuỗi không bắt buộc

    Nhóm công nghệ thiết bị di động - CDMA hoặc GSM.

  • FirmwareRevision

    chuỗi không bắt buộc

    Bản sửa đổi chương trình cơ sở đã tải trong modem di động.

  • FoundNetworks

    FoundNetworkProperties[] không bắt buộc

    Danh sách mạng tìm thấy trong lần quét mạng gần đây nhất.

  • HardwareRevision

    chuỗi không bắt buộc

    Bản sửa đổi phần cứng modem di động.

  • HomeProvider

    CellularProviderProperties không bắt buộc

    Thông tin về nhà cung cấp dịch vụ cấp thẻ SIM hiện được lắp đặt trong modem.

  • Nhà sản xuất

    chuỗi không bắt buộc

    Nhà sản xuất modem di động.

  • ModelID

    chuỗi không bắt buộc

    Mã kiểu modem di động.

  • NetworkTechnology

    chuỗi không bắt buộc

    Nếu modem được đăng ký trên một mạng thì công nghệ mạng hiện đang được sử dụng.

  • PaymentPortal

    PaymentPortal không bắt buộc

    Cổng thanh toán trực tuyến mà người dùng có thể sử dụng để đăng ký hoặc sửa đổi gói dữ liệu di động.

  • RoamingState

    chuỗi không bắt buộc

    Trạng thái chuyển vùng của modem di động trên mạng hiện tại.

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Trạng thái khoá SIM đối với mạng gia đình GSM.

  • SIMPresent

    boolean không bắt buộc

    Liệu có thẻ SIM hay không.

  • Đang quét

    boolean không bắt buộc

    Chrome 63 trở lên

    Đúng khi đang quét mạng di động.

  • ServingOperator

    CellularProviderProperties không bắt buộc

    Thông tin về nhà cung cấp dịch vụ mà modem hiện đang đăng ký trên mạng.

  • SignalStrength

    số không bắt buộc

    Cường độ tín hiệu mạng hiện tại.

  • SupportNetworkScan

    boolean không bắt buộc

    Liệu mạng di động có hỗ trợ tính năng quét hay không.

CellularProviderProperties

Thuộc tính

  • Mã

    string

    Mã nhận dạng mạng di động là một cách nối đơn giản giữa MCC (Mã quốc gia di động) và MNC (Mã mạng di động) của mạng.

  • Quốc gia

    chuỗi không bắt buộc

    Mã quốc gia gồm hai chữ cái.

  • Tên

    string

    Tên toán tử.

CellularStateProperties

Thuộc tính

CertificatePattern

Thuộc tính

  • EnrollmentURI

    string[] không bắt buộc

    Danh sách URI mà người dùng có thể được chuyển hướng đến trong trường hợp không tìm thấy chứng chỉ nào phù hợp với mẫu này.

  • Tổ chức phát hành

    IssuerSubjectPattern không bắt buộc

    Nếu được thiết lập, thì phải khớp mẫu theo chế độ cài đặt của nhà phát hành X.509.

  • IssuerCARef

    string[] không bắt buộc

    Danh sách chứng chỉ CA của tổ chức phát hành chứng chỉ. Chứng chỉ phải được một trong số họ ký để khớp với mẫu này.

  • Chủ đề

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu so khớp mà chế độ cài đặt chủ thể X.509 phải khớp.

ClientCertificateType

Enum

"Tham khảo"

"Hình mở khoá"

ConnectionStateType

Enum

"Đã kết nối"

"Đang kết nối"

"Chưa kết nối"

DeviceStateProperties

Thuộc tính

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Chrome 62 trở lên

    Trạng thái khoá SIM nếu Type = Cellular và SIMShipping = True.

  • SIMPresent

    boolean không bắt buộc

    Chrome 62 trở lên

    Đặt thành trạng thái hiện tại của SIM nếu loại thiết bị là Di động.

  • Đang quét

    boolean không bắt buộc

    Đặt nếu thiết bị được bật. Đúng nếu thiết bị hiện đang quét tìm.

  • Tiểu bang

    DeviceStateType

    Trạng thái hiện tại của thiết bị.

  • Loại

    Loại mạng

    Loại mạng liên kết với thiết bị (Di động, Ethernet hoặc Wi-Fi).

DeviceStateType

Enum

"Chưa khởi chạy"
Thiết bị có sẵn nhưng chưa được khởi chạy.

"Tắt"
Thiết bị đã được khởi chạy nhưng chưa được bật.

"Đang bật"
Trạng thái đã bật đã được yêu cầu nhưng chưa hoàn tất.

"Đã bật"
Thiết bị đã được bật.

"Bị cấm"
Thiết bị bị cấm.

EAPProperties

Thuộc tính

  • AnonymousIdentity

    chuỗi không bắt buộc

  • Mã ClientCertPKCS11

    chuỗi không bắt buộc

    Chrome 60 trở lên
  • ClientCertPattern

    CertificatePattern không bắt buộc

  • ClientCertProvisioningProfileId

    chuỗi không bắt buộc

    Chrome 93 trở lên
  • ClientCertRef

    chuỗi không bắt buộc

  • ClientCertType

    ClientCertificateType

  • Danh tính

    chuỗi không bắt buộc

  • Phía trong

    chuỗi không bắt buộc

  • Bên ngoài

    chuỗi không bắt buộc

    Loại EAP bên ngoài. Theo yêu cầu của ONC, nhưng có thể không được cung cấp khi dịch từ Shill.

  • Mật khẩu

    chuỗi không bắt buộc

  • SaveCredentials

    boolean không bắt buộc

  • ServerCAPEMs

    string[] không bắt buộc

  • ServerCARefs

    string[] không bắt buộc

  • SubjectMatch

    ManagedDOMString không bắt buộc

    Chrome 60 trở lên
  • UseProactiveKeyCaching

    boolean không bắt buộc

  • UseSystemCAs

    boolean không bắt buộc

EthernetProperties

Thuộc tính

  • Xác thực

    chuỗi không bắt buộc

    Phương thức xác thực được mạng Ethernet sử dụng. Giá trị có thể là None và 8021X.

  • AutoConnect

    boolean không bắt buộc

    Liệu có tự động kết nối mạng Ethernet hay không.

  • EAP (Giao thức xác thực có thể mở rộng)

    EAPProperties không bắt buộc

    Chế độ cài đặt EAP của mạng. Bắt buộc để xác thực 8021X.

EthernetStateProperties

Thuộc tính

FoundNetworkProperties

Thuộc tính

  • LongName

    chuỗi không bắt buộc

    Tên định dạng dài của đơn vị vận hành mạng.

  • NetworkId

    string

    Mã mạng.

  • ShortName

    chuỗi không bắt buộc

    Tên định dạng ngắn của đơn vị vận hành mạng.

  • Trạng thái

    string

    Khả năng sử dụng mạng.

  • Công nghệ

    string

    Truy cập công nghệ được mạng sử dụng.

GlobalPolicy

Thuộc tính

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean không bắt buộc

    Nếu đúng, chỉ những mạng chính sách mới có thể tự động kết nối. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnect

    boolean không bắt buộc

    Nếu đúng, chỉ mạng chính sách mới có thể được kết nối và không có mạng mới nào có thể được thêm hoặc định cấu hình. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean không bắt buộc

    Chrome 70 trở lên

    Nếu giá trị là true và một mạng được quản lý có trong danh sách mạng hiển thị, thì bạn chỉ có thể kết nối với mạng tuân thủ chính sách và không có mạng mới nào có thể được thêm hoặc định cấu hình. Giá trị mặc định là false.

  • BlockedHexSSIDs

    string[] không bắt buộc

    Chrome 86 trở lên

    Danh sách mạng bị chặn. Nghiêm cấm kết nối với các mạng bị chặn. Bạn có thể bỏ chặn mạng bằng cách chỉ định cấu hình mạng rõ ràng. Giá trị mặc định là danh sách trống.

IPConfigProperties

Thuộc tính

  • ExcludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng các khối IP trong ký hiệu CIDR, xem onc_spec.md để biết chi tiết.

  • Cổng

    chuỗi không bắt buộc

    Địa chỉ cổng vào được dùng cho cấu hình IP.

  • IPAddress

    chuỗi không bắt buộc

    Địa chỉ IP của kết nối. Có thể là địa chỉ IPv4 hoặc IPv6, tuỳ thuộc vào giá trị của Type.

  • IncludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng các khối IP trong ký hiệu CIDR, xem onc_spec.md để biết chi tiết.

  • NameServers

    string[] không bắt buộc

    Mảng địa chỉ được dùng cho máy chủ định danh.

  • RoutingPrefix

    số không bắt buộc

    Tiền tố định tuyến.

  • SearchDomains

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng chuỗi để phân giải tên, xem onc_spec.md để biết thông tin chi tiết.

  • Loại

    chuỗi không bắt buộc

    Loại cấu hình IP. Giá trị này có thể là IPv4 hoặc IPv6.

  • WebProxyAutoDiscoveryUrl

    chuỗi không bắt buộc

    URL cho tính năng Tự động phát hiện proxy WEb, như đã báo cáo qua DHCP.

IPConfigType

Enum

"DHCP"

"Tĩnh"

IssuerSubjectPattern

Thuộc tính

  • CommonName

    chuỗi không bắt buộc

    Nếu được đặt, thì giá trị khớp với tên thường gọi của chủ thể chứng chỉ.

  • Thành phố

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này khớp với vị trí chung của chủ thể chứng chỉ.

  • Tổ chức

    chuỗi không bắt buộc

    Nếu được đặt, giá trị được so khớp với tổ chức của chủ thể chứng chỉ. Ít nhất một tổ chức phải khớp với giá trị.

  • OrganizationalUnit

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này để khớp với đơn vị tổ chức của chủ thể chứng chỉ. Ít nhất một đơn vị tổ chức phải khớp với giá trị.

ManagedBoolean

Thuộc tính

  • Đang hoạt động

    boolean không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    boolean không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    boolean không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedCellularProperties

Thuộc tính

ManagedDOMString

Thuộc tính

  • Đang hoạt động

    chuỗi không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    chuỗi không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    chuỗi không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedDOMStringList

Thuộc tính

  • Đang hoạt động

    string[] không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    string[] không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    string[] không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedEthernetProperties

Thuộc tính

ManagedIPConfigProperties

Thuộc tính

ManagedIPConfigType

Thuộc tính

  • Đang hoạt động

    IPConfigType không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    IPConfigType không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    IPConfigType không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedLong

Thuộc tính

  • Đang hoạt động

    số không bắt buộc

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    số không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    số không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    số không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    số không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedManualProxySettings

Thuộc tính

ManagedProperties

Thuộc tính

ManagedProxyLocation

Thuộc tính

ManagedProxySettings

Thuộc tính

ManagedProxySettingsType

Thuộc tính

  • Đang hoạt động

    ProxySettingsType optional

    Giá trị đang hoạt động hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu DevicePolicy cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • DevicePolicy

    ProxySettingsType optional

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn mà từ đó giá trị thuộc tính hiệu quả được xác định.

  • SharedSetting

    ProxySettingsType optional

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu chính sách người dùng cho thuộc tính có tồn tại và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất của bộ chính sách). Giá trị mặc định là false.

  • UserPolicy

    ProxySettingsType optional

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    ProxySettingsType optional

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedThirdPartyVPNProperties

Thuộc tính

ManagedVPNProperties

Thuộc tính

ManagedWiFiProperties

Thuộc tính

ManualProxySettings

Thuộc tính

  • FTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy FTP.

  • HTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP.

  • BÓNG ĐÁ

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP bảo mật.

NetworkConfigProperties

Thuộc tính

NetworkFilter

Thuộc tính

  • đã định cấu hình

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng đã được định cấu hình (đã lưu). Giá trị mặc định là "false".

  • giới hạn

    số không bắt buộc

    Số mạng tối đa cần trả về. Giá trị mặc định là 1000 nếu bạn không chỉ định. Sử dụng 0 không giới hạn.

  • networkType

    Loại mạng

    Loại mạng cần trả về.

  • hiển thị

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng hiển thị (kết nối thực tế hoặc trong phạm vi). Giá trị mặc định là "false".

NetworkProperties

Thuộc tính

  • Mạng di động

    CellularProperties không bắt buộc

    Đối với mạng di động, các thuộc tính của mạng di động.

  • Có thể kết nối

    boolean không bắt buộc

    Liệu mạng có kết nối được hay không.

  • ConnectionState

    ConnectionStateType optional

    Trạng thái kết nối hiện tại của mạng.

  • ErrorState

    chuỗi không bắt buộc

    Trạng thái lỗi mạng được ghi lại gần đây nhất.

  • Ethernet

    EthernetProperties không bắt buộc

    Đối với mạng Ethernet, các thuộc tính của mạng Ethernet.

  • GUID

    string

    GUID của mạng.

  • IPAddressConfigType

    IPConfigType không bắt buộc

    Loại cấu hình địa chỉ IP của mạng.

  • IPConfigs

    IPConfigProperties[] không bắt buộc

    Cấu hình IP của mạng.

  • MacAddress

    chuỗi không bắt buộc

    Địa chỉ MAC của mạng.

  • Đo lượng dữ liệu

    boolean không bắt buộc

    Chrome 85 trở lên

    Liệu mạng có đo lượng dữ liệu hay không.

  • Tên

    chuỗi không bắt buộc

    Tên mạng thân thiện với người dùng.

  • NameServersConfigType

    IPConfigType không bắt buộc

    Loại cấu hình IP cho máy chủ định danh mà mạng sử dụng.

  • Mức độ ưu tiên

    số không bắt buộc

    Mức độ ưu tiên mạng.

  • ProxySettings

    ProxySettings không bắt buộc

    Chế độ cài đặt proxy của mạng.

  • RestrictedConnectivity

    boolean không bắt buộc

    Đối với mạng được kết nối, kết nối mạng với Internet có bị giới hạn hay không, ví dụ: nếu mạng nằm sau một cổng thông tin hoặc mạng di động chưa được kích hoạt.

  • SavedIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP đã nhận từ máy chủ DHCP trước khi áp dụng cấu hình IP tĩnh.

  • Nguồn

    chuỗi không bắt buộc

    Cho biết mạng có được định cấu hình hay không và cách thức định cấu hình. Các giá trị có thể là:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "Không" xung đột với việc tạo mã tiện ích, vì vậy chúng tôi phải sử dụng một chuỗi cho 'Nguồn' thay vì enum SourceType.

  • StaticIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP tĩnh của mạng.

  • TrafficCounterResetTime

    số không bắt buộc

    Chrome 125 trở lên

    Thời điểm bộ đếm lưu lượng truy cập được đặt lại lần gần đây nhất.

  • Loại

    Loại mạng

    Loại mạng.

  • VPN

    VPNProperties không bắt buộc

    Đối với mạng VPN, các thuộc tính VPN của mạng.

  • Wi-Fi

    WiFiProperties không bắt buộc

    Đối với mạng Wi-Fi, thuộc tính Wi-Fi của mạng.

NetworkStateProperties

Thuộc tính

NetworkType

Enum

"Tất cả"

"Di động"

"Ethernet"

"Chia sẻ Internet"

"VPN"

"Không dây"

"WiFi"

PaymentPortal

Thuộc tính

  • Phương thức

    string

    Phương thức HTTP để sử dụng cho cổng thanh toán.

  • PostData

    chuỗi không bắt buộc

    Dữ liệu đăng để gửi đến cổng thanh toán. Bỏ qua trừ khi Method là POST.

  • URL

    chuỗi không bắt buộc

    URL cổng thanh toán.

ProxyLocation

Thuộc tính

  • Máy chủ

    string

    Máy chủ lưu trữ địa chỉ IP proxy.

  • Cổng

    số

    Cổng sử dụng cho proxy.

ProxySettings

Thuộc tính

  • ExcludeDomains

    string[] không bắt buộc

    Miền và máy chủ lưu trữ không áp dụng chế độ cài đặt proxy thủ công.

  • Thủ công

    ManualProxySettings (Cài đặt proxy thủ công) không bắt buộc

    Cài đặt proxy thủ công – chỉ được sử dụng cho cài đặt proxy Manual.

  • Uỷ ban hành động chính trị (PAC)

    chuỗi không bắt buộc

    URL cho tệp tự động định cấu hình proxy.

  • Loại chế độ cài đặt proxy.

ProxySettingsType

Enum

"Trực tiếp"

"Thủ công"

"PAC"

"WPAD"

SIMLockStatus

Thuộc tính

  • LockEnabled

    boolean

    Liệu tính năng khoá SIM có được bật hay không.

  • LockType

    string

    Trạng thái khoá SIM – có thể là các giá trị 'sim-pin', 'sim-puk' và ''.

  • RetriesLeft

    số không bắt buộc

    Số lần khoá mã PIN được cho phép trước khi yêu cầu PUK để mở khoá SIM.

ThirdPartyVPNProperties

Thuộc tính

  • ExtensionID

    string

    Mã của tiện ích nhà cung cấp VPN bên thứ ba.

  • ProviderName

    chuỗi không bắt buộc

    Tên nhà cung cấp VPN.

VPNProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu có tự động kết nối mạng VPN hay không.

  • Máy chủ

    chuỗi không bắt buộc

    Máy chủ VPN.

  • Loại

    chuỗi không bắt buộc

    Loại VPN. Giá trị này không được là một giá trị enum vì "L2TP-IPSec". Thao tác này là không bắt buộc đối với NetworkConfigProperties được chuyển đến setProperties. Bạn có thể dùng thao tác này để chỉ đặt các thuộc tính cụ thể.

VPNStateProperties

Thuộc tính

WiFiProperties

Thuộc tính

  • AllowGatewayARPPolling

    boolean không bắt buộc

    Liệu thăm dò ARP của cổng mặc định có được cho phép hay không. Giá trị mặc định là đúng.

  • AutoConnect

    boolean không bắt buộc

    Liệu có tự động kết nối mạng Wi-Fi khi trong phạm vi phủ sóng hay không.

  • BSSID (mã định danh của bộ dịch vụ cơ bản)

    chuỗi không bắt buộc

    BSSID của điểm truy cập được liên kết.

  • EAP (Giao thức xác thực có thể mở rộng)

    EAPProperties không bắt buộc

    Thuộc tính EAP mạng. Bắt buộc đối với các mạng WEP-8021X và WPA-EAP.

  • Tần suất

    số không bắt buộc

    Tần số hoạt động của dịch vụ Wi-Fi tính bằng MHz. Đối với các mạng được kết nối, đó là tần suất hiện tại của mạng được kết nối. Nếu không, tần suất của BSS tốt nhất hiện có.

  • FrequencyList

    number[] không bắt buộc

    Chứa tất cả tần suất hoạt động gần đây của mạng Wi-Fi.

  • HexSSID

    chuỗi không bắt buộc

    Bản sao được mã hoá theo hệ thập lục phân của SSID mạng.

  • HiddenSSID

    boolean không bắt buộc

    Liệu SSID mạng có được truyền phát hay không.

  • Cụm mật khẩu

    chuỗi không bắt buộc

    Chrome 66 trở lên

    Cụm mật khẩu cho kết nối WEP/WPA/WPA2. Bạn chỉ có thể đặt thuộc tính này – các thuộc tính do getProperties trả về sẽ không chứa giá trị này.

  • RoamThreshold

    số không bắt buộc

    Không được dùng nữa, bị bỏ qua.

  • SSID

    chuỗi không bắt buộc

    SSID mạng.

  • Bảo mật

    chuỗi không bắt buộc

    Loại bảo mật mạng.

  • SignalStrength

    số không bắt buộc

    Cường độ tín hiệu mạng.

WiFiStateProperties

Thuộc tính

WiMAXProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu có kết nối mạng tự động hay không.

  • EAP (Giao thức xác thực có thể mở rộng)

    EAPProperties không bắt buộc

    Thuộc tính EAP mạng.

Phương thức

createNetwork()

Lời hứa 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

Tạo một cấu hình mạng mới từ các tài sản. Nếu đã có một mạng được định cấu hình phù hợp, thì quá trình này sẽ không thành công. Nếu không, hệ thống sẽ trả về GUID của mạng mới.

Tham số

  • đã chia sẻ

    boolean

    Nếu là true, hãy chia sẻ cấu hình mạng này với người dùng khác.

    Tuỳ chọn này chỉ hiển thị với Giao diện người dùng web của Chrome.* Khi được ứng dụng gọi, false là giá trị duy nhất được phép.

  • các tài sản

    NetworkConfigProperties

    Các thuộc tính để định cấu hình mạng mới.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: string) => void

    • kết quả

      string

Giá trị trả về

  • Cam kết<string>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
)

Tắt mọi thiết bị khớp với loại mạng đã chỉ định. Xem ghi chú cho enableNetworkType.

Tham số

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
)

Cho phép mọi thiết bị phù hợp với loại mạng đã chỉ định. Lưu ý: Loại mạng này có thể đại diện cho nhiều loại mạng (ví dụ: "Không dây").

Tham số

forgetNetwork()

Lời hứa 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

Xoá cấu hình mạng bằng cách xoá mọi thuộc tính đã định cấu hình cho mạng bằng GUID networkGuid. Dữ liệu này cũng có thể bao gồm mọi mạng khác có giá trị nhận dạng trùng khớp (ví dụ: SSID và Bảo mật của Wi-Fi). Nếu không có cấu hình nào như vậy, lỗi sẽ được đặt và thao tác sẽ không thành công.

Trong các phiên kiosk, phương thức này sẽ không thể quên các cấu hình mạng dùng chung.

Tham số

  • networkGuid

    string

    GUID của mạng cần bỏ qua.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCaptivePortalStatus()

Lời hứa 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

Trả về trạng thái cổng bị khoá cho mạng khớp với "networkGuid".

Tham số

  • networkGuid

    string

    Mã GUID của mạng để lấy trạng thái của trang xác thực.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: CaptivePortalStatus) => void

Giá trị trả về

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getDeviceStates()

Lời hứa 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Trả về trạng thái của các thiết bị mạng hiện có.

Tham số

Giá trị trả về

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getGlobalPolicy()

Lời hứa 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

Lấy các thuộc tính chính sách chung. Các thuộc tính này dự kiến sẽ không thay đổi trong một phiên.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: GlobalPolicy) => void

Giá trị trả về

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getManagedProperties()

Lời hứa 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

Lấy các tài sản hợp nhất của mạng có id networkGuid từ các nguồn: Chế độ cài đặt của người dùng, chế độ cài đặt dùng chung, chính sách người dùng, chính sách thiết bị và các chế độ cài đặt hiện đang hoạt động.

Tham số

  • networkGuid

    string

    Mã GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: ManagedProperties) => void

Giá trị trả về

  • Promise&lt;ManagedProperties&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getNetworks()

Lời hứa 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

Trả về danh sách đối tượng mạng có cùng thuộc tính do getState cung cấp. Bộ lọc được cung cấp để chỉ định loại mạng được trả về và để giới hạn số lượng mạng. Hệ thống sắp xếp mạng dựa trên mức độ ưu tiên, trong đó mạng kết nối hoặc kết nối được liệt kê đầu tiên.

Tham số

Giá trị trả về

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getProperties()

Lời hứa 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

Lấy tất cả các thuộc tính của mạng có id networkGuid. Bao gồm tất cả các thuộc tính của mạng (giá trị chỉ đọc và giá trị đọc/ghi).

Tham số

  • networkGuid

    string

    Mã GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: NetworkProperties) => void

Giá trị trả về

  • Promise&lt;NetworkProperties&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getState()

Lời hứa 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

Lấy các thuộc tính chỉ đọc được lưu vào bộ nhớ đệm của mạng với id networkGuid. Đây là một hàm có hiệu suất cao hơn so với getProperties. Hàm này yêu cầu phải thực hiện một lượt khứ hồi để truy vấn hệ thống kết nối mạng con. Các thuộc tính sau được trả về cho tất cả mạng: GUID, Type, Name, WiFi.Security. Các thuộc tính bổ sung được cung cấp cho các mạng hiển thị: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnical, Cellular.activateState, Cellular.CellularState.

Tham số

  • networkGuid

    string

    Mã GUID của mạng để lấy thuộc tính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: NetworkStateProperties) => void

Giá trị trả về

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
)

Yêu cầu hệ thống mạng con quét để tìm các mạng mới và cập nhật danh sách mà getVisibleNetworks trả về. Đây chỉ là một yêu cầu: hệ thống con của mạng có thể chọn bỏ qua yêu cầu này. Nếu danh sách được cập nhật, thì sự kiện onNetworkListChanged sẽ được kích hoạt.

Tham số

  • networkType

    NetworkType không bắt buộc

    Chrome 63 trở lên

    Nếu được cung cấp, hãy yêu cầu quét dành riêng cho loại đó. Đối với mạng di động, hệ thống sẽ yêu cầu quét mạng di động nếu được hỗ trợ.

setProperties()

Lời hứa 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

Đặt thuộc tính của mạng có mã networkGuid. Điều này chỉ hợp lệ đối với các mạng đã định cấu hình (Nguồn != Không có). Các mạng hiển thị chưa được định cấu hình nên sử dụng createNetwork. Trong các phiên kiosk, bạn sẽ không gọi được phương thức này trên một mạng dùng chung.

Tham số

  • networkGuid

    string

    Giá trị nhận dạng duy nhất trên toàn cầu (GUID) của mạng cần đặt thuộc tính.

  • các tài sản

    NetworkConfigProperties

    Các thuộc tính cần đặt.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startConnect()

Lời hứa 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

Bắt đầu kết nối mạng bằng networkGuid.

Tham số

  • networkGuid

    string

    Mã GUID của mạng cần kết nối.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startDisconnect()

Lời hứa 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

Bắt đầu ngắt kết nối khỏi mạng bằng networkGuid.

Tham số

  • networkGuid

    string

    Mã GUID của mạng cần huỷ kết nối.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

Được kích hoạt khi danh sách thiết bị đã thay đổi hoặc bất kỳ thuộc tính trạng thái thiết bị nào đã thay đổi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    () => void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

Được kích hoạt khi danh sách mạng thay đổi. Gửi danh sách đầy đủ các giá trị nhận dạng duy nhất trên toàn cầu (GUID) cho tất cả các mạng hiện tại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (changes: string[]) => void

    • các thay đổi

      chuỗi[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

Được kích hoạt khi thuộc tính thay đổi trên bất kỳ mạng nào. Gửi danh sách GUID cho các mạng có thuộc tính đã thay đổi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (changes: string[]) => void

    • các thay đổi

      chuỗi[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

Được kích hoạt khi quá trình phát hiện cổng thông tin cho mạng hoàn tất. Gửi GUID của mạng và trạng thái của trang xác thực tương ứng.

Tham số