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.

NOTE: Die meisten Wörterbuchattribute und Enum-Werte verwenden UpperCamelCase, um der ONC-Spezifikation zu entsprechen, anstatt der JavaScript-Konvention lowerCamelCase.

Berechtigungen

networking.onc

Verfügbarkeit

Chrome 59 oder höher Nur ChromeOS

Typen

ActivationStateType

Enum

Aktiviert

Aktivieren

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Unknown"

Offline

Online

„Portal“

"ProxyAuthRequired"

CellularProperties

Attribute

  • ActivationState

    ActivationStateType optional

    Aktivierungsstatus des Mobilfunkkontos.

  • ActivationType

    String optional

    Der Aktivierungstyp des Mobilfunknetzes.

  • AllowRoaming

    Boolesch optional

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

  • AutoConnect

    Boolesch optional

    Gibt an, ob das Mobilfunknetz automatisch verbunden werden soll, wenn es in Reichweite ist.

  • Familie

    String optional

    Technologiefamilie des Mobilfunkgeräts – CDMA oder GSM.

  • FirmwareRevision

    String optional

    Die im Mobilfunkmodem geladene Firmwareversion.

  • FoundNetworks

    FoundNetworkProperties[] optional

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

  • HardwareRevision

    String optional

    Die Hardwarerevision des Mobilfunkmodems.

  • HomeProvider

    CellularProviderProperties optional

    Informationen zum Betreiber, der die SIM-Karte ausgestellt hat, die derzeit im Modem installiert ist.

  • 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

    Onlinezahlungsportal, über das ein Nutzer einen Tarif für mobile Daten abschließen oder ändern kann.

  • RoamingState

    String optional

    Der Roaming-Status des Mobilfunkmodems im aktuellen Netzwerk.

  • SIMLockStatus

    SIMLockStatus optional

    Der Status des SIM-Locks für GSM-Familiennetzwerke.

  • SIMPresent

    Boolesch optional

    Ob eine SIM-Karte vorhanden ist.

  • Scannen

    Boolesch optional

    Chrome 63 oder 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 Signalstärke des Netzwerks.

  • SupportNetworkScan

    Boolesch optional

    Gibt an, ob das Mobilfunknetz das Scannen unterstützt.

CellularProviderProperties

Attribute

  • Code

    String

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

  • Land

    String optional

    Der zweistellige Ländercode.

  • Name

    String

    Der Name des Betreibers.

CellularStateProperties

Attribute

CertificatePattern

Attribute

  • EnrollmentURI

    string[] optional

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

  • Aussteller

    IssuerSubjectPattern optional

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

  • IssuerCARef

    string[] optional

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

  • Betreff

    IssuerSubjectPattern optional

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

ClientCertificateType

Enum

"Ref"

„Muster“

ConnectionStateType

Enum

Verbunden

„Verbindung wird hergestellt“

"NotConnected"

DeviceStateProperties

Attribute

  • SIMLockStatus

    SIMLockStatus optional

    Chrome 62 oder höher

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

  • SIMPresent

    Boolesch optional

    Chrome 62 oder höher

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

  • Scannen

    Boolesch optional

    Legt fest, ob das Gerät aktiviert ist. „True“, wenn das Gerät gerade scannt.

  • Bundesland

    DeviceStateType

    Der aktuelle Status des Geräts.

  • Der Netzwerktyp, der dem Gerät zugeordnet ist (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.

„Wird aktiviert“
Der Status „Aktiviert“ wurde angefordert, ist aber noch nicht abgeschlossen.

Aktiviert
Das Gerät ist aktiviert.

„Verboten“
Das Gerät ist verboten.

EAPProperties

Attribute

  • AnonymousIdentity

    String optional

  • ClientCertPKCS11Id

    String optional

    Chrome 60 oder 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. Wird von ONC benötigt, wird aber möglicherweise nicht bereitgestellt, wenn aus Shill übersetzt wird.

  • Passwort

    String optional

  • SaveCredentials

    Boolesch optional

  • ServerCAPEMs

    string[] optional

  • ServerCARefs

    string[] optional

  • SubjectMatch

    ManagedDOMString optional

    Chrome 60 oder höher
  • UseProactiveKeyCaching

    Boolesch optional

  • UseSystemCAs

    Boolesch optional

EthernetProperties

Attribute

  • Authentifizierung

    String optional

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

  • AutoConnect

    Boolesch optional

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

  • EAP

    EAPProperties optional

    EAP-Einstellungen des Netzwerks. Erforderlich für die 8021X-Authentifizierung.

EthernetStateProperties

Attribute

FoundNetworkProperties

Attribute

  • LongName

    String optional

    Der Name des Netzbetreibers im Langformat.

  • NetworkId

    String

    Netzwerk-ID.

  • ShortName

    String optional

    Der Kurzname des Netzbetreibers.

  • Status

    String

    Netzwerkverfügbarkeit.

  • Technologie

    String

    Vom Netzwerk verwendete Zugriffstechnologie.

GlobalPolicy

Attribute

  • AllowOnlyPolicyNetworksToAutoconnect

    Boolesch optional

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

  • AllowOnlyPolicyNetworksToConnect

    Boolesch optional

    Wenn „true“ festgelegt ist, können nur Verbindungen zu Richtliniennetzwerken hergestellt werden. Es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    Boolesch optional

    Chrome 70 oder höher

    Wenn die Richtlinie auf „true“ gesetzt ist und ein verwaltetes Netzwerk in der Liste der sichtbaren Netzwerke 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 oder 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 oder 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. Kann je nach Wert von Type eine IPv4- oder IPv6-Adresse sein.

  • IncludedRoutes

    string[] optional

    Chrome 76 oder 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 Routingpräfix.

  • SearchDomains

    string[] optional

    Chrome 76 oder höher

    Array von Strings für die Namensauflösung, siehe onc_spec.md für Details.

  • 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

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

  • Ort

    String optional

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

  • Organisation

    String optional

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

  • OrganizationalUnit

    String optional

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

ManagedBoolean

Attribute

  • Aktiv

    Boolesch optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    Boolesch optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    Boolesch optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    Boolesch optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    Boolesch optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedCellularProperties

Attribute

ManagedDOMString

Attribute

  • Aktiv

    String optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    String optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    String optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    String optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    String optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedDOMStringList

Attribute

  • Aktiv

    string[] optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    string[] optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    string[] optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    string[] optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    string[] optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedEthernetProperties

Attribute

ManagedIPConfigProperties

Attribute

ManagedIPConfigType

Attribute

  • Aktiv

    IPConfigType optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    IPConfigType optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    IPConfigType optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    IPConfigType optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    IPConfigType optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedLong

Attribute

  • Aktiv

    number optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    number optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    number optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    number optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    number optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedManualProxySettings

Attribute

ManagedProperties

Attribute

ManagedProxyLocation

Attribute

ManagedProxySettings

Attribute

ManagedProxySettingsType

Attribute

  • Aktiv

    ProxySettingsType optional

    Der aktive Wert, der derzeit vom Netzwerk-Konfigurationsmanager (z.B. Shill) verwendet wird.

  • DeviceEditable

    Boolesch optional

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

  • DevicePolicy

    ProxySettingsType optional

    Der von der Geräterichtlinie bereitgestellte Attributwert.

  • Effektiv

    String optional

    Die Quelle, aus der der effektive Attributwert ermittelt wurde.

  • SharedSetting

    ProxySettingsType optional

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

  • UserEditable

    Boolesch optional

    Gibt an, ob eine UserPolicy für die Property vorhanden ist und die Bearbeitung der Property zulässt (d.h. die Richtlinie hat den empfohlenen Property-Wert festgelegt). Die Standardeinstellung ist false.

  • UserPolicy

    ProxySettingsType optional

    Der von der Nutzerrichtlinie bereitgestellte Attributwert.

  • UserSetting

    ProxySettingsType optional

    Der vom angemeldeten Nutzer festgelegte Attributwert. Wird nur angegeben, wenn UserEditable den Wert true hat.

ManagedThirdPartyVPNProperties

Attribute

ManagedVPNProperties

Attribute

ManagedWiFiProperties

Attribute

ManualProxySettings

Attribute

  • FTPProxy

    ProxyLocation optional

    Einstellungen für FTP-Proxy.

  • HTTPProxy

    ProxyLocation optional

    Einstellungen für HTTP-Proxy.

  • SOCKS

    ProxyLocation optional

    Einstellungen für SOCKS-Proxy.

  • SecureHTTPProxy

    ProxyLocation optional

    Einstellungen für sicheren HTTP-Proxy.

NetworkConfigProperties

Attribute

NetworkFilter

Attribute

  • konfiguriert

    Boolesch optional

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

  • Limit

    number optional

    Maximale Anzahl der zurückzugebenden Netzwerke. Wenn nichts anderes angegeben wird, wird der Wert standardmäßig auf 1.000 gesetzt. Geben Sie „0“ ein, wenn Sie kein Limit festlegen möchten.

  • networkType

    NetworkType

    Der Typ der Netzwerke, die zurückgegeben werden sollen.

  • sichtbar

    Boolesch 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: Mobilfunknetz-Eigenschaften.

  • Verbindbar

    Boolesch 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 Typ der IP-Adresskonfiguration des Netzwerks.

  • IPConfigs

    IPConfigProperties[] optional

    Die IP-Konfiguration des Netzwerks.

  • MacAddress

    String optional

    Die MAC-Adresse des Netzwerks.

  • Kostenpflichtig

    Boolesch optional

    Chrome 85 oder höher

    Gibt an, ob es sich um ein kostenpflichtiges Netzwerk handelt.

  • 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 Proxy-Einstellungen des Netzwerks.

  • RestrictedConnectivity

    Boolesch optional

    Gibt für ein verbundenes Netzwerk an, 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 oder höher

    Wann die Trafficzähler zuletzt zurückgesetzt wurden.

  • Der Netzwerktyp.

  • VPN

    VPNProperties optional

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

  • WLAN

    WiFiProperties optional

    Bei WLANs die WLAN-Eigenschaften des Netzwerks.

NetworkStateProperties

Attribute

NetworkType

Enum

Alle

Mobilfunk

Ethernet

Tether

VPN

„Kabellos“

"WiFi"

PaymentPortal

Attribute

  • Methode

    String

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

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

  • PAC (Political Action Committee)

    String optional

    URL für die PAC-Datei.

  • Der Typ der Proxy-Einstellungen.

ProxySettingsType

Enum

„Direkte“

Manuell

„PAC“

"WPAD"

SIMLockStatus

Attribute

  • LockEnabled

    boolean

    Gibt an, ob der SIM-Lock aktiviert ist.

  • LockType

    String

    Der Status des SIM-Locks – mögliche Werte sind 'sim-pin', 'sim-puk' und ''.

  • RetriesLeft

    number optional

    Anzahl der zulässigen PIN-Sperrversuche, bevor der PUK zum Entsperren der SIM-Karte erforderlich ist.

ThirdPartyVPNProperties

Attribute

  • ExtensionID

    String

    ID der VPN-Anbietererweiterung des Drittanbieters.

  • ProviderName

    String optional

    Der Name des VPN-Anbieters.

VPNProperties

Attribute

  • AutoConnect

    Boolesch optional

    Gibt an, ob die Verbindung zum VPN-Netzwerk automatisch 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, um nur bestimmte Properties festzulegen.

VPNStateProperties

Attribute

WiFiProperties

Attribute

  • AllowGatewayARPPolling

    Boolesch optional

    Eingestellt seit Chrome 131

    In M131 entfernt. Derzeit ist keine aktive ARP-Abfrage vorhanden.

  • AutoConnect

    Boolesch optional

    Gibt an, ob das WLAN automatisch verbunden werden soll, wenn es in Reichweite ist.

  • 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, auf der das Netzwerk verbunden ist. Andernfalls die Frequenz des besten verfügbaren BSS.

  • FrequencyList

    number[] optional

    Enthält alle Betriebsfrequenzen, die vor Kurzem für das WLAN-Netzwerk erkannt wurden.

  • HexSSID

    String optional

    HEX-codierte Kopie der Netzwerk-SSID.

  • HiddenSSID

    Boolesch optional

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

  • Passphrase

    String optional

    Chrome 66 oder höher

    Die Passphrase für WEP-/WPA-/WPA2-Verbindungen. Diese Property kann nur festgelegt werden. Von getProperties zurückgegebene Properties 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

    Boolesch optional

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

  • EAP

    EAPProperties optional

    Die EAP-Eigenschaften des Netzwerks.

Methoden

createNetwork()

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

Erstellt eine neue Netzwerkkonfiguration aus Attributen. 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, wird diese Netzwerkkonfiguration für andere Nutzer freigegeben.

    Diese Option ist nur in der Web-UI von Chrome verfügbar.* Beim Aufruf durch Apps ist false der einzige zulässige Wert.

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: string) => void

    • Ergebnis

      String

Ausgabe

  • Promise<string>

    Chrome 125 oder 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 Netzwerks, das deaktiviert werden soll.

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. „WLAN“).

Parameter

  • networkType

    NetworkType

    Der Typ des zu aktivierenden Netzwerks.

forgetNetwork()

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

Entfernt eine Netzwerkkonfiguration, indem alle konfigurierten Attribute für das Netzwerk mit der GUID networkGuid gelöscht werden. Dies kann auch andere Netzwerke mit übereinstimmenden Kennungen (z.B. WLAN-SSID und Sicherheit) umfassen. Wenn keine solche Konfiguration vorhanden ist, wird ein Fehler ausgegeben und der Vorgang schlägt fehl.

In Kiosksitzungen können mit dieser Methode keine freigegebenen Netzwerkkonfigurationen gelöscht werden.

Parameter

  • networkGuid

    String

    Die GUID des Netzwerks, das entfernt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 oder 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

    function optional

    Der Parameter callback sieht so aus: 

    (result: CaptivePortalStatus) => void

Ausgabe

  • Chrome 125 oder 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 oder 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 Eigenschaften der globalen Richtlinie ab. Diese Attribute ändern sich während einer Sitzung voraussichtlich nicht.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: GlobalPolicy) => void

Ausgabe

  • Promise<GlobalPolicy>

    Chrome 125 oder 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, Freigabeeinstellungen, Nutzerrichtlinie, Geräterichtlinie und die derzeit aktiven Einstellungen.

Parameter

  • networkGuid

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: ManagedProperties) => void

Ausgabe

  • Chrome 125 oder 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 Attributen zurück, die von getState bereitgestellt werden. Es wird ein Filter bereitgestellt, mit dem Sie den Typ der zurückgegebenen Netzwerke angeben und die Anzahl der Netzwerke begrenzen können. Die Netzwerke werden vom System nach ihrer Priorität sortiert, wobei verbundene oder sich verbindende Netzwerke zuerst aufgeführt werden.

Parameter

Ausgabe

  • Chrome 125 oder 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 Attribute 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

    function optional

    Der Parameter callback sieht so aus: 

    (result: NetworkProperties) => void

Ausgabe

  • Chrome 125 oder 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 Eigenschaften mit Lesezugriff des Netzwerks mit der ID „networkGuid“ ab. Diese Funktion soll eine höhere Leistung als getProperties bieten, da für Letztere eine Anfrage an das Netzwerksubsystem erforderlich ist. Die folgenden Attribute werden für alle Netzwerke zurückgegeben: GUID, Type, Name, WiFi.Security. Für sichtbare Netzwerke werden zusätzliche Attribute 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

    function optional

    Der Parameter callback sieht so aus: 

    (result: NetworkStateProperties) => void

Ausgabe

  • Chrome 125 oder 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

Fordert das Netzwerksubsystem auf, nach neuen Netzwerken zu suchen und die von getVisibleNetworks zurückgegebene Liste zu aktualisieren. Dies ist nur eine Anfrage. Das Netzwerksubsystem kann sie ignorieren. Wenn die Liste aktualisiert wird, wird das Ereignis onNetworkListChanged ausgelöst.

Parameter

  • networkType

    NetworkType optional

    Chrome 63 oder höher

    Wenn angegeben, wird ein Scan speziell für den Typ angefordert. Bei Mobilfunk wird ein Mobilfunknetz-Scan angefordert, sofern unterstützt.

setProperties()

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

Legt die Attribute des Netzwerks mit der ID networkGuid fest. Dies gilt nur für konfigurierte Netzwerke (Quelle != Keine). 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 Attribute festgelegt werden sollen.

  • Die festzulegenden Attribute.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 125 oder 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 der 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

Ausgabe

  • Promise<void>

    Chrome 125 oder 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>

Startet die Trennung vom 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

Ausgabe

  • Promise<void>

    Chrome 125 oder 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 Statuseigenschaften eines Geräts 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 Attribute in einem der Netzwerke ändern. Sendet eine Liste mit GUIDs für Netzwerke, deren Properties 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 Portalerkenung für ein Netzwerk abgeschlossen ist. Sendet die GUID des Netzwerks und den entsprechenden Captive Portal-Status.

Parameter