chrome.networking.onc

Beschreibung

Die chrome.networking.onc API wird zum Konfigurieren von Netzwerkverbindungen (Mobilfunk, Ethernet, VPN oder WLAN) verwendet. Diese API ist in automatisch gestarteten Chrome OS-Kiosksitzungen verfügbar.

Konfigurationen für Netzwerkverbindungen werden gemäß der Spezifikation Open Network Configuration (ONC) angegeben.

HINWEIS: Die meisten Wörterbucheigenschaften und ENUM-Werte verwenden UpperCamelCase zur Übereinstimmung mit der ONC-Spezifikation anstelle der JavaScript-Konvention für niedrigere CamelCase-Schreibweise.

Berechtigungen

networking.onc

Verfügbarkeit

Chrome 59 und höher Nur ChromeOS

Typen

ActivationStateType

Enum

„Aktiviert“

Wird aktiviert

"Nicht aktiviert"

"Teilweise aktiviert"

CaptivePortalStatus

Enum

"Unbekannt"

„Offline“

„Online“

„Portal“

„ProxyAuthRequired“

CellularProperties

Attribute

  • ActivationState

    Aktivierungsstatus des Anbieterkontos.

  • ActivationType

    String optional

    Der Aktivierungstyp des Mobilfunknetzes.

  • AllowRoaming

    Boolescher Wert optional

    Gibt an, ob Roaming für das Netzwerk zulässig ist.

  • AutoConnect

    Boolescher Wert optional

    Legt fest, ob das Mobilfunknetz automatisch verbunden werden soll (wenn in Reichweite).

  • Familie

    String optional

    Technologiefamilie der Mobilfunkgeräte: CDMA oder GSM.

  • FirmwareRevision

    String optional

    Die im Mobilfunkmodem geladene Firmwareversion.

  • FoundNetworks

    Die Liste der Netzwerke, die beim letzten Netzwerkscan gefunden wurden.

  • HardwareRevision

    String optional

    Die Hardwareversion des Mobilfunkmodems.

  • HomeProvider

    Informationen zum Mobilfunkanbieter, der die aktuell im Modem eingelegte SIM-Karte ausgestellt hat.

  • Hersteller

    String optional

    Der Hersteller des Mobilfunkmodems.

  • ModelID

    String optional

    Die Modell-ID des Mobilfunkmodems.

  • NetworkTechnology

    String optional

    Wenn das Modem in einem Netzwerk registriert ist, die aktuell verwendete Netzwerktechnologie.

  • PaymentPortal

    PaymentPortal optional

    Onlinezahlungsportal, über das ein Nutzer sich für einen Tarif für mobile Daten registrieren oder diesen ändern kann.

  • RoamingState

    String optional

    Der Roaming-Status des Mobilfunkmodems im aktuellen Netzwerk.

  • SIMLockStatus

    SIMLockStatus optional

    Der Status der SIM-Sperre für Netzwerke der GSM-Familie.

  • SIMPresent

    Boolescher Wert optional

    Gibt an, ob eine SIM-Karte vorhanden ist.

  • Scannen

    Boolescher Wert optional

    Chrome 63 und höher

    „True“, wenn ein Mobilfunknetz gescannt wird.

  • ServingOperator

    Informationen zu dem Betreiber, in dessen Netzwerk das Modem derzeit registriert ist.

  • SignalStrength

    Zahl optional

    Die aktuelle Signalstärke des Netzwerks.

  • SupportNetworkScan

    Boolescher Wert optional

    Gibt an, ob das Mobilfunknetz die Suche unterstützt.

CellularProviderProperties

Attribute

  • Code

    String

    Mobilfunk-Netzwerk-ID als einfache Verkettung des MCC (Mobile Country Code) des Netzwerks und des MNC (Mobile Network Code).

  • Land

    String optional

    Der aus zwei Buchstaben bestehende Ländercode.

  • Name

    String

    Der Name des Operators.

CellularStateProperties

Attribute

CertificatePattern

Attribute

  • EnrollmentURI

    string[] optional

    Liste der URIs, zu denen der Nutzer weitergeleitet werden kann, falls keine Zertifikate gefunden werden, die diesem Muster entsprechen.

  • Aussteller

    Falls festgelegt, Muster, mit dem die X.509-Ausstellereinstellungen abgeglichen werden sollen.

  • IssuerCARef

    string[] optional

    Liste der CA-Zertifikate des Zertifikatsausstellers. Ein Zertifikat muss von einem dieser Anbieter signiert werden, damit es diesem Muster entspricht.

  • Betreff

    Falls festgelegt, Muster, mit dem die X.509-Themeneinstellungen abgeglichen werden sollen.

ClientCertificateType

Enum

"Ref."

"Muster"

ConnectionStateType

Enum

"Verbunden"

"Verbinden"

Nicht verbunden

DeviceStateProperties

Attribute

  • SIMLockStatus

    SIMLockStatus optional

    Chrome 62 und höher

    Der Status der SIM-Sperre, wenn Typ = Mobilfunknetz und SIMPresent = True.

  • SIMPresent

    Boolescher Wert optional

    Chrome 62 und höher

    Auf den aktuellen Status der SIM-Karte setzen, wenn der Gerätetyp „Mobilfunk“ ist.

  • Scannen

    Boolescher Wert optional

    Legt fest, ob das Gerät aktiviert ist. „True“, wenn das Gerät gerade eine Suche durchführt.

  • Der aktuelle Status des Geräts.

  • Der dem Gerät zugeordnete Netzwerktyp (Mobilfunk, Ethernet oder WLAN).

DeviceStateType

Enum

„Nicht initialisiert“
Das Gerät ist verfügbar, aber nicht initialisiert.

„Deaktiviert“
Das Gerät wurde initialisiert, aber nicht aktiviert.

"Wird aktiviert"
Der Status "Aktiviert" wurde angefordert, aber nicht abgeschlossen.

„Aktiviert“
Das Gerät ist aktiviert.

"Verboten"
Das Gerät ist unzulässig.

EAPProperties

Attribute

  • AnonymousIdentity

    String optional

  • ClientCertPKCS11Id (ClientCertPKCS11Id)

    String optional

    Chrome 60 und höher
  • ClientCertPattern
  • ClientCertProvisioningProfileId

    String optional

    Chrome 93 und höher
  • ClientCertRef

    String optional

  • ClientCertType
  • Identität

    String optional

  • Inner

    String optional

  • Outer

    String optional

    Der äußere EAP-Typ. Von ONC gefordert, kann aber bei der Übersetzung aus Shill nicht angegeben werden.

  • Passwort

    String optional

  • SaveCredentials

    Boolescher Wert optional

  • ServerCAPEMs

    string[] optional

  • ServerCARefs

    string[] optional

  • SubjectMatch
    Chrome 60 und höher
  • UseProactiveKeyCaching

    Boolescher Wert optional

  • UseSystemCAs

    Boolescher Wert optional

EthernetProperties

Attribute

  • Authentifizierung

    String optional

    Die vom Ethernet-Netzwerk verwendete Authentifizierung. Die möglichen Werte sind None und 8021X.

  • AutoConnect

    Boolescher Wert optional

    Legt fest, ob das Ethernet-Netzwerk automatisch verbunden werden soll.

  • EAP

    EAPPropertiesoptional

    EAP-Einstellungen des Netzwerks. Für die 8021X-Authentifizierung erforderlich.

EthernetStateProperties

Attribute

FoundNetworkProperties

Attribute

  • LongName

    String optional

    Der lange Name des Netzbetreibers.

  • NetworkId

    String

    Netzwerk-ID.

  • ShortName

    String optional

    Der Kurzformatname des Netzbetreibers.

  • Status

    String

    Netzwerkverfügbarkeit.

  • Technologie

    String

    Auf die vom Netzwerk verwendete Technologie zugreifen.

GlobalPolicy

Attribute

  • AllowOnlyPolicyNetworksToAutoconnect

    Boolescher Wert optional

    Wenn „true“ festgelegt ist, können nur Richtliniennetzwerke automatisch eine Verbindung herstellen. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnect

    Boolescher Wert optional

    Wenn „true“ festgelegt ist, können nur Richtliniennetzwerke verbunden werden und es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    Boolescher Wert optional

    Chrome 70 oder höher

    Wenn „true“ festgelegt ist und ein verwaltetes Netzwerk in der angezeigten Netzwerkliste verfügbar ist, können nur Richtliniennetzwerke verbunden werden. Es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".

  • BlockedHexSSIDs

    string[] optional

    Chrome (ab Version 86)

    Liste der blockierten Netzwerke. Verbindungen zu blockierten Netzwerken sind unzulässig. Netzwerke können wieder blockiert werden, indem Sie eine explizite Netzwerkkonfiguration angeben. Die Standardeinstellung ist eine leere Liste.

IPConfigProperties

Attribute

  • ExcludedRoutes

    string[] optional

    Chrome 76 und höher

    Array von IP-Blöcken in CIDR-Notation, siehe onc_spec.md für Details.

  • Gateway

    String optional

    Für die IP-Konfiguration verwendete Gatewayadresse.

  • IPAddress

    String optional

    Die IP-Adresse für eine Verbindung. Kann eine IPv4- oder IPv6-Adresse sein, je nach Wert von Type.

  • IncludedRoutes

    string[] optional

    Chrome 76 und höher

    Array von IP-Blöcken in CIDR-Notation, siehe onc_spec.md für Details.

  • NameServers

    string[] optional

    Array von Adressen für Nameserver.

  • RoutingPrefix

    Zahl optional

    Das Routing-Präfix.

  • SearchDomains

    string[] optional

    Chrome 76 und höher

    String-Array für die Namensauflösung; weitere Informationen siehe onc_spec.md

  • Typ

    String optional

    Der IP-Konfigurationstyp. Kann IPv4 oder IPv6 sein.

  • WebProxyAutoDiscoveryUrl

    String optional

    Die URL für die WEb-Proxy-Auto-Discovery, wie über DHCP gemeldet.

IPConfigType

Enum

„DHCP“

"Statisch"

IssuerSubjectPattern

Attribute

  • CommonName

    String optional

    Der Wert, mit dem der allgemeine Name des Zertifikatsinhabers abgeglichen werden soll.

  • Ort

    String optional

    Der Wert, mit dem der allgemeine Standort des Zertifikatsinhabers abgeglichen werden soll.

  • Organisation

    String optional

    Wenn festgelegt, der Wert, mit dem die Organisationen des Zertifikatsinhabers abgeglichen werden sollen. Mindestens eine Organisation muss mit dem Wert übereinstimmen.

  • OrganizationalUnit

    String optional

    Wenn festgelegt, der Wert, mit dem die Organisationseinheiten des Zertifikatsinhabers abgeglichen werden sollen. Mindestens eine Organisationseinheit muss mit dem Wert übereinstimmen.

ManagedBoolean

Attribute

  • Aktiv

    Boolescher Wert optional

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    Boolescher Wert optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    Boolescher Wert optional

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    Boolescher Wert optional

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    Boolescher Wert optional

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedCellularProperties

Attribute

ManagedDOMString

Attribute

  • Aktiv

    String optional

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    String optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    String optional

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    String optional

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    String optional

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedDOMStringList

Attribute

  • Aktiv

    string[] optional

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    string[] optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    string[] optional

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    string[] optional

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    string[] optional

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedEthernetProperties

Attribute

ManagedIPConfigProperties

Attribute

ManagedIPConfigType

Attribute

  • Aktiv

    IPConfigType optional

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    IPConfigType optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    IPConfigType optional

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    IPConfigType optional

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    IPConfigType optional

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedLong

Attribute

  • Aktiv

    Zahl optional

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    Zahl optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    Zahl optional

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    Zahl optional

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    Zahl optional

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedManualProxySettings

Attribute

ManagedProperties

Attribute

ManagedProxyLocation

Attribute

ManagedProxySettings

Attribute

ManagedProxySettingsType

Attribute

  • Aktiv

    Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und das Bearbeiten des Attributs zulässt (d.h. der empfohlene Attributwert der Richtlinie). Die Standardeinstellung ist false.

  • DevicePolicy

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Property-Wert ermittelt wurde.

  • SharedSetting

    Der Wert, der für alle Nutzer des Geräts festgelegt wird. Wird nur angegeben, wenn DeviceEditiable den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property erlaubt ist (d.h. der in der Richtlinie festgelegte empfohlene Property-Wert). Die Standardeinstellung ist false.

  • UserPolicy

    Der Attributwert, der in der Nutzerrichtlinie angegeben ist.

  • UserSetting

    Der Property-Wert, der vom angemeldeten Nutzer festgelegt wurde. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedThirdPartyVPNProperties

Attribute

ManagedVPNProperties

Attribute

ManagedWiFiProperties

Attribute

ManualProxySettings

Attribute

  • FTPProxy

    ProxyLocation optional

    Einstellungen für den FTP-Proxy.

  • HTTPProxy

    ProxyLocation optional

    Einstellungen für den HTTP-Proxy.

  • SOCKEN

    ProxyLocation optional

    Einstellungen für den SOCKS-Proxy.

  • SecureHTTPProxy

    ProxyLocation optional

    Einstellungen für den sicheren HTTP-Proxy.

NetworkConfigProperties

Attribute

NetworkFilter

Attribute

  • konfiguriert

    Boolescher Wert optional

    Bei Einstellung auf „true“ werden nur konfigurierte (gespeicherte) Netzwerke eingeschlossen. Die Standardeinstellung ist „false“.

  • Limit

    Zahl optional

    Maximale Anzahl der zurückzugebenden Netzwerke. Wenn kein Wert angegeben wird, wird der Standardwert 1.000 verwendet. Geben Sie 0 an, wenn Sie kein Limit haben.

  • networkType

    Der Typ der zurückzugebenden Netzwerke.

  • sichtbar

    Boolescher Wert optional

    Falls wahr, beziehen Sie nur sichtbare Netzwerke ein (physisch verbunden oder in Reichweite). Die Standardeinstellung ist „false“.

NetworkProperties

Attribute

  • Mobilfunk

    Für Mobilfunknetze: Eigenschaften von Mobilfunknetzen.

  • Anbindung

    Boolescher Wert optional

    Gibt an, ob das Netzwerk verbunden werden kann.

  • ConnectionState

    Der aktuelle Verbindungsstatus des Netzwerks.

  • ErrorState

    String optional

    Der letzte aufgezeichnete Netzwerkfehlerstatus.

  • Ethernet

    EthernetPropertiesoptional

    Bei Ethernet-Netzwerken die Ethernet-Netzwerkeigenschaften.

  • GUID

    String

    Die Netzwerk-GUID.

  • IPAddressConfigType

    IPConfigType optional

    Der Konfigurationstyp der IP-Adresse des Netzwerks.

  • IPConfigs

    IPConfigProperties[] optional

    Die IP-Konfiguration des Netzwerks.

  • MacAddress

    String optional

    Die MAC-Adresse des Netzwerks.

  • Kostenpflichtig

    Boolescher Wert optional

    Chrome (ab Version 85)

    Gibt an, ob das Netzwerk kostenpflichtig ist.

  • Name

    String optional

    Ein nutzerfreundlicher Netzwerkname.

  • NameServersConfigType

    IPConfigType optional

    Der IP-Konfigurationstyp für die vom Netzwerk verwendeten Nameserver.

  • Priorität

    Zahl optional

    Die Netzwerkpriorität.

  • ProxySettings

    ProxySettingsoptional

    Die Proxy-Einstellungen des Netzwerks.

  • RestrictedConnectivity

    Boolescher Wert optional

    Gibt bei einem verbundenen Netzwerk an, ob die Netzwerkkonnektivität zum Internet eingeschränkt ist, z.B. Das Netzwerk befindet sich hinter einem Portal oder ist kein Mobilfunknetz aktiviert.

  • SavedIPConfig

    IP-Konfiguration, die vom DHCP-Server empfangen wurde, bevor die statische IP-Konfiguration angewendet wurde.

  • Quelle

    String optional

    Gibt an, ob und wie das Netzwerk konfiguriert ist. Folgende Werte sind möglich:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    „Keine“ steht mit der Generierung des Erweiterungscodes in Konflikt. Daher müssen wir für 'Source' einen String verwenden. anstelle einer SourceType-Enum.

  • StaticIPConfig

    Die statische IP-Konfiguration des Netzwerks.

  • TrafficCounterResetTime

    Zahl optional

    Chrome 125 oder höher

    Wann der Traffic-Zähler zuletzt zurückgesetzt wurde.

  • Der Netzwerktyp.

  • VPN

    VPNProperties optional

    Bei VPN-Netzwerken die Netzwerk-VPN-Eigenschaften.

  • WLAN

    WiFiPropertiesoptional

    Bei WLANs sind dies die Eigenschaften des Netzwerks.

NetworkStateProperties

Attribute

NetworkType

Enum

„Alle“

„Mobilfunk“

"Ethernet"

"Tethering"

„VPN“

"Drahtlos"

„WLAN“

PaymentPortal

Attribute

  • Methode

    String

    Die für das Zahlungsportal zu verwendende HTTP-Methode.

  • PostData

    String optional

    Die Postdaten, die an das Zahlungsportal gesendet werden sollen. Wird ignoriert, es sei denn, Method ist POST.

  • URL

    String optional

    Die URL des Zahlungsportals.

ProxyLocation

Attribute

  • Host

    String

    Der Host der Proxy-IP-Adresse.

  • Port

    Zahl

    Der für den Proxy zu verwendende Port.

ProxySettings

Attribute

  • ExcludeDomains

    string[] optional

    Domains und Hosts, für die manuelle Proxy-Einstellungen ausgeschlossen sind.

  • Manuell

    Manuelle Proxy-Einstellungen – wird nur für Manual-Proxy-Einstellungen verwendet

  • PAC (Political Action Committee)

    String optional

    URL für die Datei zur automatischen Proxy-Konfiguration.

  • Der Typ der Proxy-Einstellungen.

ProxySettingsType

Enum

"Direkt"

„Manuell“

„PAC“

„WPAD“

SIMLockStatus

Attribute

  • LockEnabled

    boolean

    Gibt an, ob die SIM-Sperre aktiviert ist.

  • LockType

    String

    Status der SIM-Sperre. Mögliche Werte sind 'sim-pin', 'sim-puk' und ''.

  • RetriesLeft

    Zahl optional

    Anzahl der zulässigen Versuche zum Sperren der PIN, bevor zum Entsperren der SIM ein PUK erforderlich ist.

ThirdPartyVPNProperties

Attribute

  • ExtensionID

    String

    ID der Erweiterung des Drittanbieter-VPN.

  • ProviderName

    String optional

    Der Name des VPN-Anbieters.

VPNProperties

Attribute

  • AutoConnect

    Boolescher Wert optional

    Legt fest, ob das VPN-Netzwerk automatisch verbunden werden soll.

  • Host

    String optional

    Der VPN-Host.

  • Typ

    String optional

    Der VPN-Typ. Dies kann aufgrund von "L2TP-IPSec" kein Enum sein. Dies ist optional für NetworkConfigProperties, die an setProperties übergeben werden. Damit können nur bestimmte Properties festgelegt werden.

VPNStateProperties

Attribute

WiFiProperties

Attribute

  • AllowGatewayARPPolling

    Boolescher Wert optional

    Gibt an, ob ARP-Abfrage des Standardgateways zulässig ist. Der Standardwert ist „true“.

  • AutoConnect

    Boolescher Wert optional

    Legt fest, ob das WLAN automatisch verbunden werden soll, wenn es sich in Reichweite befindet.

  • BSSID

    String optional

    Die BSSID des verknüpften Zugangspunkts.

  • EAP

    EAPPropertiesoptional

    Die EAP-Eigenschaften des Netzwerks. Erforderlich für WEP-8021X- und WPA-EAP-Netzwerke.

  • Häufigkeit

    Zahl optional

    Die Betriebsfrequenz des WLAN-Dienstes in MHz. Bei verbundenen Netzwerken die aktuelle Frequenz, mit der das Netzwerk verbunden ist. Andernfalls die Häufigkeit des bestmöglichen verfügbaren BSS.

  • FrequencyList

    number[] optional

    Enthält die gesamte in letzter Zeit im WLAN ermittelte Betriebsfrequenz.

  • HexSSID

    String optional

    HEX-codierte Kopie der Netzwerk-SSID.

  • HiddenSSID

    Boolescher Wert optional

    Gibt an, ob die Netzwerk-SSID übertragen wird.

  • Passphrase

    String optional

    Chrome 66 und höher

    Die Passphrase für WEP-/WPA-/WPA2-Verbindungen. Dieses Attribut kann nur festgelegt werden – Attribute, die von getProperties zurückgegeben werden, enthalten diesen Wert nicht.

  • RoamThreshold

    Zahl optional

    Eingestellt, ignoriert.

  • SSID

    String optional

    Die Netzwerk-SSID.

  • Sicherheit

    String optional

    Der Netzwerksicherheitstyp.

  • SignalStrength

    Zahl optional

    Die Signalstärke des Netzwerks.

WiFiStateProperties

Attribute

WiMAXProperties

Attribute

  • AutoConnect

    Boolescher Wert optional

    Legt fest, ob das Netzwerk automatisch verbunden werden soll.

  • EAP

    EAPPropertiesoptional

    Die EAP-Eigenschaften des Netzwerks.

Methoden

createNetwork()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

Erstellt eine neue Netzwerkkonfiguration aus Properties. Wenn bereits ein passendes konfiguriertes Netzwerk vorhanden ist, schlägt der Vorgang fehl. Andernfalls wird die GUID des neuen Netzwerks zurückgegeben.

Parameter

  • geteilt

    boolean

    Wenn true, geben Sie diese Netzwerkkonfiguration für andere Nutzer frei.

    Diese Option ist nur in der Web-UI von Chrome sichtbar.* Bei Aufruf durch Apps ist false der einzige zulässige Wert.

  • Die Eigenschaften, mit denen das neue Netzwerk konfiguriert werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: string) => void

    • Ergebnis

      String

Gibt Folgendes zurück:

  • Promise&lt;string&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

disableNetworkType()

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

Deaktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Siehe Hinweis für enableNetworkType.

Parameter

  • networkType

    Der zu deaktivierende Netzwerktyp.

enableNetworkType()

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

Aktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Hinweis: Der Typ kann sich auf mehrere Netzwerktypen beziehen (z.B. „Drahtlos“).

Parameter

  • networkType

    Der Netzwerktyp, der aktiviert werden soll.

forgetNetwork()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

Vergisst eine Netzwerkkonfiguration, indem alle konfigurierten Eigenschaften für das Netzwerk mit der GUID networkGuid gelöscht werden. Dazu können auch andere Netzwerke mit übereinstimmenden Kennungen gehören (z.B. WLAN-SSID und -Sicherheit). Wenn eine solche Konfiguration nicht vorhanden ist, wird ein Fehler ausgegeben und der Vorgang schlägt fehl.

In Kiosksitzungen können freigegebene Netzwerkkonfigurationen bei dieser Methode nicht vergessen werden.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, das gelöscht werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getCaptivePortalStatus()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

Gibt den Captive Portal-Status für das Netzwerk zurück, das mit "networkGuid" übereinstimmt.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, für das der Captive Portal-Status abgerufen werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: CaptivePortalStatus) => void

Gibt Folgendes zurück:

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDeviceStates()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Gibt den Status verfügbarer Netzwerkgeräte zurück.

Parameter

Gibt Folgendes zurück:

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getGlobalPolicy()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

Ruft die Eigenschaften der globalen Richtlinie ab. Es ist nicht davon auszugehen, dass sich diese Eigenschaften während einer Sitzung ändern.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: GlobalPolicy) => void

Gibt Folgendes zurück:

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getManagedProperties()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

Ruft die zusammengeführten Eigenschaften des Netzwerks mit der ID "networkGuid" aus den Quellen ab: Nutzereinstellungen, gemeinsame Einstellungen, Nutzerrichtlinien, Geräterichtlinien und die derzeit aktiven Einstellungen.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, für das Eigenschaften abgerufen werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: ManagedProperties) => void

Gibt Folgendes zurück:

  • Promise&lt;ManagedProperties&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getNetworks()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

Gibt eine Liste von Netzwerkobjekten mit denselben Eigenschaften zurück, die von getState bereitgestellt werden. Ein Filter wird bereitgestellt, um den Typ der zurückgegebenen Netzwerke anzugeben und die Anzahl der Netzwerke zu begrenzen. Netzwerke werden vom System nach ihrer Priorität sortiert, wobei verbundene oder verbundene Netzwerke zuerst aufgeführt werden.

Parameter

Gibt Folgendes zurück:

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getProperties()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

Ruft alle Eigenschaften des Netzwerks mit der ID "networkGuid" ab. Enthält alle Attribute des Netzwerks (schreibgeschützte Werte und Lese-/Schreibwerte).

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, für das Eigenschaften abgerufen werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: NetworkProperties) => void

Gibt Folgendes zurück:

  • Promise&lt;NetworkProperties&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getState()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

Ruft die schreibgeschützten Eigenschaften des Netzwerks mit der ID "networkGuid" im Cache ab. Dies soll eine Funktion mit höherer Leistung bieten als getProperties, für die ein Umlauf zum Abfragen des Netzwerksubsystems erforderlich ist. Die folgenden Eigenschaften werden für alle Netzwerke zurückgegeben: GUID, Typ, Name, WiFi.Security. Für sichtbare Netzwerke werden zusätzliche Properties bereitgestellt: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, für das Eigenschaften abgerufen werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (result: NetworkStateProperties) => void

Gibt Folgendes zurück:

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

requestNetworkScan()

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

Fordert an, dass das Netzwerksubsystem nach neuen Netzwerken sucht und die von getVisibleNetworks zurückgegebene Liste aktualisiert. Dies ist lediglich eine Anfrage. Das Netzwerksubsystem kann sie ignorieren. Wenn die Liste aktualisiert wird, wird das Ereignis onNetworkListChanged ausgelöst.

Parameter

  • networkType

    NetworkType optional

    Chrome 63 und höher

    Fordert gegebenenfalls einen Scan an, der für den jeweiligen Typ spezifisch ist. Für Mobilfunknetze wird ein Mobilfunknetz-Scan angefordert, sofern dies unterstützt wird.

setProperties()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

Legt die Eigenschaften des Netzwerks mit der ID networkGuid fest. Dies gilt nur für konfigurierte Netzwerke (Quelle != None). Für nicht konfigurierte sichtbare Netzwerke sollte stattdessen createNetwork verwendet werden. In Kiosksitzungen schlägt der Aufruf dieser Methode in einem freigegebenen Netzwerk fehl.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, für das Eigenschaften festgelegt werden sollen.

  • Die festzulegenden Eigenschaften.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

startConnect()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

Stellt eine Verbindung zum Netzwerk mit networkGuid her.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, zu dem eine Verbindung hergestellt werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

startDisconnect()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

Startet die Verbindung zum Netzwerk mit networkGuid.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, von dem die Verbindung getrennt werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 125 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onDeviceStateListChanged

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

Wird ausgelöst, wenn sich die Liste der Geräte oder Gerätestatuseigenschaften geändert haben.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

onNetworkListChanged

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

Wird ausgelöst, wenn sich die Liste der Netzwerke geändert hat Sendet eine vollständige Liste der GUIDs für alle aktuellen Netzwerke.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (changes: string[]) => void

    • Änderungen

      String[]

onNetworksChanged

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

Wird ausgelöst, wenn sich die Eigenschaften in einem der Netzwerke ändern Sendet eine Liste der GUIDs für Netzwerke, deren Eigenschaften sich geändert haben.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (changes: string[]) => void

    • Änderungen

      String[]

onPortalDetectionCompleted

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

Wird ausgelöst, wenn eine Portalerkennung für ein Netzwerk abgeschlossen ist Sendet die GUID des Netzwerks und den entsprechenden Captive Portal-Status.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (networkGuid: string, status: CaptivePortalStatus) => void