chrome.networking.onc

Opis

Interfejs API chrome.networking.onc służy do konfigurowania połączeń sieciowych (komórkowych, Ethernet, VPN lub Wi-Fi). Interfejs API jest dostępny w automatycznie uruchamianych sesjach kiosku w ChromeOS.

Konfiguracje połączeń sieciowych są określane zgodnie ze specyfikacją Open Network Configuration (ONC).

UWAGA: większość właściwości słownika i wartości wyliczenia używa stylu UpperCamelCase, aby odpowiadać specyfikacji ONC, a nie konwencji JavaScript lowerCamelCase.

Uprawnienia

networking.onc

Dostępność

Chrome 59 lub nowszy Tylko w ChromeOS

Typy

ActivationStateType

Typ wyliczeniowy

„Aktywowany”

„Aktywowanie”

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Typ wyliczeniowy

"Nieznany"

„Offline”

„Online”

„Portal”

"ProxyAuthRequired"

CellularProperties

Właściwości

  • ActivationState

    ActivationStateType opcjonalny

    Stan aktywacji konta operatora.

  • ActivationType

    ciąg znaków opcjonalny

    Typ aktywacji sieci komórkowej.

  • AllowRoaming

    logiczna opcjonalna

    Czy roaming jest dozwolony w ramach sieci.

  • AutoConnect

    logiczna opcjonalna

    Określa, czy sieć komórkowa ma być połączona automatycznie (gdy jest w zasięgu).

  • Rodzinny

    ciąg znaków opcjonalny

    Rodzina technologii urządzeń komórkowych: CDMA lub GSM.

  • FirmwareRevision

    ciąg znaków opcjonalny

    Wersja oprogramowania układowego załadowana w modemie komórkowym.

  • FoundNetworks

    FoundNetworkProperties[] opcjonalnie

    Lista sieci znalezionych podczas ostatniego skanowania sieci.

  • HardwareRevision

    ciąg znaków opcjonalny

    Wersja sprzętowa modemu komórkowego.

  • HomeProvider

    CellularProviderProperties opcjonalnie

    Informacje o operatorze, który wydał kartę SIM aktualnie zainstalowaną w modemie.

  • Producent

    ciąg znaków opcjonalny

    Producent modemu komórkowego.

  • ModelID

    ciąg znaków opcjonalny

    Identyfikator modelu modemu komórkowego.

  • NetworkTechnology

    ciąg znaków opcjonalny

    Jeśli modem jest zarejestrowany w sieci, wyświetlana jest obecnie używana technologia sieciowa.

  • PaymentPortal

    PaymentPortal opcjonalny

    Portal płatności online, którego użytkownik może używać do rejestracji w programie lub do modyfikacji abonamentu na dane mobilne.

  • RoamingState

    ciąg znaków opcjonalny

    Stan roamingu modemu komórkowego w bieżącej sieci.

  • SIMLockStatus

    SIMLockStatus opcjonalnie

    Stan blokady karty SIM w sieciach rodzinnych GSM.

  • SIMPresent

    logiczna opcjonalna

    czy jest karta SIM.

  • Skanowanie

    logiczna opcjonalna

    Chrome 63 lub nowszy

    Wartość TRUE, gdy trwa skanowanie sieci komórkowej.

  • ServingOperator

    CellularProviderProperties opcjonalnie

    Informacje o operatorze, w którego sieci modem jest obecnie zarejestrowany.

  • SignalStrength

    number opcjonalny

    bieżąca siła sygnału sieci;

  • SupportNetworkScan

    logiczna opcjonalna

    Czy sieć komórkowa obsługuje skanowanie.

CellularProviderProperties

Właściwości

  • Kod

    ciąg znaków

    Identyfikator sieci komórkowej jako proste ciągu znaków kodu MCC (kod kraju komórkowego) i kodu MNC (kod sieci komórkowej).

  • Kraj

    ciąg znaków opcjonalny

    Dwuliterowy kod kraju.

  • Nazwa

    ciąg znaków

    Nazwa operatora.

CellularStateProperties

Właściwości

CertificatePattern

Właściwości

  • EnrollmentURI

    string[] opcjonalnie

    Lista identyfikatorów URI, do których użytkownik może zostać przekierowany, jeśli nie zostanie znaleziony żaden certyfikat zgodny z tym wzorcem.

  • Wystawca

    IssuerSubjectPattern opcjonalnie

    Jeśli jest ustawiony, to wzór, według którego należy dopasowywać ustawienia wystawcy X.509.

  • IssuerCARef

    string[] opcjonalnie

    Lista certyfikatów urzędu certyfikacji wystawcy certyfikatów. Aby pasował do tego wzorca, certyfikat musi być podpisany przez jeden z nich.

  • Temat

    IssuerSubjectPattern opcjonalnie

    Jeśli ustawiono, to wzór, do którego należy dopasowywać ustawienia tematu X.509.

ClientCertificateType

Typ wyliczeniowy

„Ref”

„Wzór”

ConnectionStateType

Typ wyliczeniowy

„Połączony”

„Łączenie”

"NotConnected"

DeviceStateProperties

Właściwości

  • SIMLockStatus

    SIMLockStatus opcjonalnie

    Chrome 62 lub nowszy

    Stan blokady karty SIM, jeśli Type = Cellular i SIMPresent = Prawda.

  • SIMPresent

    logiczna opcjonalna

    Chrome 62 lub nowszy

    Ustaw na obecność karty SIM, jeśli typ urządzenia to komórkowy.

  • Skanowanie

    logiczna opcjonalna

    Ustaw, czy urządzenie jest włączone. Prawda, jeśli urządzenie aktualnie skanuje.

  • Bieżący stan urządzenia.

  • Typ sieci powiązanej z urządzeniem (komórkowa, Ethernet lub Wi-Fi).

DeviceStateType

Typ wyliczeniowy

„Uninitialized” (Nieinicjalizowany)
Urządzenie jest dostępne, ale nie zostało zainicjowane.

„Wyłączone”
Urządzenie jest zainicjowane, ale nie jest włączone.

„Włączanie”
Włączony stan został żądany, ale nie został ukończony.

„Włączone”
Urządzenie jest włączone.

„Zabronione”
Urządzenie jest zabronione.

EAPProperties

Właściwości

  • AnonymousIdentity

    ciąg znaków opcjonalny

  • ClientCertPKCS11Id

    ciąg znaków opcjonalny

    Chrome 60+
  • ClientCertPattern

    CertificatePattern opcjonalnie

  • ClientCertProvisioningProfileId

    ciąg znaków opcjonalny

    Chrome 93 lub nowszy
  • ClientCertRef

    ciąg znaków opcjonalny

  • ClientCertType

    ClientCertificateType

  • Tożsamość

    ciąg znaków opcjonalny

  • Inner

    ciąg znaków opcjonalny

  • Outer

    ciąg znaków opcjonalny

    Typ zewnętrznego EAP. Wymagane przez ONC, ale może nie być podawane podczas tłumaczenia z Shill.

  • Hasło

    ciąg znaków opcjonalny

  • SaveCredentials

    logiczna opcjonalna

  • ServerCAPEMs

    string[] opcjonalnie

  • ServerCARefs

    string[] opcjonalnie

  • SubjectMatch

    ManagedDOMString opcjonalnie

    Chrome 60+
  • UseProactiveKeyCaching

    logiczna opcjonalna

  • UseSystemCAs

    logiczna opcjonalna

EthernetProperties

Właściwości

  • Uwierzytelnianie

    ciąg znaków opcjonalny

    Metoda uwierzytelniania używana przez sieć Ethernet. Możliwe wartości to None i 8021X.

  • AutoConnect

    logiczna opcjonalna

    Określa, czy sieć Ethernet ma być połączona automatycznie.

  • Program wcześniejszego dostępu

    EAPProperties opcjonalny

    Ustawienia EAP sieci. Wymagany do uwierzytelniania 8021X.

EthernetStateProperties

Właściwości

FoundNetworkProperties

Właściwości

  • LongName

    ciąg znaków opcjonalny

    Długa nazwa operatora sieci.

  • NetworkId

    ciąg znaków

    Identyfikator sieci.

  • ShortName

    ciąg znaków opcjonalny

    Krótka nazwa operatora sieci.

  • Stan

    ciąg znaków

    Dostępność sieci.

  • Technologia

    ciąg znaków

    Technologia dostępu używana przez sieć.

GlobalPolicy

Właściwości

  • AllowOnlyPolicyNetworksToAutoconnect

    logiczna opcjonalna

    Jeśli to pole ma wartość Prawda, automatycznie łączyć się mogą tylko sieci z zasadami. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnect

    logiczna opcjonalna

    Jeśli wartość to prawda, można łączyć się tylko z sieciami z zasadami. Nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    logiczna opcjonalna

    Chrome 70 lub nowszy

    Jeśli wartość to prawda, a na liście widocznych sieci jest dostępna sieć zarządzana, można połączyć się tylko z sieciami określonymi w zasadach. Nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • BlockedHexSSIDs

    string[] opcjonalnie

    Chrome 86 lub nowszy

    Lista zablokowanych sieci. Połączenia z zablokowanymi sieciami są niedozwolone. Sieci można odblokować, podając ich dokładną konfigurację. Domyślnie jest to pusta lista.

IPConfigProperties

Właściwości

  • ExcludedRoutes

    string[] opcjonalnie

    Chrome 76 lub nowszy

    Tablica bloków adresów IP w notacji CIDR (szczegóły znajdziesz w pliku onc_spec.md).

  • Brama

    ciąg znaków opcjonalny

    Adres bramy używany do konfiguracji IP.

  • IPAddress

    ciąg znaków opcjonalny

    Adres IP połączenia. Może to być adres IPv4 lub IPv6, w zależności od wartości parametru Type.

  • IncludedRoutes

    string[] opcjonalnie

    Chrome 76 lub nowszy

    Tablica bloków adresów IP w notacji CIDR (szczegóły znajdziesz w pliku onc_spec.md).

  • NameServers

    string[] opcjonalnie

    Tablica adresów używanych na potrzeby serwerów nazw.

  • RoutingPrefix

    number opcjonalny

    Prefiks routingu.

  • SearchDomains

    string[] opcjonalnie

    Chrome 76 lub nowszy

    Tablica ciągów znaków do rozwiązywania nazw. Szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • Typ

    ciąg znaków opcjonalny

    Typ konfiguracji adresu IP. Może to być IPv4 lub IPv6.

  • WebProxyAutoDiscoveryUrl

    ciąg znaków opcjonalny

    Adres URL protokołu WPAD (Web Proxy Auto-Discovery), jak podano w DHCP.

IPConfigType

Typ wyliczeniowy

„DHCP”

„Static”

IssuerSubjectPattern

Właściwości

  • CommonName

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, z którą ma być dopasowywana nazwa domeny w certyfikacie.

  • Miejscowość

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, z którą ma być dopasowywana wspólna lokalizacja podmiotu certyfikatu.

  • Organizacja

    ciąg znaków opcjonalny

    Jeśli ustawiona, wartość, z którą porównywane są organizacje podmiotu certyfikatu. Wartość powinna pasować do co najmniej jednej organizacji.

  • OrganizationalUnit

    ciąg znaków opcjonalny

    Jeśli ustawiona, wartość, do której mają być dopasowywane jednostki organizacyjne podmiotu certyfikatu. Co najmniej 1 jednostka organizacyjna powinna odpowiadać wartości.

ManagedBoolean

Właściwości

  • Aktywne

    logiczna opcjonalna

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    logiczna opcjonalna

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    logiczna opcjonalna

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    logiczna opcjonalna

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    logiczna opcjonalna

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedCellularProperties

Właściwości

ManagedDOMString

Właściwości

  • Aktywne

    ciąg znaków opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    ciąg znaków opcjonalny

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    ciąg znaków opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ciąg znaków opcjonalny

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    ciąg znaków opcjonalny

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedDOMStringList

Właściwości

  • Aktywne

    string[] opcjonalnie

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    string[] opcjonalnie

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    string[] opcjonalnie

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    string[] opcjonalnie

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    string[] opcjonalnie

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedEthernetProperties

Właściwości

ManagedIPConfigProperties

Właściwości

ManagedIPConfigType

Właściwości

  • Aktywne

    IPConfigType opcjonalnie

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    IPConfigType opcjonalnie

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    IPConfigType opcjonalnie

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    IPConfigType opcjonalnie

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    IPConfigType opcjonalnie

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedLong

Właściwości

  • Aktywne

    number opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    number opcjonalny

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    number opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    number opcjonalny

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    number opcjonalny

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedManualProxySettings

Właściwości

ManagedProperties

Właściwości

ManagedProxyLocation

Właściwości

ManagedProxySettings

Właściwości

ManagedProxySettingsType

Właściwości

  • Aktywne

    ProxySettingsType opcjonalnie

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    logiczna opcjonalna

    Czy istnieje zasada dotycząca urządzenia dla obiektu i czy pozwala ona na jego edytowanie (czyli czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    ProxySettingsType opcjonalnie

    Wartość właściwości określona przez zasady urządzenia.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, z którego pochodziła skuteczna wartość właściwości.

  • SharedSetting

    ProxySettingsType opcjonalnie

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawane tylko wtedy, gdy DeviceEditiable ma wartość true.

  • UserEditable

    logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada dotycząca użytkownika i czy umożliwia ona edycję usługi (czyli czy zasada ma ustawioną zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ProxySettingsType opcjonalnie

    Wartość właściwości określona przez zasady dotyczące użytkownika.

  • UserSetting

    ProxySettingsType opcjonalnie

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable ma wartość true.

ManagedThirdPartyVPNProperties

Właściwości

ManagedVPNProperties

Właściwości

ManagedWiFiProperties

Właściwości

ManualProxySettings

Właściwości

  • FTPProxy

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy FTP.

  • HTTPProxy

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy HTTP.

  • SOCKS

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation opcjonalnie

    Ustawienia bezpiecznego serwera proxy HTTP.

NetworkConfigProperties

Właściwości

NetworkFilter

Właściwości

  • skonfigurowano

    logiczna opcjonalna

    Jeśli to pole ma wartość Prawda, uwzględnij tylko skonfigurowane (zapisane) sieci. Wartość domyślna to „false”.

  • limit

    number opcjonalny

    Maksymalna liczba sieci do zwrócenia. Jeśli nie zostanie podany, domyślnie przyjmuje się wartość 1000. Aby ustawić brak limitu, wpisz 0.

  • networkType

    NetworkType

    Typ sieci do zwrócenia.

  • widoczna

    logiczna opcjonalna

    Jeśli to pole ma wartość Prawda, uwzględniane są tylko widoczne (fizycznie połączone lub znajdujące się w zasięgu) sieci. Wartość domyślna to „false”.

NetworkProperties

Właściwości

  • Sieć komórkowa

    CellularProperties opcjonalnie

    W przypadku sieci komórkowych właściwości sieci komórkowej.

  • Łączenie

    logiczna opcjonalna

    Informacja o możliwości połączenia z siecią.

  • ConnectionState

    ConnectionStateType opcjonalnie

    Bieżący stan połączenia z siecią.

  • ErrorState

    ciąg znaków opcjonalny

    Ostatni zarejestrowany stan błędu sieci.

  • Ethernet

    EthernetProperties opcjonalnie

    W przypadku sieci Ethernet właściwości sieci Ethernet.

  • GUID

    ciąg znaków

    Identyfikator GUID sieci.

  • IPAddressConfigType

    IPConfigType opcjonalnie

    Typ konfiguracji adresu IP sieci.

  • IPConfigs

    IPConfigProperties[] opcjonalnie

    Konfiguracja IP sieci.

  • MacAddress

    ciąg znaków opcjonalny

    Adres MAC sieci.

  • Użycie danych jest mierzone

    logiczna opcjonalna

    Chrome 85+

    czy sieć jest objęta pomiarem użycia danych.

  • Nazwa

    ciąg znaków opcjonalny

    Przyjazna dla użytkownika nazwa sieci.

  • NameServersConfigType

    IPConfigType opcjonalnie

    Typ konfiguracji IP serwerów nazw używanych przez sieć.

  • Priorytet

    number opcjonalny

    Priorytet sieci.

  • ProxySettings

    ProxySettings opcjonalnie

    ustawienia serwera proxy sieci;

  • RestrictedConnectivity

    logiczna opcjonalna

    W przypadku połączonej sieci: czy połączenie sieci z internetem jest ograniczone, np. czy sieć jest za portalem przechwytującym lub czy sieć komórkowa nie jest aktywna.

  • SavedIPConfig

    IPConfigProperties opcjonalnie

    Konfiguracja IP otrzymana z serwera DHCP przed zastosowaniem konfiguracji statycznego adresu IP.

  • Źródło

    ciąg znaków opcjonalny

    Wskazuje, czy sieć jest skonfigurowana i w jaki sposób. Możliwe wartości to:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    Wartość „None” (Brak) wchodzi w konflikt z generowaniem kodu rozszerzenia, dlatego musimy użyć ciągu znaków dla „Source” (Źródło) zamiast enumeracji SourceType.

  • StaticIPConfig

    IPConfigProperties opcjonalnie

    Konfiguracja statycznego adresu IP sieci.

  • TrafficCounterResetTime

    number opcjonalny

    Chrome w wersji 125 lub nowszej

    Kiedy liczniki natężenia ruchu zostały ostatnio zresetowane.

  • Typ sieci.

  • VPN

    VPNProperties opcjonalnie

    W przypadku sieci VPN właściwości sieci VPN.

  • Wi-Fi

    WiFiProperties opcjonalnie

    W przypadku sieci Wi-Fi właściwości sieci Wi-Fi.

NetworkStateProperties

Właściwości

NetworkType

Typ wyliczeniowy

„Wszystkie”

„Komórka”

„Ethernet”

„Tether”

„VPN”

"Bezprzewodowy"

„WiFi”

PaymentPortal

Właściwości

  • Metoda

    ciąg znaków

    Metoda HTTP do użycia w portalu płatności.

  • PostData

    ciąg znaków opcjonalny

    Dane do przesłania do portalu płatności. Ignorowana, chyba że wartość Method to POST.

  • URL

    ciąg znaków opcjonalny

    Adres URL portalu płatności.

ProxyLocation

Właściwości

  • Host

    ciąg znaków

    Host adresu IP serwera proxy.

  • Port

    liczba

    Port używany przez serwer proxy.

ProxySettings

Właściwości

  • ExcludeDomains

    string[] opcjonalnie

    Domeny i hosty, dla których wykluczono ręczne ustawienia proxy.

  • Ręcznie

    ManualProxySettings opcjonalnie

    Ręczne ustawienia serwera proxy – używane tylko do ustawień serwera proxy Manual.

  • PAC

    ciąg znaków opcjonalny

    Adres URL pliku automatycznej konfiguracji serwera proxy.

  • Typ ustawień serwera proxy.

ProxySettingsType

Typ wyliczeniowy

„Bezpośredni”

„Manual”

"PAC"

„WPAD”

SIMLockStatus

Właściwości

  • LockEnabled

    wartość logiczna

    Czy włączona jest blokada karty SIM.

  • LockType

    ciąg znaków

    Stan blokady karty SIM – możliwe wartości to 'sim-pin', 'sim-puk' i ''.

  • RetriesLeft

    number opcjonalny

    Liczba prób odblokowania za pomocą kodu PIN, po której wymagane jest podanie kodu PUK.

ThirdPartyVPNProperties

Właściwości

  • ExtensionID

    ciąg znaków

    Identyfikator rozszerzenia zewnętrznego dostawcy VPN.

  • ProviderName

    ciąg znaków opcjonalny

    Nazwa dostawcy VPN.

VPNProperties

Właściwości

  • AutoConnect

    logiczna opcjonalna

    Określa, czy sieć VPN ma być połączona automatycznie.

  • Host

    ciąg znaków opcjonalny

    Host VPN.

  • Typ

    ciąg znaków opcjonalny

    Typ sieci VPN. Nie może to być typ enumeracji z powodu „L2TP-IPSec”. W przypadku obiektu NetworkConfigProperties, który jest przekazywany do funkcji setProperties, jest to opcjonalne, ponieważ może służyć do ustawiania tylko określonych właściwości.

VPNStateProperties

Właściwości

WiFiProperties

Właściwości

  • AllowGatewayARPPolling

    logiczna opcjonalna

    Wycofane w wersji Chrome 131

    Usunięto w wersji M131. Obecnie nie ma aktywnego sondowania ARP.

  • AutoConnect

    logiczna opcjonalna

    Określa, czy sieć Wi-Fi ma łączyć się automatycznie, gdy znajdzie się w zasięgu.

  • BSSID

    ciąg znaków opcjonalny

    Identyfikator BSSID powiązanego punktu dostępu.

  • Program wcześniejszego dostępu

    EAPProperties opcjonalny

    Właściwości sieci EAP. Wymagany w sieciach WEP-8021X i WPA-EAP.

  • Częstotliwość

    number opcjonalny

    Częstotliwość pracy usługi Wi-Fi w MHz. W przypadku połączonych sieci bieżąca częstotliwość, na której sieć jest połączona. W przeciwnym razie częstotliwość jest określana na podstawie najlepszej dostępnej częstotliwości BSS.

  • FrequencyList

    number[] opcjonalny

    Zawiera wszystkie częstotliwości operacyjne ostatnio zarejestrowane dla sieci Wi-Fi.

  • HexSSID

    ciąg znaków opcjonalny

    Kopie identyfikatora SSID sieci zakodowane w systemie HEX.

  • HiddenSSID

    logiczna opcjonalna

    Określa, czy identyfikator SSID sieci będzie rozpowszechniany.

  • Hasło wielowyrazowe

    ciąg znaków opcjonalny

    Chrome 66 lub nowszy

    Hasło do połączeń WEP/WPA/WPA2. Właściwość tę można tylko ustawić – właściwości zwracane przez getProperties nie będą zawierać tej wartości.

  • RoamThreshold

    number opcjonalny

    Wycofane, zignorowane.

  • SSID

    ciąg znaków opcjonalny

    Identyfikator SSID sieci.

  • Bezpieczeństwo

    ciąg znaków opcjonalny

    Typ zabezpieczeń sieci.

  • SignalStrength

    number opcjonalny

    Siła sygnału sieci.

WiFiStateProperties

Właściwości

WiMAXProperties

Właściwości

  • AutoConnect

    logiczna opcjonalna

    Określa, czy sieć ma być połączona automatycznie.

  • Program wcześniejszego dostępu

    EAPProperties opcjonalny

    Właściwości sieci EAP.

Metody

createNetwork()

Obietnice 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

Tworzy nową konfigurację sieci na podstawie usług. Jeśli taka sieć już istnieje, nie uda się to. W przeciwnym razie zwraca identyfikator GUID nowej sieci.

Parametry

  • udostępniono

    wartość logiczna

    Jeśli true, udostępnij tę konfigurację sieci innym użytkownikom.

    Ta opcja jest dostępna tylko w interfejsie internetowym Chrome.* Gdy jest wywoływany przez aplikacje, jedyną dozwoloną wartością jest false.

  • Usługi, w których chcesz skonfigurować nową sieć.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: string) => void

    • wynik

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

disableNetworkType()

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

Wyłącza wszystkie urządzenia pasujące do określonego typu sieci. Zobacz notatkę dotyczącą enableNetworkType.

Parametry

enableNetworkType()

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

Umożliwia korzystanie z urządzeń pasujących do określonego typu sieci. Pamiętaj, że typ może reprezentować wiele typów sieci (np. „Bezprzewodowa”).

Parametry

forgetNetwork()

Obietnice 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

zapomina konfigurację sieci, usuwając wszystkie skonfigurowane właściwości sieci z identyfikatorem GUID networkGuid. Może to obejmować również inne sieci o pasujących identyfikatorach (np. SSID i zabezpieczenia sieci Wi-Fi). Jeśli taka konfiguracja nie istnieje, zostanie ustawiony błąd, a operacja zakończy się niepowodzeniem.

W sesjach kioskowych ta metoda nie będzie mogła zapomnieć konfiguracji sieci współdzielonych.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, którą chcesz usunąć.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getCaptivePortalStatus()

Obietnice 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

Zwraca stan portalu przechwytującego w sieci odpowiadającej parametrowi „networkGuid”.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz uzyskać stan portalu przechwytującego.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: CaptivePortalStatus) => void

Zwroty

  • Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getDeviceStates()

Obietnice 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Zwraca stany dostępnych urządzeń sieciowych.

Parametry

Zwroty

  • Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getGlobalPolicy()

Obietnice 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

Pobiera właściwości globalnych zasad. Nie powinny się one zmieniać w trakcie sesji.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: GlobalPolicy) => void

Zwroty

  • Obietnica<GlobalPolicy>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getManagedProperties()

Obietnice 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

Pobiera z źródeł (ustawienia użytkownika, wspólne ustawienia, zasady dotyczące użytkownika, zasady dotyczące urządzenia i obecnie aktywne ustawienia) złączone właściwości sieci o identyfikatorze networkGuid.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz pobrać właściwości.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: ManagedProperties) => void

Zwroty

  • Obietnice<ManagedProperties>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getNetworks()

Obietnice 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

Zwraca listę obiektów sieci o tych samych właściwościach, które są dostarczane przez getState. Dostępny jest filtr, który umożliwia określenie typu zwracanych sieci i ograniczenie ich liczby. Sieci są sortowane przez system według priorytetu, a połączone lub łączące się sieci są wyświetlane jako pierwsze.

Parametry

Zwroty

  • Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getProperties()

Obietnice 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

Pobiera wszystkie właściwości sieci o identyfikatorze networkGuid. Obejmuje wszystkie właściwości sieci (wartości tylko do odczytu i z możliwością odczytu i zapisu).

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz pobrać właściwości.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: NetworkProperties) => void

Zwroty

  • Obietnica<NetworkProperties>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getState()

Obietnice 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

Pobiera z pamięci podręcznej właściwości sieci o identyfikatorze networkGuid, które są dostępne tylko do odczytu. Ta funkcja ma być wydajniejsza niż getProperties, która wymaga dwukierunkowej komunikacji z podsystemem sieciowym. W przypadku wszystkich sieci zwracane są te właściwości: GUID, Type, Name, WiFi.Security. W przypadku widocznych sieci dostępne są dodatkowe właściwości: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz pobrać właściwości.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: NetworkStateProperties) => void

Zwroty

  • Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

requestNetworkScan()

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

Prośba o skanowanie nowych sieci przez podsystem sieciowy i zaktualizowanie listy zwróconej przez getVisibleNetworks. Jest to tylko prośba: podsystem sieci może ją zignorować. Jeśli lista zostanie zaktualizowana, zostanie wywołane zdarzenie onNetworkListChanged.

Parametry

  • networkType

    NetworkType opcjonalny

    Chrome 63 lub nowszy

    Jeśli podano, żąda skanowania odpowiedniego dla tego typu. W przypadku sieci komórkowej zostanie wysłane żądanie skanowania sieci komórkowej, jeśli jest to obsługiwane.

setProperties()

Obietnice 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

Ustawia właściwości sieci o identyfikatorze networkGuid. Dotyczy to tylko skonfigurowanych sieci (Source != None). Nieskonfigurowane widoczne sieci powinny zamiast tego używać wartości createNetwork. W sesjach kioskowych wywołanie tej metody w wspólnej sieci zakończy się niepowodzeniem.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz ustawić właściwości.

  • Właściwości do ustawienia.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

startConnect()

Obietnice 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

Rozpoczyna połączenie z siecią za pomocą parametru networkGuid.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, z którą chcesz się połączyć.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

startDisconnect()

Obietnice 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

Rozpoczyna odłączanie od sieci za pomocą parametru networkGuid.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, od której chcesz się odłączyć.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onDeviceStateListChanged

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

Wyzwalany, gdy zmieni się lista urządzeń lub jakiekolwiek właściwości stanu urządzenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void

onNetworkListChanged

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

Wyzwalany, gdy zmieni się lista sieci. Wysyła pełną listę identyfikatorów GUID wszystkich bieżących sieci.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (changes: string[]) => void

    • Zmiany

      string[]

onNetworksChanged

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

Wywoływany, gdy zmienią się właściwości w dowolnej sieci. Wysyła listę identyfikatorów GUID sieci, których właściwości uległy zmianie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (changes: string[]) => void

    • Zmiany

      string[]

onPortalDetectionCompleted

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

Uruchamiane po zakończeniu wykrywania portalu w sieci. Wysyła identyfikator GUID sieci i odpowiadający stan portalu przechwytującego.

Parametry