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.

Netzwerkverbindungskonfigurationen werden gemäß der Open Network Configuration (ONC)-Spezifikation angegeben.

HINWEIS: Die meisten Wörterbucheigenschaften und Enum-Werte verwenden UpperCamelCase, um der ONC-Spezifikation zu entsprechen, anstatt der JavaScript-Konvention „lowerCamelCase“.

Berechtigungen

networking.onc

Verfügbarkeit

Chrome 59 und höher Nur ChromeOS

Typen

ActivationStateType

Enum

Aktiviert

Aktivieren

„NotActivated“

„PartiallyActivated“

CaptivePortalStatus

Enum

„Unbekannt“

„Offline“

„Online“

„Portal“

„ProxyAuthRequired“

CellularProperties

Attribute

  • ActivationState

    ActivationStateType optional

    Aktivierungsstatus des Anbieterkontos.

  • ActivationType

    String optional

    Der Aktivierungstyp des Mobilfunknetzes.

  • AllowRoaming

    boolean optional

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

  • AutoConnect

    boolean optional

    Gibt an, ob automatisch eine Verbindung zum Mobilfunknetz hergestellt werden soll, wenn sich das Gerät in Reichweite befindet.

  • Familie

    String optional

    Familie der Mobilfunkgerätetechnologie – CDMA oder GSM.

  • FirmwareRevision

    String optional

    Die im Mobilfunkmodem geladene Firmware-Version.

  • FoundNetworks

    FoundNetworkProperties[] optional

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

  • HardwareRevision

    String optional

    Die Hardware-Revision des Mobilfunkmodems.

  • HomeProvider

    CellularProviderProperties optional

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

  • Hersteller

    String optional

    Hersteller des Mobilfunkmodems.

  • ModelID

    String optional

    Die Modell-ID des Mobilfunkmodems.

  • NetworkTechnology

    String optional

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

  • PaymentPortal

    PaymentPortal optional

    Online-Zahlungsportal, über das sich ein Nutzer für einen Mobilfunktarif registrieren oder einen Mobilfunktarif ändern kann.

  • RoamingState

    String optional

    Der Roaming-Status des Mobilfunkmodems im aktuellen Netzwerk.

  • SIMLockStatus

    SIMLockStatus optional

    Der Status der SIM-Sperre für GSM-Familiennetzwerke.

  • SIMPresent

    boolean optional

    Gibt an, ob eine SIM-Karte vorhanden ist.

  • Scannen

    boolean optional

    Chrome 63 und höher

    „True“, wenn ein Mobilfunknetzscan ausgeführt wird.

  • ServingOperator

    CellularProviderProperties optional

    Informationen zum Mobilfunkanbieter, in dessen Netzwerk das Modem derzeit registriert ist.

  • SignalStrength

    number optional

    Die aktuelle Signalstärke des Netzwerks.

  • SupportNetworkScan

    boolean optional

    Gibt an, ob das Mobilfunknetz Scannen unterstützt.

CellularProviderProperties

Attribute

  • Code

    String

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

  • Land

    String optional

    Ländercode mit zwei Buchstaben.

  • Name

    String

    Der Name des Betreibers.

CellularStateProperties

Attribute

CertificatePattern

Attribute

  • EnrollmentURI

    string[] optional

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

  • Aussteller

    IssuerSubjectPattern optional

    Wenn festgelegt, wird das Muster verwendet, mit dem die X.509-Ausstellereinstellungen abgeglichen werden sollen.

  • IssuerCARef

    string[] optional

    Liste der CA-Zertifikate der Zertifikatsaussteller. Ein Zertifikat muss von einer dieser Zertifizierungsstellen signiert sein, damit es diesem Muster entspricht.

  • Betreff

    IssuerSubjectPattern optional

    Wenn festgelegt, wird das Muster verwendet, mit dem die Einstellungen für das X.509-Subjekt abgeglichen werden sollen.

ClientCertificateType

Enum

"Ref"

„Muster“

ConnectionStateType

Enum

„Verbunden“

„Verbinden“

"NotConnected"

DeviceStateProperties

Attribute

  • SIMLockStatus

    SIMLockStatus optional

    Chrome 62 und höher

    Der SIM-Lock-Status, wenn „Type“ = „Cellular“ und „SIMPresent“ = „True“.

  • SIMPresent

    boolean optional

    Chrome 62 und höher

    Wird auf den Status „SIM vorhanden“ gesetzt, wenn der Gerätetyp „Mobilfunk“ ist.

  • Scannen

    boolean optional

    Gibt an, ob das Gerät aktiviert ist. „true“, wenn das Gerät gerade scannt.

  • Der aktuelle Status des Geräts.

  • Der mit dem Gerät verknüpfte Netzwerktyp (Mobilfunk, Ethernet oder WLAN).

DeviceStateType

Enum

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

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

Aktivieren
Der aktivierte Status wurde angefordert, ist aber noch nicht abgeschlossen.

„Aktiviert“
Das Gerät ist aktiviert.

„Verboten“
Gerät ist verboten.

EAPProperties

Attribute

  • AnonymousIdentity

    String optional

  • ClientCertPKCS11Id

    String optional

    Chrome 60 und höher
  • ClientCertPattern

    CertificatePattern optional

  • ClientCertProvisioningProfileId

    String optional

    Chrome 93 und höher
  • ClientCertRef

    String optional

  • ClientCertType

    ClientCertificateType

  • Identität

    String optional

  • Inner

    String optional

  • Outer

    String optional

    Der äußere EAP-Typ. Von ONC erforderlich, wird aber bei der Übersetzung aus Shill möglicherweise nicht angegeben.

  • Passwort

    String optional

  • SaveCredentials

    boolean optional

  • ServerCAPEMs

    string[] optional

  • ServerCARefs

    string[] optional

  • SubjectMatch

    ManagedDOMString optional

    Chrome 60 und höher
  • UseProactiveKeyCaching

    boolean optional

  • UseSystemCAs

    boolean optional

EthernetProperties

Attribute

  • Authentifizierung

    String optional

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

  • AutoConnect

    boolean optional

    Gibt an, ob die Verbindung zum Ethernet-Netzwerk automatisch hergestellt werden soll.

  • EAP

    EAPProperties optional

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

EthernetStateProperties

Attribute

FoundNetworkProperties

Attribute

  • LongName

    String optional

    Der Name des Mobilfunkanbieters im Langformat.

  • NetworkId

    String

    Netzwerk-ID.

  • ShortName

    String optional

    Der Name des Netzbetreibers in Kurzform.

  • Status

    String

    Netzwerkverfügbarkeit.

  • Technologie

    String

    Vom Netzwerk verwendete Zugriffstechnologie.

GlobalPolicy

Attribute

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean optional

    Wenn „true“, dürfen nur Richtliniennetzwerke automatisch eine Verbindung herstellen. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnect

    boolean optional

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean optional

    Chrome 70 und höher

    Wenn „true“ und ein verwaltetes Netzwerk in der sichtbaren Netzwerkliste verfügbar ist, dürfen nur Richtliniennetzwerke verbunden werden und es dürfen keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".

  • BlockedHexSSIDs

    string[] optional

    Chrome 86 und höher

    Liste der blockierten Netzwerke. Verbindungen zu blockierten Netzwerken sind nicht zulässig. Netzwerke können wieder entsperrt werden, indem eine explizite Netzwerkkonfiguration angegeben wird. Die Standardeinstellung ist eine leere Liste.

IPConfigProperties

Attribute

  • ExcludedRoutes

    string[] optional

    Chrome 76 und höher

    Array von IP-Blöcken in CIDR-Notation. Weitere Informationen finden Sie unter onc_spec.md.

  • Gateway

    String optional

    Für die IP-Konfiguration verwendete Gateway-Adresse.

  • 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. Weitere Informationen finden Sie unter onc_spec.md.

  • NameServers

    string[] optional

    Array von Adressen, die für Nameserver verwendet werden.

  • RoutingPrefix

    number optional

    Das Routing-Präfix.

  • SearchDomains

    string[] optional

    Chrome 76 und höher

    Array von Strings für die Namensauflösung. Weitere Informationen finden Sie in onc_spec.md.

  • Typ

    String optional

    Der IP-Konfigurationstyp. Kann IPv4 oder IPv6 sein.

  • WebProxyAutoDiscoveryUrl

    String optional

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

IPConfigType

Enum

„DHCP“

„Static“

IssuerSubjectPattern

Attribute

  • CommonName

    String optional

    Falls festgelegt, der Wert, mit dem der allgemeine Name des Zertifikatsubjekts abgeglichen werden soll.

  • Ort

    String optional

    Falls festgelegt, der Wert, mit dem der allgemeine Standort des Zertifikatsubjekts abgeglichen werden soll.

  • Organisation

    String optional

    Falls festgelegt, der Wert, mit dem die Organisationen des Zertifikatsubjekts verglichen werden sollen. Mindestens eine Organisation sollte mit dem Wert übereinstimmen.

  • OrganizationalUnit

    String optional

    Falls festgelegt, der Wert, mit dem die Organisationseinheiten des Zertifikatsubjekts abgeglichen werden sollen. Mindestens eine Organisationseinheit sollte mit dem Wert übereinstimmen.

ManagedBoolean

Attribute

  • Aktiv

    boolean optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). Die Standardeinstellung ist false.

  • DevicePolicy

    boolean optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

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

  • SharedSetting

    boolean optional

    Der für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    boolean optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    boolean optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

ManagedCellularProperties

Attribute

ManagedDOMString

Attribute

  • Aktiv

    String optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). 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 für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    String optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    String optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

ManagedDOMStringList

Attribute

  • Aktiv

    string[] optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). 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 für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    string[] optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    string[] optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

ManagedEthernetProperties

Attribute

ManagedIPConfigProperties

Attribute

ManagedIPConfigType

Attribute

  • Aktiv

    IPConfigType optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). 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 für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    IPConfigType optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    IPConfigType optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

ManagedLong

Attribute

  • Aktiv

    number optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). Die Standardeinstellung ist false.

  • DevicePolicy

    number optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

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

  • SharedSetting

    number optional

    Der für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    number optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    number optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

ManagedManualProxySettings

Attribute

ManagedProperties

Attribute

ManagedProxyLocation

Attribute

ManagedProxySettings

Attribute

ManagedProxySettingsType

Attribute

  • Aktiv

    ProxySettingsType optional

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

  • DeviceEditable

    boolean optional

    Gibt an, ob eine DevicePolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert durch die Richtlinie festgelegt wird). Die Standardeinstellung ist false.

  • DevicePolicy

    ProxySettingsType optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Effektiv

    String optional

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

  • SharedSetting

    ProxySettingsType optional

    Der für alle Nutzer des Geräts festgelegte Wert. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolean optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und ob die Property bearbeitet werden darf (d.h. ob der empfohlene Property-Wert für die Richtlinie festgelegt ist). Die Standardeinstellung ist false.

  • UserPolicy

    ProxySettingsType optional

    Der von der Nutzerrichtlinie bereitgestellte Property-Wert.

  • UserSetting

    ProxySettingsType optional

    Der vom angemeldeten Nutzer festgelegte Property-Wert. Wird nur angegeben, wenn UserEditable true ist.

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.

  • SOCKS

    ProxyLocation optional

    Einstellungen für SOCKS-Proxy.

  • SecureHTTPProxy

    ProxyLocation optional

    Einstellungen für sicheren HTTP-Proxy.

NetworkConfigProperties

Attribute

NetworkFilter

Attribute

  • konfiguriert

    boolean optional

    Falls „true“, werden nur konfigurierte (gespeicherte) Netzwerke berücksichtigt. Die Standardeinstellung ist „false“.

  • Limit

    number optional

    Maximale Anzahl der zurückzugebenden Netzwerke. Wenn keine Angabe erfolgt, wird standardmäßig 1.000 verwendet. Verwenden Sie 0 für kein Limit.

  • networkType

    NetworkType

    Der Typ der zurückzugebenden Netzwerke.

  • sichtbar

    boolean optional

    Wenn „true“, werden nur sichtbare (physisch verbundene oder in Reichweite befindliche) Netzwerke berücksichtigt. Die Standardeinstellung ist „false“.

NetworkProperties

Attribute

  • Mobilfunk

    CellularProperties optional

    Für Mobilfunknetze: Mobilfunknetzeigenschaften.

  • Verbindbar

    boolean optional

    Gibt an, ob eine Verbindung zum Netzwerk hergestellt werden kann.

  • ConnectionState

    ConnectionStateType optional

    Der aktuelle Verbindungsstatus des Netzwerks.

  • ErrorState

    String optional

    Der letzte aufgezeichnete Netzwerkfehlerstatus.

  • Ethernet

    EthernetProperties optional

    Für Ethernet-Netzwerke die Eigenschaften des Ethernet-Netzwerks.

  • 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

    boolean optional

    Chrome 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

    number optional

    Die Netzwerkpriorität.

  • ProxySettings

    ProxySettings optional

    Die Proxyeinstellungen des Netzwerks.

  • RestrictedConnectivity

    boolean optional

    Bei einem verbundenen Netzwerk wird angegeben, ob die Netzwerkverbindung zum Internet eingeschränkt ist, z.B. wenn sich das Netzwerk hinter einem Portal befindet oder ein Mobilfunknetz nicht aktiviert ist.

  • SavedIPConfig

    IPConfigProperties optional

    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

    „None“ steht im Konflikt mit der Generierung von Erweiterungscode. Daher müssen wir für „Source“ einen String anstelle eines SourceType-Enums verwenden.

  • StaticIPConfig

    IPConfigProperties optional

    Die statische IP-Konfiguration des Netzwerks.

  • TrafficCounterResetTime

    number optional

    Chrome 125 und höher

    Wann die Traffic-Zähler zuletzt zurückgesetzt wurden.

  • Der Netzwerktyp.

  • VPN

    VPNProperties optional

    Für VPN-Netzwerke die VPN-Eigenschaften des Netzwerks.

  • WLAN

    WiFiProperties optional

    Für WLANs die WLAN-Eigenschaften des Netzwerks.

NetworkStateProperties

Attribute

NetworkType

Enum

„Alle“

„Mobilfunk“

„Ethernet“

„Tether“

„VPN“

„Kabellos“

„WLAN“

PaymentPortal

Attribute

  • Methode

    String

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

  • PostData

    String optional

    Die POST-Daten, die an das Zahlungsportal gesendet werden sollen. Wird ignoriert, sofern Method nicht POST ist.

  • URL

    String optional

    Die URL des Zahlungsportals.

ProxyLocation

Attribute

  • Host

    String

    Der Host der Proxy-IP-Adresse.

  • Port

    Zahl

    Der Port, der für den Proxy verwendet werden soll.

ProxySettings

Attribute

  • ExcludeDomains

    string[] optional

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

  • Manuell

    ManualProxySettings optional

    Manuelle Proxyeinstellungen – werden nur für Manual-Proxyeinstellungen verwendet.

  • PAC (Political Action Committee)

    String optional

    URL für die automatische Konfigurationsdatei des Proxys.

  • 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

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

  • RetriesLeft

    number optional

    Anzahl der Versuche, die PIN-Sperre zu umgehen, bevor die PUK zum Entsperren der SIM-Karte erforderlich ist.

ThirdPartyVPNProperties

Attribute

  • ExtensionID

    String

    ID der Erweiterung des Drittanbieter-VPN-Anbieters.

  • ProviderName

    String optional

    Der Name des VPN-Anbieters.

VPNProperties

Attribute

  • AutoConnect

    boolean optional

    Gibt an, ob automatisch eine Verbindung zum VPN-Netzwerk hergestellt 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, das an setProperties übergeben wird. Damit können nur bestimmte Properties festgelegt werden.

VPNStateProperties

Attribute

WiFiProperties

Attribute

  • AllowGatewayARPPolling

    boolean optional

    Seit Chrome 131 eingestellt

    In M131 entfernt. Derzeit findet kein aktives ARP-Polling statt.

  • AutoConnect

    boolean optional

    Gibt an, ob automatisch eine Verbindung zum WLAN hergestellt werden soll, wenn es sich in Reichweite befindet.

  • BSSID

    String optional

    Die BSSID des zugehörigen Zugangspunkts.

  • EAP

    EAPProperties optional

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

  • Häufigkeit

    number 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 BSS.

  • FrequencyList

    number[] optional

    Enthält alle Betriebsfrequenzen, die für das WLAN in letzter Zeit verwendet wurden.

  • HexSSID

    String optional

    HEX-codierte Kopie der Netzwerk-SSID.

  • HiddenSSID

    boolean 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. Diese Eigenschaft kann nur festgelegt werden. Von getProperties zurückgegebene Eigenschaften enthalten diesen Wert nicht.

  • RoamThreshold

    number optional

    Verworfen, ignoriert.

  • SSID

    String optional

    Die Netzwerk-SSID.

  • Sicherheit

    String optional

    Der Netzwerksicherheitstyp.

  • SignalStrength

    number optional

    Die Signalstärke des Netzwerks.

WiFiStateProperties

Attribute

WiMAXProperties

Attribute

  • AutoConnect

    boolean optional

    Gibt an, ob die Verbindung zum Netzwerk automatisch hergestellt werden soll.

  • EAP

    EAPProperties optional

    Die EAP-Attribute des Netzwerks.

Methoden

createNetwork()

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

Erstellt eine neue Netzwerkkonfiguration aus Properties. Wenn bereits ein entsprechendes 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 verfügbar.* Wenn die Funktion von Apps aufgerufen wird, ist false der einzig zulässige Wert.

  • Die Attribute zum Konfigurieren des neuen Netzwerks.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: string) => void

    • Ergebnis

      String

Ausgabe

  • Promise<string>

    Chrome 125 und höher

    Promises 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,
): void

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

Parameter

  • networkType

    NetworkType

    Der Typ des zu deaktivierenden Netzwerks.

enableNetworkType()

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

Aktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Der Typ kann mehrere Netzwerktypen darstellen, z.B. „Drahtlos“.

Parameter

  • networkType

    NetworkType

    Der zu aktivierende Netzwerktyp.

forgetNetwork()

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

Löscht eine Netzwerkkonfiguration, indem alle konfigurierten Attribute 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 keine solche Konfiguration vorhanden ist, wird ein Fehler ausgegeben und der Vorgang schlägt fehl.

In Kiosksitzungen können mit dieser Methode keine gemeinsam genutzten Netzwerkkonfigurationen entfernt werden.

Parameter

  • networkGuid

    String

    Die GUID des zu entfernenden Netzwerks.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 und höher

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

getCaptivePortalStatus()

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

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: 

    (result: CaptivePortalStatus) => void

Ausgabe

  • Chrome 125 und höher

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

getDeviceStates()

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

Gibt den Status der verfügbaren Netzwerkgeräte zurück.

Parameter

Ausgabe

  • Chrome 125 und höher

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

getGlobalPolicy()

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

Ruft die globalen Richtlinieneigenschaften ab. Diese Eigenschaften sollten sich während einer Sitzung nicht ändern.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: GlobalPolicy) => void

Ausgabe

  • Promise<GlobalPolicy>

    Chrome 125 und höher

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

getManagedProperties()

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

Ruft die zusammengeführten Eigenschaften des Netzwerks mit der ID „networkGuid“ aus den folgenden Quellen ab: Nutzereinstellungen, freigegebene Einstellungen, Nutzerrichtlinie, Geräterichtlinie 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: 

    (result: ManagedProperties) => void

Ausgabe

  • Chrome 125 und höher

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

getNetworks()

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

Gibt eine Liste von Netzwerkobjekten mit denselben Eigenschaften zurück, die von getState bereitgestellt werden. Mit einem Filter können Sie den Typ der zurückgegebenen Netzwerke angeben und die Anzahl der Netzwerke begrenzen. Netzwerke werden vom System nach Priorität sortiert. Verbundene oder sich verbindende Netzwerke werden zuerst aufgeführt.

Parameter

Ausgabe

  • Chrome 125 und höher

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

getProperties()

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

Ruft alle Eigenschaften des Netzwerks mit der ID „networkGuid“ ab. Enthält alle Attribute des Netzwerks (schreibgeschützte 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: 

    (result: NetworkProperties) => void

Ausgabe

  • Chrome 125 und höher

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

getState()

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

Ruft die im Cache gespeicherten schreibgeschützten Eigenschaften des Netzwerks mit der ID „networkGuid“ ab. Diese Funktion soll leistungsstärker als getProperties sein, für die ein Roundtrip zum Abfragen des Netzwerksubsystems erforderlich ist. Für alle Netzwerke werden die folgenden Eigenschaften zurückgegeben: GUID, Type, Name, WiFi.Security. Für sichtbare Netzwerke werden zusätzliche Eigenschaften 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: 

    (result: NetworkStateProperties) => void

Ausgabe

  • Chrome 125 und höher

    Promises 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,
): void

Anfragen, mit denen das Netzwerk-Subsystem nach neuen Netzwerken sucht und die von getVisibleNetworks zurückgegebene Liste aktualisiert. Dies ist nur eine Anfrage. Das Netzwerk-Subsystem kann sie ignorieren. Wenn die Liste aktualisiert wird, wird das Ereignis onNetworkListChanged ausgelöst.

Parameter

  • networkType

    NetworkType optional

    Chrome 63 und höher

    Falls angegeben, wird ein typenspezifischer Scan angefordert. Bei Mobilfunk wird, sofern unterstützt, eine Mobilfunknetzsuche angefordert.

setProperties()

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

Legt die Eigenschaften des Netzwerks mit der ID networkGuid fest. Dies gilt nur für konfigurierte Netzwerke (Source != None). Für nicht konfigurierte sichtbare Netzwerke sollte stattdessen createNetwork verwendet werden. In Kiosk-Sitzungen 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 Attribute.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 und höher

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

startConnect()

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

Stellt eine Verbindung zum Netzwerk mit networkGuid her.

Parameter

  • networkGuid

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 und höher

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

startDisconnect()

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

Trennt 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: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 und höher

    Promises 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 die Eigenschaften des Gerätestatus geändert haben.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => 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: 

    (changes: string[]) => void

    • Änderungen

      String[]

onNetworksChanged

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (changes: string[]) => void

    • Änderungen

      String[]

onPortalDetectionCompleted

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

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

Parameter