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 ChromeOS-Kiosksitzungen verfügbar.

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

HINWEIS: Die meisten Wörterbucheigenschaften und Enum-Werte werden in UpperCamelCase geschrieben, um der ONC-Spezifikation zu entsprechen, und nicht in lowerCamelCase, wie es in JavaScript üblich ist.

Berechtigungen

networking.onc

Verfügbarkeit

Chrome 59 und höher Nur ChromeOS

Typen

ActivationStateType

Enum

„Aktiviert“

„Aktiviert“

„NotActivated“

„PartiallyActivated“

CaptivePortalStatus

Enum

„Unbekannt“

„Offline“

„Online“

„Portal“

„ProxyAuthRequired“

CellularProperties

Attribute

  • ActivationState

    ActivationStateType optional

    Aktivierungsstatus des Mobilfunkanbieter-Kontos.

  • 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

    Ob eine automatische Verbindung zum Mobilfunknetz hergestellt werden soll (wenn Sie sich in Reichweite befinden).

  • Familie

    String optional

    Mobilfunktechnologiefamilie – CDMA oder GSM

  • FirmwareRevision

    String optional

    Die Firmwareversion, die in das Mobilfunkmodem geladen wurde.

  • FoundNetworks

    FoundNetworkProperties[] optional

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

  • HardwareRevision

    String optional

    Die Hardwareversion des Mobilfunkmodems.

  • HomeProvider

    CellularProviderProperties optional

    Informationen zum Mobilfunkanbieter, der die im Modem installierte SIM-Karte ausgegeben 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 derzeit verwendete Netzwerktechnologie.

  • PaymentPortal

    PaymentPortal optional

    Online-Zahlungsportal, über das sich Nutzer für ein mobiles Datentarif registrieren oder diesen ändern können.

  • RoamingState

    String optional

    Der Roaming-Status des Mobilfunkmodems im aktuellen Netzwerk.

  • SIMLockStatus

    SIMLockStatus optional

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

  • SIMPresent

    boolescher Wert optional

    Ob eine SIM-Karte vorhanden ist.

  • Scannen

    boolescher Wert optional

    Chrome 63 und höher

    „True“, wenn ein Mobilfunknetz-Scan ausgeführt wird.

  • ServingOperator

    CellularProviderProperties optional

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

  • SignalStrength

    number optional

    Die aktuelle Netzwerksignalstärke.

  • SupportNetworkScan

    boolescher Wert optional

    Ob das Mobilfunknetz das Scannen unterstützt.

CellularProviderProperties

Attribute

  • Code

    String

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

  • Land

    String optional

    Der 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, falls keine Zertifikate gefunden werden, die mit diesem Muster übereinstimmen.

  • Aussteller

    IssuerSubjectPattern optional

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

  • IssuerCARef

    string[] optional

    Liste der CA-Zertifikate des Zertifikatausstellers. Ein Zertifikat muss von einer dieser Zertifizierungsstellen signiert sein, um diesem Muster zu entsprechen.

  • Betreff

    IssuerSubjectPattern optional

    Wenn festgelegt, Muster, mit dem die X.509-Subjekteinstellungen 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 „Typ“ = „Mobilfunk“ und „SIMPresent“ = „True“.

  • SIMPresent

    boolescher Wert optional

    Chrome 62 und höher

    Legen Sie den Status der SIM-Karte fest, wenn der Gerätetyp „Mobilfunk“ ist.

  • Scannen

    boolescher Wert optional

    Gibt an, ob das Gerät aktiviert ist. „wahr“, 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 ist initialisiert, aber nicht aktiviert.

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

„Aktiviert“
Das Gerät ist aktiviert.

„Unzulässig“
Das Gerät ist unzulässig.

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. Vom ONC erforderlich, wird aber möglicherweise nicht bei der Übersetzung aus Shill angegeben.

  • Passwort

    String optional

  • SaveCredentials

    boolescher Wert optional

  • ServerCAPEMs

    string[] optional

  • ServerCARefs

    string[] optional

  • SubjectMatch

    ManagedDOMString optional

    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

    Gibt an, ob das Ethernet-Netzwerk automatisch verbunden werden soll.

  • EAP

    EAPProperties optional

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

EthernetStateProperties

Attribute

FoundNetworkProperties

Attribute

  • LongName

    String optional

    Der vollständige Name des Mobilfunkanbieters.

  • NetworkId

    String

    Netzwerk-ID.

  • ShortName

    String optional

    Der Kurzname des Mobilfunkanbieters.

  • Status

    String

    Netzwerkverfügbarkeit

  • Technologie

    String

    Zugriffstechnologie, die vom Netzwerk verwendet wird.

GlobalPolicy

Attribute

  • AllowOnlyPolicyNetworksToAutoconnect

    boolescher Wert optional

    Wenn diese Option aktiviert ist, können nur Richtliniennetzwerke automatisch eine Verbindung herstellen. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnect

    boolescher Wert optional

    Wenn diese Option aktiviert ist, können nur Richtliniennetzwerke verbunden werden. Es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolescher Wert optional

    Chrome 70 und höher

    Wenn diese Option aktiviert ist und ein verwaltetes Netzwerk in der sichtbaren Netzwerkliste verfügbar ist, können nur Verbindungen zu Richtliniennetzwerken hergestellt werden. Es können 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 durch Angabe einer expliziten Netzwerkkonfiguration wieder entsperrt werden. 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

    Gateway-Adresse, die für die IP-Konfiguration verwendet wird.

  • IPAddress

    String optional

    Die IP-Adresse für eine Verbindung. Je nach Wert von Type kann es sich um eine IPv4- oder IPv6-Adresse handeln.

  • 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“

„Statisch“

IssuerSubjectPattern

Attribute

  • CommonName

    String optional

    Wenn festgelegt, der Wert, mit dem der Common Name des Zertifikatsinhabers abgeglichen werden soll.

  • Ort

    String optional

    Falls festgelegt, der Wert, mit dem der gemeinsame 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 sollte mit dem Wert übereinstimmen.

  • OrganizationalUnit

    String optional

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

ManagedBoolean

Attribute

  • Aktiv

    boolescher Wert optional

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

  • DeviceEditable

    boolescher Wert optional

    Gibt an, ob eine Geräterichtlinie für die Property vorhanden ist und die Property bearbeitet werden kann (d.h., ob der empfohlene Property-Wert in der Richtlinie festgelegt ist). 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 ist. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    boolescher Wert optional

    Der von der Nutzerrichtlinie angegebene Property-Wert.

  • UserSetting

    boolescher Wert 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

    boolescher Wert optional

    Gibt an, ob eine Geräterichtlinie für die Property vorhanden ist und die Property bearbeitet werden kann (d.h., ob der empfohlene Property-Wert in der Richtlinie festgelegt ist). 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 ist. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    String optional

    Der von der Nutzerrichtlinie angegebene 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

    boolescher Wert optional

    Gibt an, ob eine Geräterichtlinie für die Property vorhanden ist und die Property bearbeitet werden kann (d.h., ob der empfohlene Property-Wert in der Richtlinie festgelegt ist). 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 ist. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    string[] optional

    Der von der Nutzerrichtlinie angegebene 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

    boolescher Wert optional

    Gibt an, ob eine Geräterichtlinie für die Property vorhanden ist und die Property bearbeitet werden kann (d.h., ob der empfohlene Property-Wert in der Richtlinie festgelegt ist). 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 ist. Wird nur angegeben, wenn DeviceEditiable true ist.

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    IPConfigType optional

    Der von der Nutzerrichtlinie angegebene 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

    boolescher Wert optional

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

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    number optional

    Der von der Nutzerrichtlinie angegebene 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

    boolescher Wert optional

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

  • UserEditable

    boolescher Wert optional

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

  • UserPolicy

    ProxySettingsType optional

    Der von der Nutzerrichtlinie angegebene 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

    boolescher Wert optional

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

  • Limit

    number optional

    Maximale Anzahl der zurückzugebenden Netzwerke. Wenn keine Angabe gemacht wird, ist der Standardwert 1.000. Geben Sie „0“ ein, wenn kein Limit festgelegt werden soll.

  • networkType

    NetworkType

    Die Art der Netzwerke, die zurückgegeben werden sollen.

  • sichtbar

    boolescher Wert optional

    Wenn diese Option aktiviert ist, werden nur sichtbare Netzwerke (physisch verbunden oder in Reichweite) berücksichtigt. Die Standardeinstellung ist „false“.

NetworkProperties

Attribute

  • Mobilfunk

    CellularProperties optional

    Für Mobilfunknetze: Mobilfunknetzeigenschaften

  • Verbindbar

    boolescher Wert optional

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

  • ConnectionState

    ConnectionStateType optional

    Der aktuelle Verbindungsstatus des Netzwerks.

  • ErrorState

    String optional

    Der zuletzt aufgezeichnete Netzwerkfehlerstatus.

  • Ethernet

    EthernetProperties optional

    Für Ethernet-Netzwerke 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

    MAC-Adresse des Netzwerks.

  • Kostenpflichtig

    boolescher Wert optional

    Chrome 85 und höher

    Ob das Netzwerk eine begrenzte Datenübertragung hat.

  • 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

    boolescher Wert optional

    Ob die Netzwerkverbindung zu einem verbundenen Netzwerk 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“ (Kein) führt zu Konflikten bei der Codegenerierung für Erweiterungen. Daher müssen wir für „Source“ (Quelle) einen String anstelle eines SourceType-Eintrags verwenden.

  • StaticIPConfig

    IPConfigProperties optional

    Die statische IP-Konfiguration des Netzwerks.

  • TrafficCounterResetTime

    number optional

    Chrome 125 und höher

    Wann die Besucherzä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“

„Wireless“

„WLAN“

PaymentPortal

Attribute

  • Methode

    String

    Die HTTP-Methode, die für das Zahlungsportal verwendet werden soll.

  • 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 Proxy-IP-Adresshost.

  • 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 Proxy-Einstellungen – nur für Manual-Proxy-Einstellungen verwendet.

  • PAC (Political Action Committee)

    String optional

    URL der Proxy-Auto-Konfigurationsdatei.

  • Der Typ der Proxyeinstellungen.

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 zulässigen PIN-Sperrbemühungen, bevor der PUK zum Entsperren der SIM-Karte erforderlich ist.

ThirdPartyVPNProperties

Attribute

  • ExtensionID

    String

    ID der Erweiterung des VPN-Anbieters.

  • ProviderName

    String optional

    Der Name des VPN-Anbieters.

VPNProperties

Attribute

  • AutoConnect

    boolescher Wert optional

    Ob das VPN-Netzwerk automatisch verbunden werden soll.

  • Host

    String optional

    Der VPN-Host.

  • Typ

    String optional

    VPN-Typ Dies kann keine Enum sein, da „L2TP-IPSec“ enthalten ist. Dies ist für NetworkConfigProperties optional. Diese werden an setProperties übergeben, mit dem nur bestimmte Properties festgelegt werden können.

VPNStateProperties

Attribute

WiFiProperties

Attribute

  • AllowGatewayARPPolling

    boolescher Wert optional

    Seit Chrome 131 eingestellt

    In M131 entfernt. Derzeit findet keine aktive ARP-Abfrage statt.

  • AutoConnect

    boolescher Wert optional

    Ob eine automatische Verbindung zum WLAN hergestellt werden soll, wenn sich das Gerät in Reichweite befindet.

  • BSSID

    String optional

    Die BSSID des zugehörigen Zugangspunkts.

  • EAP

    EAPProperties optional

    Die EAP-Eigenschaften 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 Frequenz des besten verfügbaren BSS.

  • FrequencyList

    number[] optional

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

  • HexSSID

    String optional

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

  • RoamThreshold

    number optional

    Verworfen, wird 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

    boolescher Wert optional

    Ob eine automatische Verbindung zum Netzwerk hergestellt werden soll.

  • EAP

    EAPProperties optional

    Die EAP-Eigenschaften des Netzwerks.

Methoden

createNetwork()

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

Erstellt eine neue Netzwerkkonfiguration aus Properties. Wenn bereits ein übereinstimmendes konfiguriertes Netzwerk vorhanden ist, schlägt dieser 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-Benutzeroberfläche von Chrome verfügbar.* Wenn der Dienst von Apps aufgerufen wird, ist false der einzige zulässige Wert.

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: string) => void

    • Ergebnis

      String

Gibt Folgendes zurück:

  • Promise<string>

    Chrome 125 und höher

    Versprechen 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,
)

Alle Geräte werden deaktiviert, die dem angegebenen Netzwerktyp entsprechen. Siehe Hinweis zu enableNetworkType.

Parameter

  • networkType

    NetworkType

    Der Typ des zu deaktivierenden Netzwerks.

enableNetworkType()

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

Alle Geräte werden aktiviert, die dem angegebenen Netzwerktyp entsprechen. Hinweis: 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,
)

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

In Kiosksitzungen kann mit dieser Methode keine gemeinsame Netzwerkkonfiguration entfernt werden.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, das entfernt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 125 und höher

    Versprechen 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,
)

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

    function optional

    Der Parameter callback sieht so aus: 

    (result: CaptivePortalStatus) => void

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

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

Parameter

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

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

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: GlobalPolicy) => void

Gibt Folgendes zurück:

  • Promise<GlobalPolicy>

    Chrome 125 und höher

    Versprechen 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,
)

Die zusammengeführten Eigenschaften des Netzwerks mit der ID „networkGuid“ aus den folgenden Quellen abrufen: Nutzereinstellungen, freigegebene Einstellungen, Nutzerrichtlinie, Geräterichtlinie und die derzeit aktiven Einstellungen.

Parameter

  • networkGuid

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: ManagedProperties) => void

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

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

Parameter

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

Ruft alle Properties des Netzwerks mit der ID „networkGuid“ ab. Enthält alle Eigenschaften des Netzwerks (Lese- und Lese-/Schreibwerte).

Parameter

  • networkGuid

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: NetworkProperties) => void

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

Ruft die im Cache gespeicherten schreibgeschützten Properties des Netzwerks mit der ID „networkGuid“ ab. Diese Funktion soll eine höhere Leistung als getProperties bieten, für die ein Roundtrip zur Abfrage des Netzwerk-Subsystems erforderlich ist. Für alle Netzwerke werden die folgenden Properties zurückgegeben: GUID, Typ, Name und 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 Unterkünfte abgerufen werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: NetworkStateProperties) => void

Gibt Folgendes zurück:

  • Chrome 125 und höher

    Versprechen 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,
)

Das Netzwerk-Subsystem wird aufgefordert, nach neuen Netzwerken zu suchen und die von getVisibleNetworks zurückgegebene Liste zu aktualisieren. 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

    Wenn angegeben, wird ein Scan angefordert, der für den Typ spezifisch ist. Bei der Mobilfunkverbindung wird eine Suche nach einem Mobilfunknetz angefordert, sofern dies unterstützt wird.

setProperties()

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

Legt die Eigenschaften des Netzwerks mit der ID networkGuid fest. Diese Option ist nur für konfigurierte Netzwerke gültig (Source != None). Für nicht konfigurierte sichtbare Netzwerke sollte stattdessen createNetwork verwendet werden. In Kiosksektionen 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 zu setzenden Properties.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 125 und höher

    Versprechen 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,
)

Stellt eine Verbindung zum Netzwerk mit networkGuid her.

Parameter

  • networkGuid

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 125 und höher

    Versprechen 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,
)

Trennt die Verbindung zum Netzwerk mit networkGuid.

Parameter

  • networkGuid

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 125 und höher

    Versprechen 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 Geräteliste 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. Es wird eine vollständige Liste der GUIDs für alle aktuellen Netzwerke gesendet.

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 Properties in einem der Netzwerke ändern. Es wird eine Liste von GUIDs für Netzwerke gesendet, 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. Die GUID des Netzwerks und der entsprechende Captive-Portal-Status werden gesendet.

Parameter