chrome.networking.onc

.

Opis

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

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

UWAGA: większość właściwości słownika i wartości wyliczeniowych używa zapisu UpperCamelCase, aby dopasować specyfikację ONC, a nie do konwencji LowCamelCase w JavaScripcie.

Uprawnienia

networking.onc

Dostępność

Chrome w wersji 59 lub nowszej Tylko ChromeOS

Typy

ActivationStateType

Typ wyliczeniowy

„Aktywowano”

„Aktywuję”

„NotActivated” (Nie aktywowano)

Częściowo aktywowano

CaptivePortalStatus

Typ wyliczeniowy

„Nieznany”

„Offline”

"Online"

"Portal"

"ProxyAuthRequired"

CellularProperties

Właściwości

  • ActivationState

    opcjonalny ActivationStateType

    Stan aktywacji konta operatora.

  • ActivationType

    ciąg znaków opcjonalny

    Typ aktywacji sieci komórkowej.

  • AllowRoaming

    Wartość logiczna opcjonalna

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

  • AutoConnect

    Wartość logiczna opcjonalna

    Określa, czy sieć komórkowa ma nawiązać automatyczne połączenie (gdy znajduje 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 do modemu komórkowego.

  • FoundNetworks

    FoundNetworkProperties[] opcjonalne

    Lista sieci znalezionych podczas ostatniego skanowania sieci.

  • HardwareRevision

    ciąg znaków opcjonalny

    Wersja sprzętowa modemu komórkowego.

  • HomeProvider

    Opcjonalne CellularProviderProperties

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

  • PaymentPortal

    Opcjonalny PaymentPortal

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

  • RoamingState

    ciąg znaków opcjonalny

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

  • SIMLockStatus

    Opcjonalny SIMLockStatus

    Stan blokady karty SIM w sieciach rodzinnych GSM.

  • SIMPresent

    Wartość logiczna opcjonalna

    Wskazuje, czy masz kartę SIM.

  • Skanowanie

    Wartość logiczna opcjonalna

    Chrome w wersji 63 lub nowszej .

    Prawda, gdy trwa skanowanie sieci komórkowej.

  • ServingOperator

    Opcjonalne CellularProviderProperties

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

  • SignalStrength

    liczba opcjonalnie

    Aktualna siła sygnału sieci.

  • SupportNetworkScan

    Wartość logiczna opcjonalna

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

CellularProviderProperties

Właściwości

  • Kod

    ciąg znaków

    Identyfikator sieci komórkowej stanowiący proste połączenie MCK (kodu kraju urządzenia mobilnego) i MNC (kodu 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 można przekierować użytkownika, jeśli nie znaleziono certyfikatów pasujących do tego wzorca.

  • Wystawca

    IssuerSubjectPattern – opcjonalny

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

  • IssuerCARef

    string[] opcjonalnie

    Lista certyfikatów CA wydawcy certyfikatu. Certyfikat musi zostać podpisany przez jednego z nich, aby pasować do tego wzorca.

  • Temat

    IssuerSubjectPattern – opcjonalny

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

ClientCertificateType

Typ wyliczeniowy

"Odniesienie"

"Wzór"

ConnectionStateType

Typ wyliczeniowy

„Połączono”

"Łączenie"

„Nie połączono”

DeviceStateProperties

Właściwości

  • SIMLockStatus

    Opcjonalny SIMLockStatus

    Chrome w wersji 62 lub nowszej .

    Stan blokady karty SIM, jeśli Typ = Sieć komórkowa i karta SIM jest obecna = Prawda.

  • SIMPresent

    Wartość logiczna opcjonalna

    Chrome w wersji 62 lub nowszej .

    Jeśli urządzenie jest typu Sieć komórkowa, ustaw stan obecności karty SIM.

  • Skanowanie

    Wartość logiczna opcjonalna

    Określa, czy urządzenie jest włączone. Prawda, jeśli urządzenie właśnie skanuje.

  • Bieżący stan urządzenia.

  • Typ

    Typ sieci

    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łączanie”
Żądanie włączenia zostało wysłane, 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 ClientCertPKCS11Id

    ciąg znaków opcjonalny

    Chrome w wersji 60 lub nowszej .
  • ClientCertPattern

    CertificatePattern – opcjonalny

  • ClientCertProvisioningProfileId

    ciąg znaków opcjonalny

    Chrome w wersji 93 lub nowszej .
  • 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

    Zewnętrzny typ EAP. Wymagany przez ONC, ale może nie być podawany podczas tłumaczenia z Shill.

  • Hasło

    ciąg znaków opcjonalny

  • SaveCredentials

    Wartość logiczna opcjonalna

  • ServerCAPEMs

    string[] opcjonalnie

  • ServerCARefs

    string[] opcjonalnie

  • SubjectMatch

    Opcjonalny ManagedDOMString

    Chrome w wersji 60 lub nowszej .
  • UseProactiveKeyCaching

    Wartość logiczna opcjonalna

  • UseSystemCAs

    Wartość logiczna opcjonalna

EthernetProperties

Właściwości

  • Uwierzytelnianie

    ciąg znaków opcjonalny

    Uwierzytelnianie używane w sieci Ethernet. Możliwe wartości to None i 8021X.

  • AutoConnect

    Wartość logiczna opcjonalna

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

  • Program wcześniejszego dostępu

    EAPProperties opcjonalne

    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

    ciąg znaków

    Identyfikator sieci.

  • ShortName

    ciąg znaków opcjonalny

    Skrócona nazwa operatora sieci.

  • Stan

    ciąg znaków

    Dostępność sieci.

  • Technologia

    ciąg znaków

    Dostęp do technologii używanej w sieci.

GlobalPolicy

Właściwości

  • AllowOnlyPolicyNetworksToAutoconnect

    Wartość logiczna opcjonalna

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

  • AllowOnlyPolicyNetworksToConnect

    Wartość logiczna opcjonalna

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    Wartość logiczna opcjonalna

    Chrome w wersji 70 lub nowszej .

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

  • BlockedHexSSIDs

    string[] opcjonalnie

    Chrome 86 i nowsze .

    Lista zablokowanych sieci. Połączenia z zablokowanymi sieciami są zabronione. Sieci można odblokować ponownie, określając dla nich jawną konfigurację sieci. Domyślnie lista jest pusta.

IPConfigProperties

Właściwości

  • ExcludedRoutes

    string[] opcjonalnie

    Chrome w wersji 76 i nowszych .

    Tablica bloków adresów IP w notacji CIDR. Więcej informacji znajdziesz w witrynie onc_spec.md.

  • Brama

    ciąg znaków opcjonalny

    Adres bramy użyty w 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 Type.

  • IncludedRoutes

    string[] opcjonalnie

    Chrome w wersji 76 i nowszych .

    Tablica bloków adresów IP w notacji CIDR. Więcej informacji znajdziesz w witrynie onc_spec.md.

  • NameServers

    string[] opcjonalnie

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

  • RoutingPrefix

    liczba opcjonalnie

    Prefiks routingu.

  • SearchDomains

    string[] opcjonalnie

    Chrome w wersji 76 i nowszych .

    Tablica ciągów tekstowych do rozpoznawania nazw. Szczegółowe informacje znajdziesz w witrynie onc_spec.md.

  • Typ

    ciąg znaków opcjonalny

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

  • WebProxyAutoDiscoveryUrl

    ciąg znaków opcjonalny

    Adres URL na potrzeby automatycznego wykrywania serwerów proxy WEb zgłoszony przez DHCP.

IPConfigType

Typ wyliczeniowy

"DHCP"

„Statyczny”

IssuerSubjectPattern

Właściwości

  • CommonName

    ciąg znaków opcjonalny

    Wartość, która ma być dopasowywana do powszechnej nazwy podmiotu certyfikatu.

  • Miejscowość

    ciąg znaków opcjonalny

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

  • Organizacja

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, względem której mają być sprawdzane organizacje podmiotu certyfikatu. Co najmniej 1 organizacja powinna pasować do tej wartości.

  • OrganizationalUnit

    ciąg znaków opcjonalny

    Wartość, która ma być dopasowywana do jednostek organizacyjnych podmiotu certyfikatu. Co najmniej 1 jednostka organizacyjna powinna pasować do tej wartości.

ManagedBoolean

Właściwości

  • Aktywne

    Wartość logiczna opcjonalna

    Aktywna wartość używana obecnie 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 (tj. zalecana wartość właściwości ustawiona przez zasady). Domyślna wartość to false.

  • DevicePolicy

    Wartość logiczna opcjonalna

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    Wartość logiczna opcjonalna

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). 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. Wartość podana tylko wtedy, gdy UserEditable to 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

    Wartość logiczna opcjonalna

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

  • DevicePolicy

    ciąg znaków opcjonalny

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    ciąg znaków opcjonalny

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). 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. Wartość podana tylko wtedy, gdy UserEditable to true.

ManagedDOMStringList

Właściwości

  • Aktywne

    string[] opcjonalnie

    Aktywna wartość używana obecnie 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 (tj. zalecana wartość właściwości ustawiona przez zasady). Domyślna wartość to false.

  • DevicePolicy

    string[] opcjonalnie

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    string[] opcjonalnie

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). Domyślna wartość to false.

  • UserPolicy

    string[] opcjonalnie

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

  • UserSetting

    string[] opcjonalnie

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

ManagedEthernetProperties

Właściwości

ManagedIPConfigProperties

Właściwości

ManagedIPConfigType

Właściwości

  • Aktywne

    Opcjonalny IPConfigType

    Aktywna wartość używana obecnie 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 (tj. zalecana wartość właściwości ustawiona przez zasady). Domyślna wartość to false.

  • DevicePolicy

    Opcjonalny IPConfigType

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    Opcjonalny IPConfigType

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). Domyślna wartość to false.

  • UserPolicy

    Opcjonalny IPConfigType

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

  • UserSetting

    Opcjonalny IPConfigType

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

ManagedLong

Właściwości

  • Aktywne

    liczba opcjonalnie

    Aktywna wartość używana obecnie 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 (tj. zalecana wartość właściwości ustawiona przez zasady). Domyślna wartość to false.

  • DevicePolicy

    liczba opcjonalnie

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    liczba opcjonalnie

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). 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. Wartość podana tylko wtedy, gdy UserEditable to 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 optional

    Aktywna wartość używana obecnie 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 (tj. zalecana wartość właściwości ustawiona przez zasady). Domyślna wartość to false.

  • DevicePolicy

    ProxySettingsType optional

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

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego ustalono rzeczywistą wartość właściwości.

  • SharedSetting

    ProxySettingsType optional

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

  • UserEditable

    Wartość logiczna opcjonalna

    Określa, czy istnieje zasada UserPolicy dla usługi i czy można ją edytować (tzn. czy określa zalecaną wartość właściwości ustawioną przez zasady). Domyślna wartość to false.

  • UserPolicy

    ProxySettingsType optional

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

  • UserSetting

    ProxySettingsType optional

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Wartość podana tylko wtedy, gdy UserEditable to 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.

  • Skarpetki

    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

    Wartość logiczna opcjonalna

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

  • limit

    liczba opcjonalnie

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

  • networkType

    Typ sieci

    Typ sieci do zwrócenia.

  • widoczna

    Wartość logiczna opcjonalna

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

NetworkProperties

Właściwości

  • Sieć komórkowa

    CellularProperties (opcjonalne)

    W przypadku sieci komórkowych są to właściwości sieci komórkowych.

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

    Wartość logiczna opcjonalna

    Określa, czy sieć jest dostępna.

  • ConnectionState

    ConnectionStateType optional

    Bieżący stan połączenia sieci.

  • ErrorState

    ciąg znaków opcjonalny

    Stan ostatniego zarejestrowanego błędu sieci.

  • Ethernet

    Opcjonalne EthernetProperties

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

  • GUID

    ciąg znaków

    Identyfikator GUID sieci.

  • IPAddressConfigType

    Opcjonalny IPConfigType

    Typ konfiguracji adresu IP sieci.

  • IPConfigs

    IPConfigProperties[] opcjonalne

    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 .

    Określa, czy sieć jest z pomiarem użycia danych.

  • Nazwa

    ciąg znaków opcjonalny

    Przyjazna dla użytkownika nazwa sieci.

  • NameServersConfigType

    Opcjonalny IPConfigType

    Typ konfiguracji IP dla serwerów nazw używanych w sieci.

  • Priorytet

    liczba opcjonalnie

    Priorytet sieci.

  • ProxySettings

    ProxySettings (opcjonalnie)

    Ustawienia serwera proxy sieci.

  • RestrictedConnectivity

    Wartość logiczna opcjonalna

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

  • SavedIPConfig

    IPConfigProperties (opcjonalny)

    Konfiguracja IP, która została odebrana z serwera DHCP przed zastosowaniem konfiguracji statycznego adresu IP.

  • Źródło

    ciąg znaków opcjonalny

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    „Brak” powoduje konflikt z generowaniem kodu rozszerzenia, dlatego w polu „Source” (Źródło) musimy użyć ciągu znaków zamiast wyliczenia SourceType.

  • StaticIPConfig

    IPConfigProperties (opcjonalny)

    Konfiguracja statycznego adresu IP sieci.

  • TrafficCounterResetTime

    liczba opcjonalnie

    Chrome w wersji 125 lub nowszej .

    Data ostatniego zresetowania liczników ruchu.

  • Typ

    Typ sieci

    Typ sieci.

  • VPN

    VPNProperties opcjonalnie

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

  • Wi-Fi

    WiFiProperties opcjonalne

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

NetworkStateProperties

Właściwości

NetworkType

Typ wyliczeniowy

"Wszystkie"

"Sieć komórkowa"

"Ethernet"

"Tethering"

"VPN"

„Bezprzewodowe”

„Wi-Fi”

PaymentPortal

Właściwości

  • Metoda

    ciąg znaków

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

  • PostData

    ciąg znaków opcjonalny

    Dane do przesłania do portalu płatności. Ignorowana, chyba że atrybut Method ma wartość 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, który ma być używany dla serwera proxy.

ProxySettings

Właściwości

  • ExcludeDomains

    string[] opcjonalnie

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

  • Ręcznie

    ManualProxySettings – opcjonalnie

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

  • PAC

    ciąg znaków opcjonalny

    URL pliku automatycznej konfiguracji serwera proxy.

  • Typ ustawień serwera proxy.

ProxySettingsType

Typ wyliczeniowy

„Bezpośrednie”

„Ręcznie”

"PAC"

„WPAD”

SIMLockStatus

Właściwości

  • LockEnabled

    wartość logiczna

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

  • LockType

    ciąg znaków

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

  • RetriesLeft

    liczba opcjonalnie

    Liczba dozwolonych prób blokady kodem PIN przed odblokowaniem karty SIM za pomocą 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 sieci VPN.

VPNProperties

Właściwości

  • AutoConnect

    Wartość logiczna opcjonalna

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

  • Host

    ciąg znaków opcjonalny

    Host VPN.

  • Typ

    ciąg znaków opcjonalny

    Typ sieci VPN. To nie może być enum z powodu „L2TP-IPSec”. Jest to opcjonalne w przypadku właściwości NetworkConfigConfig, które są przekazywane do parametru setWłaściwości. Można ich używać do ustawiania określonych właściwości.

VPNStateProperties

Właściwości

WiFiProperties

Właściwości

  • AllowGatewayARPPolling

    Wartość logiczna opcjonalna

    Określa, czy dozwolone jest odpytywanie ARP bramy domyślnej. Domyślna wartość to prawda.

  • AutoConnect

    Wartość logiczna opcjonalna

    Określa, czy sieć Wi-Fi powinna zostać automatycznie nawiązana, 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 opcjonalne

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

  • Częstotliwość

    liczba opcjonalnie

    Częstotliwość działania usługi Wi-Fi w MHz. W przypadku połączonych sieci: bieżąca częstotliwość, z jaką połączenie jest aktywne. W przeciwnym razie jest to częstotliwość najdokładniejszej dostępnej wartości BSS.

  • FrequencyList

    liczba[] opcjonalnie

    Zawiera wszystkie częstotliwości działania zarejestrowane w ostatnim czasie 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 transmitowany.

  • Hasło wielowyrazowe

    ciąg znaków opcjonalny

    Chrome w wersji 66 lub nowszej, .

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

  • RoamThreshold

    liczba opcjonalnie

    Wycofane, zignorowane.

  • 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 być połączona automatycznie.

  • Program wcześniejszego dostępu

    EAPProperties opcjonalne

    Właściwości sieci EAP.

Metody

createNetwork()

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

Tworzy nową konfigurację sieci na podstawie usług. Jeśli pasująca skonfigurowana sieć już istnieje, zakończy się niepowodzeniem. W przeciwnym razie zwraca identyfikator GUID nowej sieci.

Parametry

  • udostępniony

    wartość logiczna

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

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

  • Właściwości, które mają być używane do konfigurowania nowej sieci.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: string) => void

    • wynik

      ciąg znaków

Zwroty

  • Obietnica<ciąg>

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, 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 uwagę do: enableNetworkType.

Parametry

  • networkType

    Typ sieci

    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 ten typ może reprezentować wiele typów sieci (np. „Bezprzewodowa”).

Parametry

  • networkType

    Typ sieci

    Typ sieci do włączenia.

forgetNetwork()

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

Zapomina konfigurację sieci przez wyczyszczenie wszystkich skonfigurowanych właściwości sieci z identyfikatorem GUID networkGuid. Może to również obejmować wszystkie inne sieci z pasującymi identyfikatorami (np. Wi-Fi SSID i zabezpieczenia). Jeśli taka konfiguracja nie istnieje, zostanie ustawiony błąd, a operacja zakończy się niepowodzeniem.

W sesjach kiosku ta metoda nie pozwala zapomnieć o udostępnionych konfiguracjach sieci.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, która ma zostać zapomniana.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, 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 parametru „networkGuid”.

Parametry

  • networkGuid

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: CaptivePortalStatus) => void

Zwroty

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, 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

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getGlobalPolicy()

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

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

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: GlobalPolicy) => void

Zwroty

  • Promise&lt;GlobalPolicy&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getManagedProperties()

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

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

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której pobierane są usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: ManagedProperties) => void

Zwroty

  • Promise&lt;ManagedProperties&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getNetworks()

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

Zwraca listę obiektów sieci o tych samych właściwościach co getState. Dostępny jest filtr, który określa typ zwracanych sieci i ogranicza ich liczbę. Sieci są uporządkowane według priorytetu w systemie. Na początku znajdują się sieci połączone lub łączące.

Parametry

Zwroty

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, 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 sieciGuid. Obejmuje wszystkie właściwości sieci (wartości tylko do odczytu oraz do odczytu i zapisu).

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której pobierane są usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: NetworkProperties) => void

Zwroty

  • Promise&lt;NetworkProperties&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getState()

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

Pobiera przechowywane w pamięci podręcznej właściwości sieci z identyfikatorem sieciGuid, które są tylko do odczytu. Powinna to być funkcja o większej wydajności niż funkcja getProperties, która wymaga przesyłania w obie strony, aby wysłać zapytanie do podsystemu sieciowego. Dla wszystkich sieci zwracane są te właściwości: GUID, Type, Name, WiFi.Security. W przypadku sieci widocznych są podawane 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 pobierane są usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: NetworkStateProperties) => void

Zwroty

  • Promise&lt;NetworkStateProperties&gt;

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

requestNetworkScan()

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

Wysyła żądanie, aby podsystem sieciowy przeskanował nowe sieci w poszukiwaniu nowych sieci i zaktualizował listę zwracaną przez funkcję getVisibleNetworks. To jest tylko żądanie – podsystem sieciowy może je zignorować. Jeśli lista zostanie zaktualizowana, wywoływane będzie zdarzenie onNetworkListChanged.

Parametry

  • networkType

    Opcjonalny NetworkType

    Chrome w wersji 63 lub nowszej .

    Jeśli zostanie podany, wymaga skanowania w zależności od typu. W przypadku sieci komórkowych wymagane będzie skanowanie sieci komórkowej, jeśli ta funkcja jest obsługiwana.

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ć interfejsu createNetwork. W sesjach kiosku wywołanie tej metody w sieci współdzielonej się nie uda.

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

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

startConnect()

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

Rozpoczyna połączenie z siecią z interfejsem networkGuid.

Parametry

  • networkGuid

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

startDisconnect()

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

Rozpoczyna rozłączanie z siecią za pomocą networkGuid.

Parametry

  • networkGuid

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 125 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onDeviceStateListChanged

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

Uruchamiane po zmianie listy urządzeń lub dowolnej 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 wszystkich bieżących sieci.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (changes: string[]) => void

    • Zmiany

      ciąg znaków[]

onNetworksChanged

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

Uruchamiane po zmianie 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 wygląda tak: 

    (changes: string[]) => void

    • Zmiany

      ciąg znaków[]

onPortalDetectionCompleted

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

Uruchamiane po zakończeniu wykrywania portalu w sieci. Wysyła identyfikator GUID sieci oraz odpowiedni stan portalu przechwytującego.

Parametry