chrome.networking.onc

Description

L'API chrome.networking.onc permet de configurer les connexions réseau (cellulaire, Ethernet, VPN ou Wi-Fi). Cette API est disponible dans les sessions kiosque Chrome OS lancées automatiquement.

Les configurations de connexion réseau sont spécifiées conformément à la spécification ONC (Open Network Configuration).

REMARQUE: La plupart des propriétés de dictionnaire et des valeurs d'énumération utilisent la casse UpperCamelCase pour correspondre à la spécification ONC au lieu de la convention JavaScript lowerCamelCase.

Autorisations

networking.onc

Garantie de disponibilité

Chrome 59 et versions ultérieures ChromeOS uniquement

Types

ActivationStateType

Enum

"NotActivated"

CaptivePortalStatus

Enum

"Portal"

"ProxyAuthRequired"

CellularProperties

Propriétés

  • ActivationState

    ActivationStateType facultatif

    État d'activation du compte de l'opérateur.

  • ActivationType

    string facultatif

    Type d'activation du réseau mobile.

  • AllowRoaming

    Booléen facultatif

    Indique si l'itinérance est autorisée pour le réseau.

  • AutoConnect

    Booléen facultatif

    Indique si le réseau mobile doit se connecter automatiquement (lorsqu'il est à portée).

  • Familial

    string facultatif

    Famille de technologies des appareils mobiles : CDMA ou GSM.

  • FirmwareRevision

    string facultatif

    Révision du micrologiciel chargée dans le modem mobile.

  • FoundNetworks

    FoundNetworkProperties[] facultatif

    Liste des réseaux trouvés lors de la dernière recherche de réseau.

  • HardwareRevision

    string facultatif

    Révision matérielle du modem cellulaire.

  • HomeProvider

    CellularProviderProperties facultatif

    Informations sur l'opérateur qui a délivré la carte SIM actuellement installée sur le modem.

  • Fabricant

    string facultatif

    Le fabricant du modem cellulaire.

  • ModelID

    string facultatif

    ID du modèle du modem cellulaire.

  • NetworkTechnology

    string facultatif

    Si le modem est enregistré sur un réseau, il s'agit de la technologie réseau actuellement utilisée.

  • PaymentPortal

    PaymentPortal facultatif

    Portail de paiement en ligne permettant à l'utilisateur de souscrire un forfait de données mobiles ou de le modifier.

  • RoamingState

    string facultatif

    État d'itinérance du modem mobile sur le réseau actuel.

  • SIMLockStatus

    SIMLockStatus facultatif

    État du verrouillage de la carte SIM pour les réseaux familiaux GSM.

  • SIMPresent

    Booléen facultatif

    Indique si une carte SIM est présente.

  • analyses

    Booléen facultatif

    Chrome 63 et versions ultérieures

    Vrai lorsqu'une recherche de réseau mobile est en cours.

  • ServingOperator

    CellularProviderProperties facultatif

    Informations sur l'opérateur du réseau dont le modem est actuellement enregistré.

  • SignalStrength

    numéro facultatif

    Intensité actuelle du signal du réseau.

  • SupportNetworkScan

    Booléen facultatif

    Indique si le réseau mobile est compatible avec la recherche.

CellularProviderProperties

Propriétés

  • Code

    chaîne

    ID de réseau mobile sous la forme d'une simple concaténation du code CM (Mobile Country Code) et du MNC (Mobile Network Code) du réseau.

  • Pays

    string facultatif

    Code pays à deux lettres.

  • Nom

    chaîne

    Nom de l'opérateur.

CellularStateProperties

Propriétés

CertificatePattern

Propriétés

  • EnrollmentURI

    string[] facultatif

    Liste des URI vers lesquels l'utilisateur peut être redirigé si aucun certificat correspondant à ce format n'est trouvé.

  • Émetteur

    IssuerSubjectPattern facultatif

    S'il est défini, format avec lequel les paramètres de l'émetteur X.509 doivent être mis en correspondance.

  • IssuerCARef

    string[] facultatif

    Liste des certificats CA de l'émetteur des certificats. Un certificat doit être signé par l'un d'entre eux pour correspondre à ce format.

  • Objet

    IssuerSubjectPattern facultatif

    S'il est défini, format avec lequel les paramètres d'objet X.509 doivent être mis en correspondance.

ClientCertificateType

Enum

ConnectionStateType

Enum

DeviceStateProperties

Propriétés

  • SIMLockStatus

    SIMLockStatus facultatif

    Chrome 62 ou version ultérieure

    État de verrouillage de la carte SIM si Type = Mobile et SIMPresent = True.

  • SIMPresent

    Booléen facultatif

    Chrome 62 ou version ultérieure

    Définissez l'état de la carte SIM actuelle si l'appareil est de type mobile.

  • analyses

    Booléen facultatif

    Indiquez si l'appareil est activé. "True" si l'appareil est en cours de recherche.

  • État actuel de l'appareil.

  • Type de réseau associé à l'appareil (réseau mobile, Ethernet ou Wi-Fi).

DeviceStateType

Enum

"Non initialisé"
L'appareil est disponible, mais n'a pas été initialisé.

"Désactivé"
L'appareil est initialisé, mais pas activé.

"Activation"
L'état d'activation a été demandé, mais n'est pas terminé.

"Activé"
L'appareil est activé.

"Interdit"
L'appareil est interdit.

EAPProperties

Propriétés

  • AnonymousIdentity

    string facultatif

  • ClientCertPKCS11Id

    string facultatif

    Chrome 60 ou version ultérieure
  • ClientCertPattern

    CertificatePattern facultatif

  • ClientCertProvisioningProfileId

    string facultatif

    Chrome 93 et versions ultérieures
  • ClientCertRef

    string facultatif

  • ClientCertType

    ClientCertificateType

  • Identité

    string facultatif

  • Interne

    string facultatif

  • Extérieur

    string facultatif

    Type de PAA externe. Requis par l'ONC, mais il est possible qu'ils ne soient pas fournis lors de la traduction depuis Shill.

  • Mot de passe

    string facultatif

  • SaveCredentials

    Booléen facultatif

  • ServerCAPEMs

    string[] facultatif

  • ServerCARefs

    string[] facultatif

  • SubjectMatch

    ManagedDOMString facultatif

    Chrome 60 ou version ultérieure
  • UseProactiveKeyCaching

    Booléen facultatif

  • UseSystemCAs

    Booléen facultatif

EthernetProperties

Propriétés

  • Ratio d'économie d'énergie (EER)

    string facultatif

    Authentification utilisée par le réseau Ethernet. Les valeurs possibles sont None et 8021X.

  • AutoConnect

    Booléen facultatif

    Indique si le réseau Ethernet doit se connecter automatiquement.

  • EAP

    EAPProperties facultatif

    les paramètres EAP du réseau. Requis pour l'authentification 8021X.

EthernetStateProperties

Propriétés

FoundNetworkProperties

Propriétés

  • LongName

    string facultatif

    Nom du format long de l'opérateur réseau.

  • NetworkId

    chaîne

    ID de réseau.

  • ShortName

    string facultatif

    Nom du format court de l'opérateur réseau.

  • État

    chaîne

    Disponibilité du réseau

  • Technologie

    chaîne

    Technologie d'accès utilisée par le réseau.

GlobalPolicy

Propriétés

  • AllowOnlyPolicyNetworksToAutoconnect

    Booléen facultatif

    Si la valeur est "true", seuls les réseaux Policy peuvent se connecter automatiquement. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnect

    Booléen facultatif

    Si la valeur est "true", seuls les réseaux de la règle peuvent être connectés et aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    Booléen facultatif

    Chrome 70 et versions ultérieures

    Si la valeur est "true" et qu'un réseau géré figure dans la liste des réseaux visibles, seuls les réseaux de règles peuvent être connectés, et aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • BlockedHexSSIDs

    string[] facultatif

    Chrome 86 et versions ultérieures

    Liste des réseaux bloqués. Les connexions à des réseaux bloqués sont interdites. Pour débloquer des réseaux à nouveau, spécifiez une configuration réseau explicite. La liste est vide par défaut.

IPConfigProperties

Propriétés

  • ExcludedRoutes

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de blocs d'adresses IP au format CIDR. Pour en savoir plus, consultez le fichier onc_spec.md.

  • Passerelle

    string facultatif

    Adresse de la passerelle utilisée pour la configuration IP.

  • IPAddress

    string facultatif

    Adresse IP d'une connexion. Il peut s'agir d'une adresse IPv4 ou IPv6, selon la valeur de Type.

  • IncludedRoutes

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de blocs d'adresses IP au format CIDR. Pour en savoir plus, consultez le fichier onc_spec.md.

  • NameServers

    string[] facultatif

    Tableau d'adresses utilisées pour les serveurs de noms.

  • RoutingPrefix

    numéro facultatif

    Préfixe de routage.

  • SearchDomains

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de chaînes pour la résolution de noms, voir onc_spec.md pour plus de détails.

  • Type

    string facultatif

    Type de configuration IP. Il peut s'agir de IPv4 ou IPv6.

  • WebProxyAutoDiscoveryUrl

    string facultatif

    URL d'auto-découverte du proxy WEb, telle qu'indiquée sur DHCP.

IPConfigType

Enum

"DHCP"

"Static"

IssuerSubjectPattern

Propriétés

  • CommonName

    string facultatif

    Si ce champ est défini, il s'agit de la valeur à laquelle appliquer le nom commun du sujet du certificat.

  • Localité

    string facultatif

    Si ce champ est défini, il s'agit de la valeur par rapport à laquelle faire correspondre l'emplacement commun du sujet du certificat.

  • Organisation

    string facultatif

    Si ce champ est défini, il s'agit de la valeur à comparer aux organisations du sujet du certificat. Au moins une organisation doit correspondre à cette valeur.

  • OrganizationalUnit

    string facultatif

    Si ce champ est défini, il s'agit de la valeur à appliquer aux unités organisationnelles du sujet du certificat. Au moins une unité organisationnelle doit correspondre à la valeur.

ManagedBoolean

Propriétés

  • Actif

    Booléen facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    Booléen facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    Booléen facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    Booléen facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    Booléen facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedCellularProperties

Propriétés

ManagedDOMString

Propriétés

  • Actif

    string facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    string facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    string facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    string facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    string facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedDOMStringList

Propriétés

  • Actif

    string[] facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    string[] facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    string[] facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    string[] facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    string[] facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedEthernetProperties

Propriétés

ManagedIPConfigProperties

Propriétés

ManagedIPConfigType

Propriétés

  • Actif

    IPConfigType facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    IPConfigType facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    IPConfigType facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    IPConfigType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedLong

Propriétés

  • Actif

    numéro facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    numéro facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    numéro facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    numéro facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    numéro facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedManualProxySettings

Propriétés

ManagedProperties

Propriétés

ManagedProxyLocation

Propriétés

ManagedProxySettings

Propriétés

ManagedProxySettingsType

Propriétés

  • Actif

    ProxySettingsType facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration du réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et autorise sa modification (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    ProxySettingsType facultatif

    Valeur de propriété fournie par les règles relatives aux appareils.

  • En vigueur

    string facultatif

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    ProxySettingsType facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    Booléen facultatif

    Indique si un élément UserPolicy existe pour la propriété et autorise sa modification (c'est-à-dire que la règle définit la valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    ProxySettingsType facultatif

    Valeur de la propriété fournie par les règles relatives aux utilisateurs.

  • UserSetting

    ProxySettingsType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedThirdPartyVPNProperties

Propriétés

ManagedVPNProperties

Propriétés

ManagedWiFiProperties

Propriétés

ManualProxySettings

Propriétés

  • FTPProxy

    ProxyLocation facultatif

    Paramètres du proxy FTP.

  • HTTPProxy

    ProxyLocation facultatif

    Paramètres du proxy HTTP.

  • CHAÎNES

    ProxyLocation facultatif

    Paramètres du proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facultatif

    Paramètres de proxy HTTP sécurisé.

NetworkConfigProperties

Propriétés

NetworkFilter

Propriétés

  • configurée

    Booléen facultatif

    Si la valeur est "true", n'incluez que les réseaux configurés (enregistrés). La valeur par défaut est "false".

  • limite

    numéro facultatif

    Nombre maximal de réseaux à afficher. Si aucune valeur n'est spécifiée, la valeur par défaut est 1 000. Indiquez 0 pour indiquer qu'il n'y a aucune limite.

  • networkType

    NetworkType

    Type de réseaux à afficher.

  • visible

    Booléen facultatif

    Si la valeur est "true", n'incluez que les réseaux visibles (physiquement connectés ou à portée). La valeur par défaut est "false".

NetworkProperties

Propriétés

  • Connexion cellulaire

    CellularProperties facultatif

    Pour les réseaux mobiles, propriétés des réseaux mobiles.

  • Connectables

    Booléen facultatif

    Indique si le réseau peut se connecter.

  • ConnectionState

    ConnectionStateType facultatif

    État de connexion actuel du réseau.

  • ErrorState

    string facultatif

    Dernier état d'erreur réseau enregistré.

  • Ethernet

    EthernetProperties facultatif

    Pour les réseaux Ethernet, les propriétés du réseau Ethernet.

  • GUID

    chaîne

    GUID du réseau.

  • IPAddressConfigType

    IPConfigType facultatif

    Type de configuration de l'adresse IP du réseau.

  • IPConfigs

    IPConfigProperties[] facultatif

    Configuration IP du réseau.

  • MacAddress

    string facultatif

    Adresse MAC du réseau.

  • Facturé à l'usage

    Booléen facultatif

    Chrome 85 et versions ultérieures

    Indique si le réseau est facturé à l'usage.

  • Nom

    string facultatif

    Nom de réseau convivial.

  • NameServersConfigType

    IPConfigType facultatif

    Type de configuration IP des serveurs de noms utilisés par le réseau.

  • Priorité

    numéro facultatif

    Priorité du réseau

  • ProxySettings

    ProxySettings facultatif

    Paramètres de proxy du réseau.

  • RestrictedConnectivity

    Booléen facultatif

    Pour un réseau connecté, si la connectivité réseau à Internet est limitée (par exemple, si le réseau se trouve derrière un portail ou si un réseau mobile n'est pas activé).

  • SavedIPConfig

    IPConfigProperties facultatif

    Configuration IP reçue du serveur DHCP avant l'application de la configuration IP statique.

  • Source

    string facultatif

    Indique si le réseau est configuré, et comment. Les valeurs possibles sont :

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" est en conflit avec la génération de code d'extension. Nous devons donc utiliser une chaîne pour "Source" au lieu d'une énumération SourceType.

  • StaticIPConfig

    IPConfigProperties facultatif

    Configuration de l'adresse IP statique du réseau.

  • TrafficCounterResetTime

    numéro facultatif

    En attente

    Date de la dernière réinitialisation des compteurs de trafic

  • Type de réseau.

  • VPN

    VPNProperties facultatif

    Pour les réseaux VPN, il s'agit des propriétés du VPN réseau.

  • WiFi

    WiFiProperties facultatif

    Pour les réseaux Wi-Fi, il s'agit des propriétés du Wi-Fi du réseau.

NetworkStateProperties

Propriétés

NetworkType

Enum

"Ethernet"

"VPN"

PaymentPortal

Propriétés

  • Méthode

    chaîne

    Méthode HTTP à utiliser pour le portail de paiement.

  • PostData

    string facultatif

    Données des posts à envoyer au portail de paiement. Ignoré, sauf si Method est POST.

  • URL

    string facultatif

    URL du portail de paiement.

ProxyLocation

Propriétés

  • Hôte

    chaîne

    Hôte de l'adresse IP du proxy.

  • Port

    Nombre

    Port à utiliser pour le proxy.

ProxySettings

Propriétés

  • ExcludeDomains

    string[] facultatif

    Domaines et hôtes pour lesquels les paramètres de proxy manuels sont exclus.

  • Manuel

    ManualProxySettings facultatif

    Paramètres de proxy manuels : utilisés uniquement pour les paramètres de proxy de Manual.

  • PAC

    string facultatif

    URL du fichier de configuration automatique du proxy.

  • Type de paramètres de proxy.

ProxySettingsType

Enum

"Direct"

"PAC"

"WPAD"

SIMLockStatus

Propriétés

  • LockEnabled

    boolean

    Indique si le verrouillage de la carte SIM est activé.

  • LockType

    chaîne

    État du blocage de la carte SIM. Les valeurs possibles sont 'sim-pin', 'sim-puk' et ''.

  • RetriesLeft

    numéro facultatif

    Nombre de tentatives autorisées pour déverrouiller la carte SIM avant que la clé PUK soit requise.

ThirdPartyVPNProperties

Propriétés

  • ExtensionID

    chaîne

    ID de l'extension du fournisseur VPN tiers.

  • ProviderName

    string facultatif

    Nom du fournisseur du VPN.

VPNProperties

Propriétés

  • AutoConnect

    Booléen facultatif

    Indique si le réseau VPN doit être connecté automatiquement.

  • Hôte

    string facultatif

    Hôte VPN.

  • Type

    string facultatif

    Type de VPN. Il ne peut pas s'agir d'une énumération à cause de "L2TP-IPSec". Ceci est facultatif pour NetworkConfigProperties, qui est transmis à setProperties, qui ne peut être utilisé que pour définir des propriétés spécifiques.

VPNStateProperties

Propriétés

WiFiProperties

Propriétés

  • AllowGatewayARPPolling

    Booléen facultatif

    Indique si l'interrogation ARP de la passerelle par défaut est autorisée. La valeur par défaut est "true".

  • AutoConnect

    Booléen facultatif

    Indique si le réseau Wi-Fi doit se connecter automatiquement lorsqu'il est à portée.

  • BSSID

    string facultatif

    BSSID du point d'accès associé.

  • EAP

    EAPProperties facultatif

    Propriétés du réseau EAP. Obligatoire pour les réseaux WEP-8021X et WPA-EAP.

  • Fréquence

    numéro facultatif

    Fréquence de fonctionnement du service Wi-Fi, en MHz. Pour les réseaux connectés, il s'agit de la fréquence actuelle à laquelle le réseau est connecté. Sinon, il s'agit de la fréquence du meilleur BSS disponible.

  • FrequencyList

    number[] facultatif

    Contient toutes les fréquences de fonctionnement récemment détectées pour le réseau Wi-Fi.

  • HexSSID

    string facultatif

    Copie hexadécimale du SSID du réseau, encodée en hexadécimal.

  • HiddenSSID

    Booléen facultatif

    Indique si le SSID du réseau sera diffusé.

  • Phrase secrète

    string facultatif

    Chrome 66 et versions ultérieures

    Phrase secrète pour les connexions WEP/WPA/WPA2. Cette propriété ne peut être définie que. Les propriétés renvoyées par getProperties ne contiendront pas cette valeur.

  • RoamThreshold

    numéro facultatif

    Obsolète et ignoré.

  • SSID

    string facultatif

    SSID du réseau.

  • Sécurité

    string facultatif

    Type de sécurité du réseau.

  • SignalStrength

    numéro facultatif

    Intensité du signal du réseau.

WiFiStateProperties

Propriétés

WiMAXProperties

Propriétés

  • AutoConnect

    Booléen facultatif

    Indique si le réseau doit se connecter automatiquement.

  • EAP

    EAPProperties facultatif

    Propriétés du réseau EAP.

Méthodes

createNetwork()

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

Crée une configuration réseau à partir des propriétés. Si un réseau configuré correspondant existe déjà, cette opération échoue. Sinon, affiche le GUID du nouveau réseau.

Paramètres

  • partagés

    boolean

    Si la valeur est true, partagez cette configuration réseau avec d'autres utilisateurs.

    Cette option n'est exposée qu'à l'interface utilisateur Web de Chrome*. Lorsqu'elle est appelée par des applications, false est la seule valeur autorisée.

  • Propriétés avec lesquelles configurer le nouveau réseau.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: string)=>void

    • résultat

      chaîne

Renvoie

  • Promesse<chaîne>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

disableNetworkType()

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

Désactive tous les appareils correspondant au type de réseau spécifié. Voir la remarque pour enableNetworkType.

Paramètres

  • networkType

    NetworkType

    Type de réseau à désactiver.

enableNetworkType()

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

Active tous les appareils correspondant au type de réseau spécifié. Notez que le type peut représenter plusieurs types de réseaux (par exemple, "Sans fil").

Paramètres

forgetNetwork()

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

Supprime une configuration réseau en effaçant toutes les propriétés configurées pour le réseau avec le GUID networkGuid. Cela peut également inclure d'autres réseaux associés à des identifiants identiques (par exemple, SSID Wi-Fi et sécurité). Si aucune configuration de ce type n'existe, une erreur est générée et l'opération échoue.

Dans les sessions kiosque, cette méthode ne permet pas de supprimer les configurations réseau partagées.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à supprimer.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    ()=>void

Renvoie

  • Promise<void>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getCaptivePortalStatus()

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

Renvoie l'état du portail captif pour le réseau correspondant à "networkGuid".

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel vous souhaitez obtenir l'état du portail captif.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: CaptivePortalStatus)=>void

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDeviceStates()

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

Renvoie les états des appareils réseau disponibles.

Paramètres

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getGlobalPolicy()

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

Récupère les propriétés de la stratégie globale. Ces propriétés ne sont pas censées changer au cours d'une session.

Paramètres

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: GlobalPolicy)=>void

Renvoie

  • Promise<GlobalPolicy>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getManagedProperties()

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

Récupère les propriétés fusionnées du réseau avec l'ID networkGuid à partir des sources: paramètres utilisateur, paramètres partagés, règles relatives aux utilisateurs, règles relatives aux appareils et paramètres actuellement actifs.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau dont vous souhaitez obtenir les propriétés.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: ManagedProperties)=>void

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getNetworks()

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

Renvoie une liste d'objets réseau ayant les mêmes propriétés fournies par getState. Un filtre est fourni pour spécifier le type de réseaux renvoyé et pour limiter le nombre de réseaux. Les réseaux sont classés par le système en fonction de leur priorité, les réseaux connectés ou connectés en premier.

Paramètres

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getProperties()

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

Récupère toutes les propriétés du réseau avec l'ID networkGuid. Inclut toutes les propriétés du réseau (valeurs en lecture seule et en lecture/écriture).

Paramètres

  • networkGuid

    chaîne

    GUID du réseau dont vous souhaitez obtenir les propriétés.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: NetworkProperties)=>void

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getState()

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

Récupère les propriétés en lecture seule mises en cache du réseau avec l'ID networkGuid. Il s'agit d'une fonction offrant des performances supérieures à getProperties, qui nécessite un aller-retour pour interroger le sous-système de mise en réseau. Les propriétés suivantes sont renvoyées pour tous les réseaux: GUID, Type, Name, WiFi.Security. Des propriétés supplémentaires sont disponibles pour les réseaux visibles: ConnectionState, ErrorState, WiFi.SignalForce, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau dont vous souhaitez obtenir les propriétés.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    (result: NetworkStateProperties)=>void

Renvoie

  • En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

requestNetworkScan()

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

Demande au sous-système réseau de rechercher les nouveaux réseaux et de mettre à jour la liste renvoyée par getVisibleNetworks. Il ne s'agit que d'une requête: le sous-système de réseau peut choisir de l'ignorer. Si la liste est mise à jour, l'événement onNetworkListChanged est déclenché.

Paramètres

  • networkType

    NetworkType facultatif

    Chrome 63 et versions ultérieures

    Si fourni, demande une analyse spécifique au type. Pour le réseau mobile, une recherche de réseau mobile sera demandée si elle est compatible.

setProperties()

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

Définit les propriétés du réseau associé à l'ID networkGuid. Ceci n'est valide que pour les réseaux configurés (Source != Aucune). Les réseaux visibles non configurés doivent utiliser createNetwork à la place. Dans les sessions kiosque, l'appel de cette méthode sur un réseau partagé échouera.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel définir des propriétés.

  • Propriétés à définir.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    ()=>void

Renvoie

  • Promise<void>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startConnect()

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

Démarre une connexion au réseau avec networkGuid.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau auquel se connecter.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    ()=>void

Renvoie

  • Promise<void>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startDisconnect()

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

Démarre une déconnexion du réseau avec networkGuid.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau dont vous souhaitez vous déconnecter.

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    ()=>void

Renvoie

  • Promise<void>

    En attente

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onDeviceStateListChanged

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

Déclenché lorsque la liste des appareils a changé ou que les propriétés de l'état d'un appareil ont changé

Paramètres

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    ()=>void

onNetworkListChanged

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

Déclenché lorsque la liste des réseaux a changé Envoie la liste complète des GUID pour tous les réseaux actuels.

Paramètres

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    (changes: string[])=>void

    • modifications

      chaîne[]

onNetworksChanged

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

Déclenché lorsque les propriétés changent sur l'un des réseaux. Envoie une liste des GUID pour les réseaux dont les propriétés ont été modifiées.

Paramètres

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    (changes: string[])=>void

    • modifications

      chaîne[]

onPortalDetectionCompleted

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

Déclenché à la fin de la détection d'un portail pour un réseau Envoie le GUID du réseau et l'état du portail captif correspondant.

Paramètres