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 ONC-Spezifikation (Open Network Configuration) angegeben.

HINWEIS: Bei den meisten Wörterbucheigenschaften und enum-Werten wird Großbuchstaben in CamelCase-Schreibweise verwendet, um der ONC-Spezifikation und nicht der JavaScript-CamelCase-Konvention für Kleinbuchstaben zu entsprechen.

Berechtigungen

networking.onc

Verfügbarkeit

Chrome 59 und höher Nur ChromeOS

Typen

ActivationStateType

Enum

CaptivePortalStatus

Enum

CellularProperties

Attribute

  • ActivationState

    ActivationStateType optional

    Aktivierungsstatus des Mobilfunkanbieters.

  • ActivationType

    String optional

    Der Aktivierungstyp des Mobilfunknetzes.

  • AllowRoaming

    Boolescher Wert optional

    Gibt an, ob Roaming für das Netzwerk erlaubt ist.

  • AutoConnect

    Boolescher Wert optional

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

  • Familie

    String optional

    Technologiefamilie für Mobilgeräte: CDMA oder GSM.

  • FirmwareRevision

    String optional

    Die auf dem Mobilfunkmodem geladene Firmwareversion.

  • FoundNetworks

    FoundNetworkProperties[] optional

    Die Liste der Netzwerke, die bei der letzten Netzwerksuche gefunden wurden.

  • HardwareRevision

    String optional

    Hardwareversion des Mobilfunkmodems.

  • HomeProvider

    CellularProviderProperties optional

    Informationen zum Anbieter, der die derzeit im Modem eingelegte SIM-Karte ausgestellt hat.

  • Hersteller

    String optional

    Der Hersteller des Mobilfunkmodems.

  • ModelID

    String optional

    Modell-ID des Mobilfunkmodems

  • NetworkTechnology

    String optional

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

  • PaymentPortal

    PaymentPortal optional

    Online-Zahlungsportal, über das sich ein Nutzer für einen Tarif für mobile Daten anmelden oder einen Tarif ä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

    Boolescher Wert optional

    Gibt an, ob eine SIM-Karte vorhanden ist.

  • Wird gescannt

    Boolescher Wert optional

    Chrome 63 und höher

    „True“, wenn eine Suche nach Mobilfunknetzen durchgeführt wird.

  • ServingOperator

    CellularProviderProperties optional

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

  • SignalStrength

    Nummer optional

    Die aktuelle Signalstärke des Netzwerks.

  • SupportNetworkScan

    Boolescher Wert optional

    Gibt an, ob das Mobilfunknetz Suchlauf unterstützt.

CellularProviderProperties

Attribute

  • Code

    String

    ID des Mobilfunknetzes als einfache Verkettung von Kundencentercode (Mobile Country Code) und MNC (Mobile Network Code)

  • Land

    String optional

    Der aus zwei Buchstaben bestehende Ländercode.

  • Name

    String

    Der Name des Operators.

CellularStateProperties

Attribute

CertificatePattern

Attribute

  • EnrollmentURI

    string[] optional

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

  • Aussteller

    IssuerSubjectPattern optional

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

  • IssuerCARef

    string[] optional

    Liste der CA-Zertifikate des Zertifikatausstellers. Ein Zertifikat muss von einem von ihnen signiert sein, damit dieses Muster übereinstimmt.

  • Betreff

    IssuerSubjectPattern optional

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

ClientCertificateType

Enum

ConnectionStateType

Enum

DeviceStateProperties

Attribute

  • SIMLockStatus

    SIMLockStatus optional

    Chrome 62 und höher

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

  • SIMPresent

    Boolescher Wert optional

    Chrome 62 und höher

    Wenn der Gerätetyp „Mobilfunk“ ist, wird der Status auf den aktuellen SIM-Status festgelegt.

  • Wird gescannt

    Boolescher Wert optional

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

  • Der aktuelle Status des Geräts.

  • Der Netzwerktyp, der dem Gerät zugeordnet ist (Mobilfunknetz, Ethernet oder WLAN).

DeviceStateType

Enum

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

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

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

„Aktiviert“
Das Gerät ist aktiviert.

„Verboten“
Das Gerät ist nicht zulässig.

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 Join

    String optional

  • Außen

    String optional

    Der äußere EAP-Typ. Von ONC gefordert, jedoch möglicherweise nicht bei Übersetzungen aus Shill.

  • Passwort

    String optional

  • SaveCredentials

    Boolescher Wert optional

  • ServerCAPEMs

    string[] optional

  • ServerCARefs

    string[] optional

  • SubjectMatch

    ManagedDOMString optional

    Chrome 60 oder 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. Erforderlich für 8021X-Authentifizierung.

EthernetStateProperties

Attribute

FoundNetworkProperties

Attribute

  • LongName

    String optional

    Der lange Name des Netzbetreibers.

  • NetworkId

    String

    Netzwerk-ID.

  • ShortName

    String optional

    Der Kurzformatname des Netzbetreibers.

  • Status

    String

    Netzwerkverfügbarkeit.

  • Technologie

    String

    Auf die vom Netzwerk verwendete Technologie zugreifen

GlobalPolicy

Attribute

  • AllowOnlyPolicyNetworksToAutoconnect

    Boolescher Wert optional

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

  • AllowOnlyPolicyNetworksToConnect

    Boolescher Wert optional

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    Boolescher Wert optional

    Chrome 70 oder höher

    Wenn „true“ festgelegt ist und ein verwaltetes Netzwerk in der Liste der sichtbaren Netzwerke verfügbar ist, können nur Richtliniennetzwerke verbunden werden und 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 unzulässig. Die Blockierung von Netzwerken kann wieder aufgehoben 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

    Gatewayadresse, die für die IP-Konfiguration verwendet wird.

  • IPAddress

    String optional

    Die IP-Adresse für eine Verbindung. Kann eine IPv4- oder IPv6-Adresse sein, abhängig vom 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

    Nummer optional

    Das Routingpräfix.

  • SearchDomains

    string[] optional

    Chrome 76 und höher

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

  • Typ

    String optional

    Der IP-Konfigurationstyp. Kann IPv4 oder IPv6 sein.

  • WebProxyAutoDiscoveryUrl

    String optional

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

IPConfigType

Enum

IssuerSubjectPattern

Attribute

  • CommonName

    String optional

    Falls dieser Wert festgelegt ist, der mit dem allgemeinen Namen 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

    Falls festgelegt, der Wert, mit dem die Organisationen des Zertifikatsinhabers abgeglichen werden sollen. Es muss mindestens eine Organisation mit dem Wert übereinstimmen.

  • OrganizationalUnit

    String optional

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

ManagedBoolean

Attribute

  • Aktiv

    Boolescher Wert optional

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

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    Boolescher Wert optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    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 den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    Boolescher Wert optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    Boolescher Wert optional

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

ManagedCellularProperties

Attribute

ManagedDOMString

Attribute

  • Aktiv

    String optional

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

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    String optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    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 den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    String optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    String optional

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

ManagedDOMStringList

Attribute

  • Aktiv

    string[] optional

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

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    string[] optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    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 den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    string[] optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    string[] optional

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

ManagedEthernetProperties

Attribute

ManagedIPConfigProperties

Attribute

ManagedIPConfigType

Attribute

  • Aktiv

    IPConfigType optional

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

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    IPConfigType optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    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 den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    IPConfigType optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    IPConfigType optional

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

ManagedLong

Attribute

  • Aktiv

    Nummer optional

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

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    Nummer optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    String optional

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

  • SharedSetting

    Nummer optional

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

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    Nummer optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    Nummer optional

    Der vom angemeldeten Nutzer festgelegte Eigenschaftswert 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 Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).

  • DeviceEditable

    Boolescher Wert optional

    Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • DevicePolicy

    ProxySettingsType optional

    Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.

  • Wirksam

    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 den Wert true hat.

  • UserEditable

    Boolescher Wert optional

    Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist false.

  • UserPolicy

    ProxySettingsType optional

    Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.

  • UserSetting

    ProxySettingsType optional

    Der vom angemeldeten Nutzer festgelegte Eigenschaftswert 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.

  • SOCKEN

    ProxyLocation optional

    Einstellungen für den SOCKS-Proxy.

  • SecureHTTPProxy

    ProxyLocation optional

    Einstellungen für den sicheren HTTP-Proxy.

NetworkConfigProperties

Attribute

NetworkFilter

Attribute

  • konfiguriert

    Boolescher Wert optional

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

  • Limit

    Nummer optional

    Maximale Anzahl von Netzwerken, die zurückgegeben werden sollen. Wenn keine Angabe gemacht wird, ist der Standardwert 1.000. Verwenden Sie 0, wenn Sie keine Begrenzung verwenden möchten.

  • networkType

    NetworkType

    Der Netzwerktyp, der zurückgegeben werden soll.

  • sichtbar

    Boolescher Wert optional

    Wenn dieser Wert „true“ ist, werden nur sichtbare Netzwerke einbezogen, die physisch verbunden oder in Reichweite sind. Die Standardeinstellung ist „false“.

NetworkProperties

Attribute

  • Mobilfunk

    CellularProperties optional

    Bei Mobilfunknetzen: Eigenschaften von Mobilfunknetzen.

  • Verbindung möglich

    Boolescher Wert optional

    Gibt an, ob das Netzwerk verbunden werden kann.

  • ConnectionState

    ConnectionStateType optional

    Der aktuelle Verbindungsstatus des Netzwerks.

  • ErrorState

    String optional

    Der letzte aufgezeichnete Netzwerkfehlerstatus.

  • Ethernet

    EthernetProperties optional

    Bei Ethernet-Netzwerken die Ethernet-Netzwerkeigenschaften.

  • GUID

    String

    Die Netzwerk-GUID.

  • IPAddressConfigType

    IPConfigType optional

    Der Konfigurationstyp der IP-Adresse des Netzwerks.

  • IPConfigs

    IPConfigProperties[] optional

    Die IP-Konfiguration des Netzwerks.

  • MacAddress

    String optional

    Die MAC-Adresse des Netzwerks.

  • Kostenpflichtig

    Boolescher Wert optional

    Chrome 85 und höher

    Gibt an, ob das Netzwerk kostenpflichtig ist.

  • Name

    String optional

    Ein nutzerfreundlicher Netzwerkname.

  • NameServersConfigType

    IPConfigType optional

    Der IP-Konfigurationstyp für die Nameserver, die vom Netzwerk verwendet werden.

  • Priorität

    Nummer optional

    Die Netzwerkpriorität.

  • ProxySettings

    ProxySettings optional

    Die Proxy-Einstellungen des Netzwerks.

  • RestrictedConnectivity

    Boolescher Wert optional

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

  • SavedIPConfig

    IPConfigProperties optional

    IP-Konfiguration, die vor dem Anwenden der statischen IP-Konfiguration vom DHCP-Server empfangen 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 in Konflikt mit der Erweiterungscodegenerierung. Daher müssen wir für „Source“ einen String anstelle einer SourceType-Enum verwenden.

  • StaticIPConfig

    IPConfigProperties optional

    Die statische IP-Konfiguration des Netzwerks.

  • TrafficCounterResetTime

    Nummer optional

    Ausstehend

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

  • Der Netzwerktyp.

  • VPN

    VPNProperties optional

    Bei VPN-Netzwerken die Netzwerk-VPN-Eigenschaften.

  • WiFi

    WiFiProperties optional

    Bei WLAN-Netzwerken die Netzwerk-WLAN-Eigenschaften.

NetworkStateProperties

Attribute

NetworkType

Enum

"Ethernet"

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, außer Method ist POST.

  • URL

    String optional

    Die URL des Zahlungsportals.

ProxyLocation

Attribute

  • Host

    String

    Der Proxy-IP-Adresshost.

  • Port

    Zahl

    Der für den Proxy zu verwendende Port.

ProxySettings

Attribute

  • ExcludeDomains

    string[] optional

    Domains und Hosts, für die manuelle Proxyeinstellungen ausgeschlossen sind.

  • Manuell

    ManualProxySettings optional

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

  • PAC (Political Action Committee)

    String optional

    URL für die Datei zur automatischen Konfiguration des Proxys.

  • Der Typ der Proxy-Einstellungen.

ProxySettingsType

Enum

"PAC"

SIMLockStatus

Attribute

  • LockEnabled

    boolean

    Gibt an, ob die SIM-Sperre aktiviert ist.

  • LockType

    String

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

  • RetriesLeft

    Nummer optional

    Anzahl der erlaubten Versuche, die SIM-Karte zu sperren, bevor der PUK zum Entsperren erforderlich ist.

ThirdPartyVPNProperties

Attribute

  • ExtensionID

    String

    ID der Erweiterung des Drittanbieter-VPN-Anbieters.

  • ProviderName

    String optional

    Der Name des VPN-Anbieters.

VPNProperties

Attribute

  • AutoConnect

    Boolescher Wert optional

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

  • Host

    String optional

    Der VPN-Host.

  • Typ

    String optional

    Der VPN-Typ. Dies kann aufgrund von „L2TP-IPSec“ keine Aufzählung sein. Dies ist optional für „NetworkConfigProperties“, die an „setProperties“ übergeben werden und mit denen nur bestimmte Attribute festgelegt werden können.

VPNStateProperties

Attribute

WiFiProperties

Attribute

  • AllowGatewayARPPolling

    Boolescher Wert optional

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

  • AutoConnect

    Boolescher Wert optional

    Gibt an, ob das WLAN-Netzwerk automatisch verbunden werden soll, wenn es sich 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.

  • Frequenz

    Nummer optional

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

  • FrequencyList

    nummer[] optional

    Enthält die gesamte Betriebsfrequenz, die zuletzt für das WLAN ermittelt wurde.

  • HexSSID

    String optional

    HEX-codierte Kopie der Netzwerk-SSID.

  • HiddenSSID

    Boolescher Wert optional

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

  • Passphrase

    String optional

    Chrome 66 und höher

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

  • RoamThreshold

    Nummer optional

    Eingestellt, ignoriert.

  • SSID

    String optional

    Die Netzwerk-SSID.

  • Sicherheit

    String optional

    Der Netzwerksicherheitstyp.

  • SignalStrength

    Nummer optional

    Die Signalstärke des Netzwerks.

WiFiStateProperties

Attribute

WiMAXProperties

Attribute

  • AutoConnect

    Boolescher Wert optional

    Gibt an, ob das Netzwerk automatisch verbunden werden soll.

  • EAP

    EAPProperties optional

    Die EAP-Eigenschaften des Netzwerks.

Methoden

createNetwork()

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

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

Parameter

  • freigegeben

    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 sie von Apps aufgerufen werden, ist false der einzige zulässige Wert.

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: string)=>void

    • Ergebnis

      String

Returns

  • Versprechen<string>

    Ausstehend

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

disableNetworkType()

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

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

Parameter

  • networkType

    NetworkType

    Der Netzwerktyp, der deaktiviert werden soll.

enableNetworkType()

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

Aktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Hinweis: Der Typ kann für mehrere Netzwerktypen stehen (z.B. „Drahtlos“).

Parameter

  • networkType

    NetworkType

    Der zu aktivierende Netzwerktyp.

forgetNetwork()

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

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

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

Parameter

  • networkGuid

    String

    Die GUID des zu entfernenden Netzwerks.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Returns

  • Promise<void>

    Ausstehend

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

getCaptivePortalStatus()

Versprechen 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

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

Parameter

  • networkGuid

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: CaptivePortalStatus)=>void

Returns

  • Ausstehend

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

getDeviceStates()

Versprechen 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

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

Parameter

Returns

  • Ausstehend

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

getGlobalPolicy()

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

Ruft die globalen Richtlinieneigenschaften ab. Diese Eigenschaften ändern sich im Verlauf einer Sitzung normalerweise nicht.

Parameter

Returns

  • Promise<GlobalPolicy>

    Ausstehend

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

getManagedProperties()

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

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

Parameter

  • networkGuid

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: ManagedProperties)=>void

Returns

  • Ausstehend

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

getNetworks()

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

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

Parameter

Returns

  • Ausstehend

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

getProperties()

Versprechen 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

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

Parameter

  • networkGuid

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: NetworkProperties)=>void

Returns

  • Ausstehend

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

getState()

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

Ruft die im Cache gespeicherten schreibgeschützten Eigenschaften des Netzwerks mit der ID networkGuid ab. Dies soll eine leistungsfähigere Funktion als getProperties sein, die einen Umlauf erfordert, um das Netzwerksubsystem abzufragen. Die folgenden Eigenschaften werden für alle Netzwerke 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 Properties abgerufen werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: NetworkStateProperties)=>void

Returns

  • Ausstehend

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

requestNetworkScan()

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

Fordert das Netzwerksubsystem an, 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 und höher

    Falls angegeben, wird ein spezieller Scan für den Typ angefordert. Bei Mobilfunk wird eine Suche nach einem Mobilfunknetz angefordert, sofern dies unterstützt wird.

setProperties()

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

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

Parameter

  • networkGuid

    String

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

  • Die festzulegenden Eigenschaften.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Returns

  • Promise<void>

    Ausstehend

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

startConnect()

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

Stellt eine Verbindung zum Netzwerk mit networkGuid her.

Parameter

  • networkGuid

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Returns

  • Promise<void>

    Ausstehend

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

startDisconnect()

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

Startet eine Netzwerkverbindung 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

Returns

  • Promise<void>

    Ausstehend

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

Veranstaltungen

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 in einem 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