chrome.networking.onc

Mô tả

API chrome.networking.onc được dùng để thiết lập các kết nối mạng (Di động, Ethernet, VPN hoặc Wi-Fi). API này có trong các phiên kiosk Chrome OS tự động chạy.

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 từ điển và giá trị enum đều sử dụng quy ước UpperCamelCase để 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ỉ dành cho ChromeOS

Loại

ActivationStateType

Enum

"Đã kích hoạt"

"Đang kích hoạt"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Không xác định"

"Không hoạt động"

"Trực tuyến"

"Portal"

"ProxyAuthRequired"

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 của hãng vận chuyển.

  • 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

    Mạng có cho phép chuyển vùng hay không.

  • AutoConnect

    boolean không bắt buộc

    Có nên tự động kết nối mạng di động hay không (khi nằm trong vùng phủ sóng).

  • Gia đình

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

    Dòng 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ở được tải trong modem di động.

  • FoundNetworks

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

    Danh sách các mạng được 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

    Phiên bản phần cứng của modem di động.

  • HomeProvider

    CellularProviderProperties không bắt buộc

    Thông tin về nhà mạng đã phát hành thẻ SIM hiện đang được lắp 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ì đó là 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 các mạng GSM trong gia đình.

  • SIMPresent

    boolean không bắt buộc

    Thẻ SIM có được lắp hay không.

  • Đang quét

    boolean không bắt buộc

    Chrome 63 trở lên

    True khi quá trình quét mạng di động đang diễn ra.

  • ServingOperator

    CellularProviderProperties không bắt buộc

    Thông tin về nhà mạng mà modem hiện đang đăng ký.

  • SignalStrength

    number 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

    Mạng di động có hỗ trợ quét hay không.

CellularProviderProperties

Thuộc tính

  • Mã

    chuỗi

    Mã nhận dạng mạng di động dưới dạng một chuỗi nối đơn giản của MCC (Mã quốc gia cho mạng 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

    chuỗi

    Tên của nhà mạng.

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 khớp với mẫu này.

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

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu mà chế độ cài đặt tổ chức phát hành X.509 phải khớp.

  • 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 các tổ chức này ký để khớp với mẫu này.

  • Tiêu đề

    IssuerSubjectPattern không bắt buộc

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

ClientCertificateType

Enum

"Ref"

"Mẫu"

ConnectionStateType

Enum

"Đã kết nối"

"Đang kết nối"

"NotConnected"

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 Loại = Di động và SIMPresent = True.

  • SIMPresent

    boolean không bắt buộc

    Chrome 62 trở lên

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

  • Đang quét

    boolean không bắt buộc

    Đặt xem thiết bị có được bật hay không. Đúng nếu thiết bị hiện đang quét.

  • Tiểu bang

    DeviceStateType

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

  • Loại

    NetworkType

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

DeviceStateType

Enum

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

"Đã tắt"
Thiết bị đã được khởi động 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

  • ClientCertPKCS11Id

    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

  • của bản thân

    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. Do ONC yêu cầu, 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 mà mạng Ethernet sử dụng. Các giá trị có thể có là None và 8021X.

  • AutoConnect

    boolean không bắt buộc

    Có nên tự động kết nối mạng Ethernet hay không.

  • EAP

    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 dài của nhà mạng.

  • NetworkId

    chuỗi

    Mã mạng.

  • ShortName

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

    Tên ngắn của nhà khai thác mạng.

  • Trạng thái

    chuỗi

    Phạm vi cung cấp mạng truyền hình.

  • Công nghệ

    chuỗi

    Công nghệ truy cập mà mạng sử dụng.

GlobalPolicy

Thuộc tính

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean không bắt buộc

    Nếu bạn đặt thành true, chỉ các 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ỉ các mạng chính sách mới có thể được kết nối và không thể thêm hoặc định cấu hình mạng mới. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean không bắt buộc

    Chrome 70 trở lên

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

  • BlockedHexSSIDs

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

    Chrome 86 trở lên

    Danh sách các mạng bị chặn. Bạn không được phép 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 một 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 dưới dạng ký hiệu CIDR, hãy xem onc_spec.md để biết thông tin chi tiết.

  • Cổng

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

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

  • IPAddress

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

    Địa chỉ IP cho một 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 dưới dạng ký hiệu CIDR, hãy xem onc_spec.md để biết thông tin chi tiết.

  • NameServers

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

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

  • RoutingPrefix

    number 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 các chuỗi để phân giải tên, hãy 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. Có thể là IPv4 hoặc IPv6.

  • WebProxyAutoDiscoveryUrl

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

    URL cho giao thức Tự động phát hiện proxy web, như được 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, giá trị này sẽ khớp với tên phổ biến của chủ đề chứng chỉ.

  • Thành phố

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

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

  • Tổ chức

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

    Nếu được đặt, giá trị này sẽ so khớp với các tổ chức của chủ đề 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 sẽ khớp với các đơn vị tổ chức của chủ đề 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 mà trình quản lý cấu hình mạng hiện đang sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    DevicePolicy cho tài sản có tồn tại hay không và có cho phép chỉnh sửa tài sản hay không (tức là giá trị tài sản được đề xuất theo 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 thực tế đượ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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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 mà trình quản lý cấu hình mạng hiện đang sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    DevicePolicy cho tài sản có tồn tại hay không và có cho phép chỉnh sửa tài sản hay không (tức là giá trị tài sản được đề xuất theo 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 thực tế đượ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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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 mà trình quản lý cấu hình mạng hiện đang sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    DevicePolicy cho tài sản có tồn tại hay không và có cho phép chỉnh sửa tài sản hay không (tức là giá trị tài sản được đề xuất theo 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 thực tế đượ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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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 mà trình quản lý cấu hình mạng hiện đang sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    DevicePolicy cho tài sản có tồn tại hay không và có cho phép chỉnh sửa tài sản hay không (tức là giá trị tài sản được đề xuất theo 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 thực tế đượ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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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

    number không bắt buộc

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

  • DeviceEditable

    boolean không bắt buộc

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

  • DevicePolicy

    number 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 thực tế được xác định.

  • SharedSetting

    number 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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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

    number 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

    number 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 không bắt buộc

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

  • DeviceEditable

    boolean không bắt buộc

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

  • DevicePolicy

    ProxySettingsType 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 thực tế được xác định.

  • SharedSetting

    ProxySettingsType 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 có UserPolicy cho tài sản hay không và liệu chính sách đó có cho phép chỉnh sửa tài sản 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 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

    ProxySettingsType 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.

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.

  • SOCKS

    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 an toàn.

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 đã định cấu hình (đã lưu). Giá trị mặc định là "false".

  • giới hạn

    number không bắt buộc

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

  • networkType

    NetworkType

    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ị (được kết nối thực tế hoặc nằm 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 mạng di động.

  • Có thể kết nối

    boolean không bắt buộc

    Mạng có kết nối được hay không.

  • ConnectionState

    ConnectionStateType không bắt buộc

    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 mạng Ethernet.

  • GUID

    chuỗi

    Mã 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

    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 dễ sử dụng.

  • NameServersConfigType

    IPConfigType không bắt buộc

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

  • Mức độ ưu tiên

    number không bắt buộc

    Mức độ ưu tiên của 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ột mạng được kết nối, liệu kết nối mạng với Internet có bị hạn chế hay không, ví dụ: nếu mạng nằm sau một cổng 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 được 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 định cấu hình mạng. Các giá trị có thể là:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" xung đột với quá trình tạo mã tiện ích, vì vậy, chúng ta phải sử dụng một chuỗi cho "Source" thay vì một enum SourceType.

  • StaticIPConfig

    IPConfigProperties không bắt buộc

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

  • TrafficCounterResetTime

    number không bắt buộc

    Chrome 125 trở lên

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

  • Loại

    NetworkType

    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, các thuộc tính Wi-Fi của mạng.

NetworkStateProperties

Thuộc tính

NetworkType

Enum

"Tất cả"

"Di động"

"Ethernet"

"Tether"

"VPN"

"Không dây"

"Wi-Fi"

PaymentPortal

Thuộc tính

  • Phương thức

    chuỗi

    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 bài đăng cần 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ủa cổng thanh toán.

ProxyLocation

Thuộc tính

  • Máy chủ

    chuỗi

    Máy chủ địa chỉ IP của proxy.

  • Cổng

    số

    Cổng cần sử dụng cho proxy.

ProxySettings

Thuộc tính

  • ExcludeDomains

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

    Các miền và máy chủ không sử dụng chế độ cài đặt proxy thủ công.

  • Thủ công

    ManualProxySettings không bắt buộc

    Chế độ cài đặt proxy thủ công – chỉ dùng cho chế độ 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

    Có bật chế độ khoá SIM hay không.

  • LockType

    chuỗi

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

  • RetriesLeft

    number không bắt buộc

    Số lần thử khoá bằng mã PIN được phép trước khi bạn phải dùng mã PUK để mở khoá SIM.

ThirdPartyVPNProperties

Thuộc tính

  • ExtensionID

    chuỗi

    Mã nhận dạng 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

    Có nên 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. Đây không thể là một enum do "L2TP-IPSec". Đây là tuỳ chọn cho NetworkConfigProperties được truyền đến setProperties. Bạn có thể dùng tuỳ chọn 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

    Không dùng nữa kể từ Chrome 131

    Đã bị xoá trong phiên bản M131. Hiện không có hoạt động thăm dò ARP nào đang diễn ra.

  • AutoConnect

    boolean không bắt buộc

    Có nên tự động kết nối mạng Wi-Fi khi ở trong phạm vi 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

    EAPProperties không bắt buộc

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

  • Tần suất

    number 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 đã kết nối, đây là tần số hiện tại mà mạng đang kết nối. Nếu không, tần số 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 số hoạt động được phát hiện gần đây cho mạng Wi-Fi.

  • HexSSID

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

    Bản sao được mã hoá HEX của SSID mạng.

  • HiddenSSID

    boolean không bắt buộc

    Bộ định danh thiết đặt dịch vụ (SSID) của mạng có được 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 các 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

    number không bắt buộc

    Không dùng nữa, bị bỏ qua.

  • SSID

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

    SSID của mạng.

  • Bảo mật

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

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

  • SignalStrength

    number 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

    Mạng có nên được kết nối tự động hay không.

  • EAP

    EAPProperties không bắt buộc

    Các thuộc tính EAP của mạng.

Phương thức

createNetwork()

Promise 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

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

Thông số

  • đã chia sẻ

    boolean

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

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

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

  • callback

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

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

    (result: string) => void

    • kết quả

      chuỗi

Giá trị trả về

  • Promise<string>

    Chrome 125 trở lên

    Các promise 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,
): void

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

Thông số

enableNetworkType()

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

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

Thông số

forgetNetwork()

Promise 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

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 có mã 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, hệ thống sẽ đặt một lỗi 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ể xoá các cấu hình mạng dùng chung.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng cần xoá.

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

Trả về trạng thái trang xác thực cho mạng khớp với "networkGuid".

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để nhận trạng thái trang xác thực.

  • callback

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

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

    (result: CaptivePortalStatus) => void

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

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

Thông số

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

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

Thông số

  • callback

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

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

    (result: GlobalPolicy) => void

Giá trị trả về

  • Promise<GlobalPolicy>

    Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

Lấy các thuộc tính đã hợp nhất của mạng có networkGuid mã nhận dạng từ các nguồn: Chế độ cài đặt 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à chế độ cài đặt hiện đang hoạt động.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để nhận các thuộc tính.

  • callback

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

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

    (result: ManagedProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

Trả về danh sách các đối tượng mạng có cùng thuộc tính do getState cung cấp. Một 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 các mạng theo mức độ ưu tiên, trong đó các mạng đã kết nối hoặc đang kết nối được liệt kê trước.

Thông số

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

Lấy tất cả các thuộc tính của mạng có networkGuid mã nhận dạng. 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).

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để nhận các thuộc tính.

  • callback

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

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

    (result: NetworkProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

Lấy các thuộc tính chỉ đọc được lưu vào bộ nhớ đệm của mạng có networkGuid id. Đây là một hàm có hiệu suất cao hơn getProperties, yêu cầu một chuyến khứ hồi để truy vấn hệ thống con mạng. Các thuộc tính sau được trả về cho tất cả cá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.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để nhận các thuộc tính.

  • callback

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

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

    (result: NetworkStateProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Các promise 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,
): void

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

Thông số

  • networkType

    NetworkType không bắt buộc

    Chrome 63 trở lên

    Nếu được cung cấp, yêu cầu quét theo loại cụ thể. Đố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()

Promise 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

Đặt các thuộc tính của mạng có mã nhận dạng networkGuid. Điều này chỉ hợp lệ cho các mạng được định cấu hình (Nguồn != None). 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, việc gọi phương thức này trên một mạng dùng chung sẽ không thành công.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để đặt các thuộc tính.

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

Thông số

  • networkGuid

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Các promise 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()

Promise 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

Thông số

  • networkGuid

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Các promise 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,
)

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.

Thông số

  • callback

    hàm

    Tham số callback 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 GUID cho tất cả các mạng hiện tại.

Thông số

  • callback

    hàm

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

    (changes: string[]) => void

    • các thay đổi

      string[]

onNetworksChanged

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

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

Thông số

  • callback

    hàm

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

    (changes: string[]) => void

    • các thay đổi

      string[]

onPortalDetectionCompleted

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

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

Thông số