chrome.networking.onc

Opis

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

Konfiguracje połączenia sieciowego są określone zgodnie ze specyfikacją Open Network Configuration (ONC).

UWAGA: większość właściwości słownikowych i wartości wyliczeniowych używa funkcji UpperCamelCase w celu dopasowania do specyfikacji ONC, a nie konwencji JavaScript LowCamelCase.

Uprawnienia

networking.onc

Dostępność

Chrome 59 i nowsze Tylko ChromeOS

Typy

ActivationStateType

Typ wyliczeniowy

CaptivePortalStatus

Typ wyliczeniowy

CellularProperties

Właściwości

  • ActivationState

    ActivationStateType opcjonalna

    Stan aktywacji konta operatora.

  • ActivationType

    ciąg znaków opcjonalny

    Typ aktywacji sieci komórkowej.

  • AllowRoaming

    wartość logiczna opcjonalna

    Określa, czy roaming jest dozwolony w danej sieci.

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć komórkowa ma nawiązać połączenie automatycznie (gdy znajdziesz się 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 załadowana w modemie komórkowym.

  • FoundNetworks

    FoundNetworkProperties[] opcjonalne

    Lista sieci znalezionych podczas ostatniego skanowania sieci.

  • HardwareRevision

    ciąg znaków opcjonalny

    Wersja sprzętowa modemu komórkowego.

  • HomeProvider

    CellularProviderProperties opcjonalny;

    Informacje o operatorze, który wydał kartę SIM obecnie 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, oznacza to, że aktualnie używana jest technologia sieciowa.

  • PaymentPortal

    PaymentPortal (opcjonalnie)

    Internetowy portal płatności, w którym użytkownik może zarejestrować lub zmodyfikować pakiet mobilnej transmisji danych.

  • 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

    wartość logiczna opcjonalna

    Informacja, czy znajduje się karta SIM.

  • Skanowanie

    wartość logiczna opcjonalna

    Chrome w wersji 63 i nowszych

    Prawda, gdy trwa skanowanie sieci komórkowej.

  • ServingOperator

    CellularProviderProperties opcjonalny;

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

  • SignalStrength

    Liczba opcjonalnie

    Bieżąca siła sygnału sieci.

  • SupportNetworkScan

    wartość logiczna opcjonalna

    Określa, czy sieć komórkowa obsługuje skanowanie.

CellularProviderProperties

Właściwości

  • Kod

    string,

    Identyfikator sieci komórkowej w postaci zwykłej konkatenacji kodu sieci komórkowej (MCK) i MNC (kodu sieci komórkowej).

  • Kraj

    ciąg znaków opcjonalny

    Dwuliterowy kod kraju.

  • Nazwa

    string,

    Nazwa operatora.

CellularStateProperties

Właściwości

CertificatePattern

Właściwości

  • EnrollmentURI

    string[] opcjonalny

    Lista identyfikatorów URI, do których można przekierować użytkownika, jeśli nie znaleziono certyfikatów zgodnych z tym wzorcem.

  • Wystawca

    IssuerSubjectPattern – opcjonalny

    Jeśli jest ustawiony, wzorzec, do którego mają być dopasowane ustawienia wydawcy X.509.

  • IssuerCARef

    string[] opcjonalny

    Lista certyfikatów CA wydawcy certyfikatów. Certyfikat musi być podpisany przez jeden z nich, aby był zgodny z tym wzorcem.

  • Temat

    IssuerSubjectPattern – opcjonalny

    Jeśli zasada jest skonfigurowana, wzór, do którego mają być dopasowywane ustawienia tematu X.509.

ClientCertificateType

Typ wyliczeniowy

ConnectionStateType

Typ wyliczeniowy

DeviceStateProperties

Właściwości

  • SIMLockStatus

    SIMLockStatus opcjonalnie

    Chrome 62 i nowsze wersje

    Stan blokady karty SIM, gdy Typ = Sieć komórkowa, SIMPresent = Prawda.

  • SIMPresent

    wartość logiczna opcjonalna

    Chrome 62 i nowsze wersje

    Ustaw obecny stan karty SIM, jeśli typ urządzenia to Komórka.

  • Skanowanie

    wartość logiczna opcjonalna

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

  • Bieżący stan urządzenia.

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

DeviceStateType

Typ wyliczeniowy

„Nie zainicjowano”
Urządzenie jest dostępne, ale nie zostało zainicjowane.

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

„Włączenie”
Poproszono o stan włączenia, ale nie zostało ukończone.

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

„Niedozwolone”
Urządzenie jest zabronione.

EAPProperties

Właściwości

  • AnonymousIdentity

    ciąg znaków opcjonalny

  • Identyfikator certyfikatu klientaPKCS11Id

    ciąg znaków opcjonalny

    Chrome 60 i nowsze wersje
  • ClientCertPattern

    CertificatePattern – opcjonalny

  • ClientCertProvisioningProfileId

    ciąg znaków opcjonalny

    Chrome w wersji 93 i nowszych
  • ClientCertRef

    ciąg znaków opcjonalny

  • ClientCertType

    ClientCertificateType

  • Tożsamość

    ciąg znaków opcjonalny

  • Inner

    ciąg znaków opcjonalny

  • Zewnętrzne

    ciąg znaków opcjonalny

    Typ zewnętrznego protokołu EAP. Wymagany przez ONC, ale może nie być dostępny przy tłumaczeniu z programu Shill.

  • Hasło

    ciąg znaków opcjonalny

  • SaveCredentials

    wartość logiczna opcjonalna

  • ServerCAPEMs

    string[] opcjonalny

  • ServerCARefs

    string[] opcjonalny

  • SubjectMatch

    ManagedDOMString opcjonalnie

    Chrome 60 i nowsze wersje
  • UseProactiveKeyCaching

    wartość logiczna opcjonalna

  • UseSystemCAs

    wartość logiczna opcjonalna

EthernetProperties

Właściwości

  • Uwierzytelnianie

    ciąg znaków opcjonalny

    Uwierzytelnianie używane przez sieć Ethernet. Możliwe wartości to None i 8021X.

  • AutoConnect

    wartość logiczna opcjonalna

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

  • EAP

    EAPProperties opcjonalnie

    Ustawienia EAP sieci. Wymagane 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

    string,

    Identyfikator sieci.

  • ShortName

    ciąg znaków opcjonalny

    Skrócona nazwa operatora sieci.

  • Stan

    string,

    Dostępność sieci.

  • Technologia

    string,

    Dostęp do technologii używanej przez sieć.

GlobalPolicy

Właściwości

  • AllowOnlyPolicyNetworksToAutoconnect

    wartość logiczna opcjonalna

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

  • AllowOnlyPolicyNetworksToConnect

    wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, można łączyć tylko sieci z zasadami i nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    wartość logiczna opcjonalna

    Chrome 70 i nowsze wersje

    Jeśli sieć zarządzana jest dostępna na widocznej liście sieci, można łączyć się tylko z sieciami zasad i nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • BlockedHexSSIDs

    string[] opcjonalny

    Chrome 86 i nowsze wersje

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

IPConfigProperties

Właściwości

  • ExcludedRoutes

    string[] opcjonalny

    Chrome 76 i nowsze wersje

    Tablica bloków IP w notacji CIDR: szczegółowe informacje znajdziesz w sekcji onc_spec.md.

  • Brama

    ciąg znaków opcjonalny

    Adres bramy użyty do konfiguracji adresu 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 Type.

  • IncludedRoutes

    string[] opcjonalny

    Chrome 76 i nowsze wersje

    Tablica bloków IP w notacji CIDR: szczegółowe informacje znajdziesz w sekcji onc_spec.md.

  • NameServers

    string[] opcjonalny

    Tablica adresów używanych przez serwery nazw.

  • RoutingPrefix

    Liczba opcjonalnie

    Prefiks routingu.

  • SearchDomains

    string[] opcjonalny

    Chrome 76 i nowsze wersje

    Tablica ciągów znaków dla rozdzielczości nazw: szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • Typ

    ciąg znaków opcjonalny

    Typ konfiguracji IP. Może mieć wartość IPv4 lub IPv6.

  • WebProxyAutoDiscoveryUrl

    ciąg znaków opcjonalny

    Adres URL na potrzeby automatycznego wykrywania serwera proxy WEb zgodnie z raportem przez DHCP.

IPConfigType

Typ wyliczeniowy

IssuerSubjectPattern

Właściwości

  • CommonName

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, która ma być dopasowywana do imienia i nazwiska podmiotu certyfikatu.

  • Miejscowość

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, która ma być dopasowywana do wspólnej lokalizacji podmiotu certyfikatu.

  • Organizacja

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, względem której ma być dopasowywana organizacja osoby wystawiającej certyfikat. Co najmniej 1 organizacja powinna pasować do wartości.

  • OrganizationalUnit

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, względem której ma być zgodna z jednostkami organizacyjnymi podmiotu certyfikatu. Co najmniej 1 jednostka organizacyjna powinna pasować do wartości.

ManagedBoolean

Właściwości

  • Aktywny

    wartość logiczna opcjonalna

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    wartość logiczna opcjonalna

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    wartość logiczna opcjonalna

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    wartość logiczna opcjonalna

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    wartość logiczna opcjonalna

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

ManagedCellularProperties

Właściwości

ManagedDOMString

Właściwości

  • Aktywny

    ciąg znaków opcjonalny

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    ciąg znaków opcjonalny

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    ciąg znaków opcjonalny

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ciąg znaków opcjonalny

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    ciąg znaków opcjonalny

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

ManagedDOMStringList

Właściwości

  • Aktywny

    string[] opcjonalny

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    string[] opcjonalny

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    string[] opcjonalny

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    string[] opcjonalny

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    string[] opcjonalny

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

ManagedEthernetProperties

Właściwości

ManagedIPConfigProperties

Właściwości

ManagedIPConfigType

Właściwości

  • Aktywny

    IPConfigType opcjonalnie

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    IPConfigType opcjonalnie

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    IPConfigType opcjonalnie

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    IPConfigType opcjonalnie

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    IPConfigType opcjonalnie

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

ManagedLong

Właściwości

  • Aktywny

    Liczba opcjonalnie

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    Liczba opcjonalnie

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    Liczba opcjonalnie

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    Liczba opcjonalnie

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    Liczba opcjonalnie

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podana 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

  • Aktywny

    ProxySettingsType opcjonalnie

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

  • DeviceEditable

    wartość logiczna opcjonalna

    Określa, czy zasada DevicePolicy dla danej usługi istnieje i umożliwia jej edytowanie (np. zalecana wartość właściwości ustawiona w zasadach). Domyślna wartość to false.

  • DevicePolicy

    ProxySettingsType opcjonalnie

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Obejmuje

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określona została efektywna wartość właściwości.

  • SharedSetting

    ProxySettingsType opcjonalnie

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

  • UserEditable

    wartość logiczna opcjonalna

    Wskazuje, czy w przypadku danej usługi istnieje zasada UserPolicy i czy można ją edytować (czyli ustawiana jest zalecana wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ProxySettingsType opcjonalnie

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    ProxySettingsType opcjonalnie

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podana 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

    Opcjonalne ProxyLocation

    Ustawienia serwera proxy FTP.

  • HTTPProxy

    Opcjonalne ProxyLocation

    Ustawienia serwera proxy HTTP.

  • Skarpety

    Opcjonalne ProxyLocation

    Ustawienia serwera proxy SOCKS.

  • SecureHTTPProxy

    Opcjonalne ProxyLocation

    Ustawienia bezpiecznego serwera proxy HTTP.

NetworkConfigProperties

Właściwości

NetworkFilter

Właściwości

  • skonfigurowano

    wartość logiczna opcjonalna

    Jeśli ma wartość true (prawda), uwzględnij tylko skonfigurowane (zapisane) sieci. Wartość domyślna to „false” (fałsz).

  • limit

    Liczba opcjonalnie

    Maksymalna liczba sieci do zwrócenia. Jeśli nie określono inaczej, domyślna wartość to 1000. Wpisz 0, aby nie wprowadzać limitu.

  • networkType

    NetworkType

    Typ sieci do zwrócenia.

  • widoczna

    wartość logiczna opcjonalna

    Jeśli ma wartość prawda, uwzględnij tylko sieci widoczne (powiązane fizycznie lub w zasięgu). Wartość domyślna to „false” (fałsz).

NetworkProperties

Właściwości

  • Sieć komórkowa

    CellularProperties opcjonalny

    Sieci komórkowe: właściwości sieci komórkowej.

  • Z możliwością połączenia

    wartość logiczna opcjonalna

    Określa, czy można połączyć się z siecią.

  • ConnectionState

    Opcjonalny ConnectionStateType

    Obecny stan połączenia sieci.

  • ErrorState

    ciąg znaków opcjonalny

    Ostatni zarejestrowany stan błędu sieci.

  • Ethernet

    Opcjonalnie EthernetProperties

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

  • GUID

    string,

    Identyfikator GUID sieci.

  • IPAddressConfigType

    IPConfigType opcjonalnie

    Typ konfiguracji adresu IP sieci.

  • IPConfigs

    IPConfigProperties[] opcjonalny

    Konfiguracja adresu IP sieci.

  • MacAddress

    ciąg znaków opcjonalny

    Adres MAC sieci.

  • Użycie danych jest mierzone

    wartość logiczna opcjonalna

    Chrome 85 i nowsze wersje

    Wskazuje, czy sieć ma pomiary użycia.

  • 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

    Liczba opcjonalnie

    Priorytet sieci.

  • ProxySettings

    Opcjonalne ProxySettings

    Ustawienia serwera proxy sieci.

  • RestrictedConnectivity

    wartość logiczna opcjonalna

    W przypadku sieci połączonej: czy połączenie z internetem jest ograniczone, np. czy sieć znajduje się za portalem lub czy sieć komórkowa nie została aktywowana.

  • SavedIPConfig

    Opcjonalnie IPConfigProperties

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

  • Źródło

    ciąg znaków opcjonalny

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    Wartość „None” (brak) powoduje konflikt z generowaniem kodu rozszerzenia, więc zamiast wyliczenia „SourceType” musimy użyć ciągu znaków.

  • StaticIPConfig

    Opcjonalnie IPConfigProperties

    Statyczna konfiguracja adresu IP sieci.

  • TrafficCounterResetTime

    Liczba opcjonalnie

    Oczekuje

    Data ostatniego zresetowania liczników ruchu.

  • Typ sieci.

  • VPN

    VPNProperties opcjonalnie

    W przypadku sieci VPN są to właściwości sieci VPN.

  • WiFi

    WiFiProperties opcjonalnie

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

NetworkStateProperties

Właściwości

NetworkType

Typ wyliczeniowy

PaymentPortal

Właściwości

  • Metoda

    string,

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

  • PostData

    ciąg znaków opcjonalny

    Dane poczty, które mają zostać wysłane do portalu płatności. Ignorowana, chyba że Method ma wartość POST.

  • Adres URL

    ciąg znaków opcjonalny

    Adres URL portalu płatności.

ProxyLocation

Właściwości

  • Host

    string,

    Host adresu IP serwera proxy.

  • Port

    Liczba

    Port, który ma być używany przez serwer proxy.

ProxySettings

Właściwości

  • ExcludeDomains

    string[] opcjonalny

    Domeny i hosty, w przypadku których ręczne ustawienia serwera proxy są wykluczone.

  • Ręczne

    ManualProxySettings – opcjonalne;

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

  • PAC

    ciąg znaków opcjonalny

    Adres URL pliku automatycznej konfiguracji serwera proxy.

  • Typ ustawień serwera proxy.

ProxySettingsType

Typ wyliczeniowy

SIMLockStatus

Właściwości

  • LockEnabled

    boolean

    Określa, czy blokada karty SIM jest włączona.

  • LockType

    string,

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

  • RetriesLeft

    Liczba opcjonalnie

    Liczba dozwolonych prób zablokowania kodu PIN, zanim będzie trzeba podać kod PUK do odblokowania karty SIM.

ThirdPartyVPNProperties

Właściwości

  • ExtensionID

    string,

    Identyfikator rozszerzenia zewnętrznego dostawcy sieci VPN.

  • ProviderName

    ciąg znaków opcjonalny

    Nazwa dostawcy VPN.

VPNProperties

Właściwości

  • AutoConnect

    wartość logiczna opcjonalna

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

  • Host

    ciąg znaków opcjonalny

    Host VPN.

  • Typ

    ciąg znaków opcjonalny

    Typ sieci VPN. To nie może być wyliczenie z powodu „L2TP-IPSec”. Jest to opcjonalne w przypadku właściwości NetworkConfigConfig, który jest przekazywany do parametru setWłaściwości, którego można używać do ustawiania tylko konkretnych właściwości.

VPNStateProperties

Właściwości

WiFiProperties

Właściwości

  • AllowGatewayARPPolling

    wartość logiczna opcjonalna

    Określa, czy odpytywanie ARP bramy domyślnej jest dozwolone. Wartość domyślna to true.

  • AutoConnect

    wartość logiczna opcjonalna

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

  • BSSID

    ciąg znaków opcjonalny

    Identyfikator BSSID powiązanego punktu dostępu.

  • EAP

    EAPProperties opcjonalnie

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

  • Częstotliwość

    Liczba opcjonalnie

    Częstotliwość pracy usługi Wi-Fi w MHz. W przypadku sieci połączonych jest aktualna częstotliwość, z którą połączona jest sieć. W przeciwnym razie częstotliwość najlepszej dostępnej BSS.

  • FrequencyList

    number[] opcjonalny

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

  • HexSSID

    ciąg znaków opcjonalny

    Zakodowana szesnastkowo kopia identyfikatora SSID sieci.

  • HiddenSSID

    wartość logiczna opcjonalna

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

  • Hasło wielowyrazowe

    ciąg znaków opcjonalny

    Chrome 66 i nowsze wersje

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

  • RoamThreshold

    Liczba opcjonalnie

    Wycofano, zignorowano.

  • SSID

    ciąg znaków opcjonalny

    Identyfikator SSID sieci.

  • Bezpieczeństwo

    ciąg znaków opcjonalny

    Typ zabezpieczeń sieci.

  • SignalStrength

    Liczba opcjonalnie

    Siła sygnału sieci.

WiFiStateProperties

Właściwości

WiMAXProperties

Właściwości

  • AutoConnect

    wartość logiczna opcjonalna

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

  • EAP

    EAPProperties opcjonalnie

    Właściwości sieci EAP.

Metody

createNetwork()

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

Tworzy nową konfigurację sieci z usług. Jeśli pasująca skonfigurowana sieć już istnieje, nie zadziała. W przeciwnym razie zwraca identyfikator GUID nowej sieci.

Parametry

  • udostępniono

    boolean

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

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

  • Właściwości, z którymi chcesz skonfigurować nową sieć.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: string)=>void

    • wynik

      string,

Zwroty

  • Obietnica<string>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą 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

  • networkType

    NetworkType

    Typ sieci, która ma zostać wyłączona.

enableNetworkType()

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

Włącza wszystkie urządzenia pasujące do określonego typu sieci. Pamiętaj, że typ może reprezentować kilka typów sieci (np. „Bezprzewodowe”).

Parametry

  • networkType

    NetworkType

    Typ sieci, która ma zostać włączona.

forgetNetwork()

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

Zapomina konfigurację sieci, czyszcząc wszystkie skonfigurowane właściwości sieci z identyfikatorem GUID networkGuid. Może to również obejmować dowolne inne sieci o pasujących identyfikatorach (np. identyfikator SSID sieci Wi-Fi i identyfikator zabezpieczeń). Jeśli nie ma takiej konfiguracji, pojawi się błąd i operacja nie powiedzie się.

W sesjach kiosku ta metoda nie może zapomnieć udostępnionych konfiguracji sieci.

Parametry

  • networkGuid

    string,

    Identyfikator GUID sieci do zapomnienia.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Zwroty

  • Promise<void>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getCaptivePortalStatus()

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

Zwraca stan portalu przechwytującego dla sieci pasującej do „networkGuid”.

Parametry

  • networkGuid

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: CaptivePortalStatus)=>void

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getDeviceStates()

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

Zwraca stany dostępnych urządzeń sieciowych.

Parametry

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getGlobalPolicy()

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

Pobiera właściwości zasady globalnej. Te właściwości nie zmieniają się podczas sesji.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: GlobalPolicy)=>void

Zwroty

  • Promise<GlobalPolicy>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getManagedProperties()

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

Pobiera scalone właściwości sieci o identyfikatorze NetworkGuid ze źródeł: ustawienia użytkownika, ustawienia udostępnione, zasady dotyczące użytkowników, zasady dotyczące urządzeń i aktualnie aktywne ustawienia.

Parametry

  • networkGuid

    string,

    Identyfikator GUID sieci, dla której chcesz pobrać usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: ManagedProperties)=>void

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getNetworks()

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

Zwraca listę obiektów sieciowych o tych samych właściwościach, które zostały określone przez getState. Dostępny jest filtr określający typ zwracanych sieci i ograniczający liczbę sieci. Sieci są uporządkowane według ich priorytetu. Na początku sieci znajdują się połączone lub połączone sieci.

Parametry

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getProperties()

Obietnica 
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 do odczytu i zapisu).

Parametry

  • networkGuid

    string,

    Identyfikator GUID sieci, dla której chcesz pobrać usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: NetworkProperties)=>void

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getState()

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

Pobiera z pamięci podręcznej właściwości sieci z identyfikatorem NetworkGuid (tylko do odczytu). Powinna to być funkcja o wyższej wydajności niż getProperties, która wymaga przesyłania w obie strony zapytania do podsystemu sieciowego. Dla 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, Wi-Fi.SignalStrength, Cell.NetworkTechnology, Cell.ActivationState, Cell.RoamingState.

Parametry

  • networkGuid

    string,

    Identyfikator GUID sieci, dla której chcesz pobrać usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: NetworkStateProperties)=>void

Zwroty

  • Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

requestNetworkScan()

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

Żądania, które podsystem sieciowy skanuje w poszukiwaniu nowych sieci i aktualizuje listę zwracaną przez funkcję getVisibleNetworks. To jest tylko żądanie, które podsystem sieci może je zignorować. Jeśli lista zostanie zaktualizowana, uruchomi się zdarzenie onNetworkListChanged.

Parametry

  • networkType

    Opcjonalny NetworkType

    Chrome w wersji 63 i nowszych

    Jeśli jest podany, wysyła żądanie skanowania określonego dla danego typu. W przypadku sieci komórkowej wymagane będzie skanowanie sieci komórkowej (o ile jest obsługiwane).

setProperties()

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

Ustawia właściwości sieci o identyfikatorze networkGuid. Dotyczy to tylko skonfigurowanych sieci (źródło != Brak). Nieskonfigurowane widoczne sieci powinny używać parametru createNetwork. W sesjach kiosku wywołanie tej metody w sieci współdzielonej zakończy się niepowodzeniem.

Parametry

  • networkGuid

    string,

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

  • Właściwości do ustawienia.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Zwroty

  • Promise<void>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

startConnect()

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

Rozpoczyna połączenie z siecią przy użyciu NetworkGuid.

Parametry

  • networkGuid

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Zwroty

  • Promise<void>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

startDisconnect()

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

Rozpoczyna rozłączanie z siecią przy użyciu NetworkGuid.

Parametry

  • networkGuid

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Zwroty

  • Promise<void>

    Oczekuje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onDeviceStateListChanged

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

Uruchamiane po zmianie listy urządzeń lub zmianie dowolnych właściwości stanu urządzenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    ()=>void

onNetworkListChanged

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

Uruchamiane po zmianie listy sieci. Wysyła pełną listę identyfikatorów GUID dla wszystkich bieżących sieci.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (changes: string[])=>void

    • Zmiany

      string[]

onNetworksChanged

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

Uruchamiane, gdy właściwości zmienią się w dowolnej sieci. Wysyła listę identyfikatorów GUID dla sieci, których właściwości się zmieniły.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (changes: string[])=>void

    • Zmiany

      string[]

onPortalDetectionCompleted

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

Uruchamiane po zakończeniu wykrywania sieci przez portal. Wysyła identyfikator GUID sieci i odpowiedni stan portalu przechwytującego.

Parametry