chrome.networking.onc

Description

L'API chrome.networking.onc permet de configurer les connexions réseau (mobile, 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 majuscule en CamelCase (majuscules et minuscules) pour se conformer à la spécification ONC, et non à la convention JavaScript LowCamelCase.

Autorisations

networking.onc

Disponibilité

Chrome (version 59 ou ultérieure) ChromeOS uniquement

Types

ActivationStateType

Énumération

"Activé"

"Activation..."

"Non activé"

"Partiellement activé"

CaptivePortalStatus

Énumération

"Inconnu"

"Hors connexion"

"En ligne"

"Portail"

"ProxyAuthRequired"

CellularProperties

Propriétés

  • ActivationState

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

  • ActivationType

    chaîne 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 être connecté automatiquement (lorsqu'il est à portée).

  • Famille

    chaîne facultatif

    Famille de technologies de l'appareil mobile : CDMA ou GSM.

  • FirmwareRevision

    chaîne facultatif

    La révision du micrologiciel a été chargée dans le modem cellulaire.

  • FoundNetworks

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

  • HardwareRevision

    chaîne facultatif

    Révision du matériel du modem cellulaire.

  • HomeProvider

    Informations sur l'opérateur ayant émis la carte SIM actuellement installée dans le modem.

  • Fabricant

    chaîne facultatif

    Fabricant du modem cellulaire.

  • ModelID

    chaîne facultatif

    ID du modèle du modem cellulaire.

  • NetworkTechnology

    chaîne 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 ou de modifier un forfait de données mobiles.

  • RoamingState

    chaîne facultatif

    État d'itinérance du modem cellulaire 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 (version 63 ou ultérieure)

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

  • ServingOperator

    Informations concernant l'opérateur sur lequel le modem est actuellement enregistré sur le réseau.

  • SignalStrength

    numéro facultatif

    Intensité actuelle du signal 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 MCC (Mobile Country Code) et MNC (Mobile Network Code) du réseau.

  • Pays

    chaîne 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 dirigé si aucun certificat correspondant à ce format n'est trouvé.

  • Émetteur

    S'il est défini, modèle 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 du certificat. Un certificat doit être signé par l'un d'entre eux pour respecter ce format.

  • Objet

    S'il est défini, le format par rapport auquel les paramètres du sujet X.509 doivent être mis en correspondance.

ClientCertificateType

Énumération

"Réf."

"Schéma"

ConnectionStateType

Énumération

"Connecté"

"Connexion..."

"Non connectée"

DeviceStateProperties

Propriétés

  • SIMLockStatus

    SIMLockStatus facultatif

    Chrome (version 62 ou ultérieure)

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

  • SIMPresent

    Booléen facultatif

    Chrome (version 62 ou ultérieure)

    Définie sur l'état actuel de la carte SIM si l'appareil est de type cellulaire.

  • 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 (mobile, Ethernet ou Wi-Fi).

DeviceStateType

Énumération

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

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

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

"Activé"
L'appareil est activé.

"Interdit"
L'appareil est interdit.

EAPProperties

Propriétés

  • AnonymousIdentity

    chaîne facultatif

  • ID du certificat clientPKCS111

    chaîne facultatif

    Chrome (version 60 ou ultérieure)
  • ClientCertPattern

    CertificatePattern facultatif

  • ClientCertProvisioningProfileId

    chaîne facultatif

    Chrome 93 ou version ultérieure
  • ClientCertRef

    chaîne facultatif

  • ClientCertType
  • Identité

    chaîne facultatif

  • Interne

    chaîne facultatif

  • Externe

    chaîne facultatif

    Type d'EAP externe. Requis par l'ONC, mais peut ne pas être fourni en cas de traduction en shilli.

  • Mot de passe

    chaîne facultatif

  • SaveCredentials

    Booléen facultatif

  • ServerCAPEMs

    string[] facultatif

  • ServerCARefs

    string[] facultatif

  • SubjectMatch

    ManagedDOMString facultatif

    Chrome (version 60 ou ultérieure)
  • UseProactiveKeyCaching

    Booléen facultatif

  • UseSystemCAs

    Booléen facultatif

EthernetProperties

Propriétés

  • Authentification

    chaîne 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 être connecté automatiquement.

  • EAP

    EAPProperties (Facultatif) Facultatif

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

EthernetStateProperties

Propriétés

FoundNetworkProperties

Propriétés

  • LongName

    chaîne facultatif

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

  • NetworkId

    chaîne

    ID de réseau.

  • ShortName

    chaîne facultatif

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

  • État

    chaîne

    Disponibilité du réseau.

  • Technologie

    chaîne

    Accéder à la technologie utilisée par le réseau

GlobalPolicy

Propriétés

  • AllowOnlyPolicyNetworksToAutoconnect

    Booléen facultatif

    Si la valeur est "true", seuls les réseaux associés aux règles peuvent se connecter automatiquement. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnect

    Booléen facultatif

    Si la valeur est définie sur "true", seuls les réseaux de règles peuvent être connectés. 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 associés aux règles peuvent être connectés. Aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • BlockedHexSSIDs

    string[] facultatif

    Chrome 86 ou version ultérieure

    Liste des réseaux bloqués. Les connexions à des réseaux bloqués sont interdites. Les réseaux peuvent être débloqués de nouveau en spécifiant 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 (consultez la page onc_spec.md pour en savoir plus)

  • Passerelle

    chaîne facultatif

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

  • IPAddress

    chaîne 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 (consultez la page onc_spec.md pour en savoir plus)

  • NameServers

    string[] facultatif

    Tableau d'adresses utilisés 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. Consultez onc_spec.md pour plus de détails.

  • Type

    chaîne facultatif

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

  • WebProxyAutoDiscoveryUrl

    chaîne facultatif

    URL de découverte automatique du proxy WEb, telle qu'indiquée via DHCP.

IPConfigType

Énumération

"DHCP"

"Statique"

IssuerSubjectPattern

Propriétés

  • CommonName

    chaîne facultatif

    Si ce champ est défini, la valeur par rapport au nom commun du sujet du certificat doit correspondre.

  • Localité

    chaîne facultatif

    Si ce champ est défini, la valeur par rapport à laquelle doit correspondre l'emplacement commun du sujet du certificat.

  • Organisation

    chaîne facultatif

    Si ce champ est défini, la valeur par rapport à laquelle faire correspondre les organisations du sujet du certificat. Au moins une organisation doit correspondre à la valeur.

  • OrganizationalUnit

    chaîne facultatif

    Si ce champ est défini, la valeur à utiliser pour faire correspondre les 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 réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    Booléen facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

    Source à partir de laquelle la valeur effective de la propriété 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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    Booléen facultatif

    Valeur de la propriété fournie par la règle relative 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

    chaîne facultatif

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

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    chaîne facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    chaîne 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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    chaîne facultatif

    Valeur de la propriété fournie par la règle relative aux utilisateurs.

  • UserSetting

    chaîne 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 réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    string[] facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

    Source à partir de laquelle la valeur effective de la propriété 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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    string[] facultatif

    Valeur de la propriété fournie par la règle relative 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 réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

    Source à partir de laquelle la valeur effective de la propriété 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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par la règle relative 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 réseau (par exemple, Shill).

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    numéro facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

    Source à partir de laquelle la valeur effective de la propriété 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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    numéro facultatif

    Valeur de la propriété fournie par la règle relative 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

ManagedProxySettings

ManagedProxySettingsType

Propriétés

  • Actif

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

  • DeviceEditable

    Booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • DevicePolicy

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    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 une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire la valeur de propriété recommandée pour l'ensemble de règles). La valeur par défaut est false.

  • UserPolicy

    Valeur de la propriété fournie par la règle relative aux utilisateurs.

  • UserSetting

    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.

  • SOLEILS

    ProxyLocation facultatif

    Paramètres du proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facultatif

    Paramètres du 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 à renvoyer. Si aucune valeur n'est spécifiée, la valeur par défaut est 1 000. Indiquez 0 pour "sans limite".

  • 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 cellulaires, propriétés de réseau mobile.

  • Connectable

    Booléen facultatif

    Indique si le réseau peut être connecté.

  • ConnectionState

    État de connexion actuel du réseau.

  • ErrorState

    chaîne facultatif

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

  • Ethernet

    EthernetProperties facultatif

    Pour les réseaux Ethernet, il s'agit des 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

    chaîne facultatif

    Adresse MAC du réseau.

  • Facturé à l'usage

    Booléen facultatif

    Chrome 85 ou version ultérieure

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

  • Nom

    chaîne 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 proxy du réseau.

  • RestrictedConnectivity

    Booléen facultatif

    Pour un réseau connecté, la connectivité réseau à Internet est-elle 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

    la configuration IP reçue du serveur DHCP avant d'appliquer la configuration IP statique.

  • Source

    chaîne facultatif

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "Aucune" 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 IP statique du réseau.

  • TrafficCounterResetTime

    numéro facultatif

    Chrome 125 ou version ultérieure

    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.

  • Wi-Fi

    WiFiProperties facultatif

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

NetworkStateProperties

Propriétés

NetworkType

Énumération

"Toutes"

"Mobile"

"Ethernet"

"Partage de connexion"

"VPN"

"Sans fil"

"Wi-Fi"

PaymentPortal

Propriétés

  • Méthode

    chaîne

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

  • PostData

    chaîne facultatif

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

  • URL

    chaîne 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

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

  • PAC

    chaîne facultatif

    URL du fichier de configuration automatique du proxy.

  • Type de paramètres du proxy.

ProxySettingsType

Énumération

"Direct"

"Manuelle"

"PAC"

"WPAD"

SIMLockStatus

Propriétés

  • LockEnabled

    booléen

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

  • LockType

    chaîne

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

  • RetriesLeft

    numéro facultatif

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

ThirdPartyVPNProperties

Propriétés

  • ExtensionID

    chaîne

    ID de l'extension du fournisseur de VPN tiers.

  • ProviderName

    chaîne facultatif

    Nom du fournisseur de VPN.

VPNProperties

Propriétés

  • AutoConnect

    Booléen facultatif

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

  • Hôte

    chaîne facultatif

    L'hôte VPN.

  • Type

    chaîne facultatif

    Type de VPN. Il ne peut pas s'agir d'une énumération en raison de "L2TP-IPSec". Ceci est facultatif pour NetworkConfigProperties, qui est transmis à setProperties, qui peut être utilisé pour définir uniquement 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 être connecté automatiquement lorsqu'il est à portée.

  • BSSID

    chaîne facultatif

    BSSID du point d'accès associé.

  • EAP

    EAPProperties (Facultatif) Facultatif

    Propriétés du protocole EAP du réseau 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, la fréquence actuelle à laquelle le réseau est connecté. Sinon, il s'agit de la fréquence de la meilleure BSS disponible.

  • FrequencyList

    number[] facultatif

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

  • HexSSID

    chaîne facultatif

    Copie 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

    chaîne facultatif

    Chrome (version 66 ou ultérieure)

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

  • RoamThreshold

    numéro facultatif

    Obsolète, ignoré.

  • SSID

    chaîne facultatif

    SSID du réseau.

  • Sécurité

    chaîne facultatif

    Type de sécurité du réseau.

  • SignalStrength

    numéro facultatif

    Intensité du signal réseau.

WiFiStateProperties

Propriétés

WiMAXProperties

Propriétés

  • AutoConnect

    Booléen facultatif

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

  • EAP

    EAPProperties (Facultatif) Facultatif

    Propriétés du protocole EAP du réseau

Méthodes

createNetwork()

<ph type="x-smartling-placeholder"></ph> 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à, l'opération échoue. Sinon, renvoie le GUID du nouveau réseau.

Paramètres

  • partagés

    booléen

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

    Cette option n'est disponible que dans l'interface utilisateur Web de Chrome*. En cas d'appel par des applications, false est la seule valeur autorisée.

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

  • rappel

    function facultatif

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

    (result: string) => void

    • résultat

      chaîne

Renvoie

  • Promise&lt;string&gt;

    Chrome 125 ou version ultérieure

    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é. Consultez la remarque concernant enableNetworkType.

Paramètres

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

<ph type="x-smartling-placeholder"></ph> 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 tout autre réseau ayant des identifiants correspondants (par exemple, le SSID Wi-Fi et le réseau de sécurité). Si aucune configuration de ce type n'existe, une erreur est définie et l'opération échoue.

Dans les sessions kiosque, cette méthode ne peut pas oublier les configurations réseau partagées.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à supprimer.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome 125 ou version ultérieure

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

getCaptivePortalStatus()

<ph type="x-smartling-placeholder"></ph> 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 obtenir l'état du portail captif.

  • rappel

    function facultatif

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

    (result: CaptivePortalStatus) => void

Renvoie

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125 ou version ultérieure

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

getDeviceStates()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Renvoie les états des appareils réseau disponibles.

Paramètres

Renvoie

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125 ou version ultérieure

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

getGlobalPolicy()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

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

Paramètres

  • rappel

    function facultatif

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

    (result: GlobalPolicy) => void

Renvoie

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125 ou version ultérieure

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

getManagedProperties()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

Récupère les propriétés fusionnées du réseau ayant l'ID networkGuid à partir des sources : "User settings" (Paramètres utilisateur), "Shared settings" (Paramètres partagés), "User policy" (Règles relatives aux utilisateurs), "Device policy" (Règles relatives aux appareils) et les paramètres actuellement actifs.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir les propriétés.

  • rappel

    function facultatif

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

    (result: ManagedProperties) => void

Renvoie

  • Promise&lt;ManagedProperties&gt;

    Chrome 125 ou version ultérieure

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

getNetworks()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

Renvoie une liste d'objets réseau ayant les mêmes propriétés que celles fournies par getState. Un filtre est fourni pour spécifier le type de réseaux affichés 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 étant répertoriés en premier.

Paramètres

Renvoie

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125 ou version ultérieure

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

getProperties()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

Récupère toutes les propriétés du réseau ayant l'identifiant 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 pour lequel obtenir les propriétés.

  • rappel

    function facultatif

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

    (result: NetworkProperties) => void

Renvoie

  • Promise&lt;NetworkProperties&gt;

    Chrome 125 ou version ultérieure

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

getState()

<ph type="x-smartling-placeholder"></ph> 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 ayant l'ID networkGuid. Il s'agit d'une fonction aux 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 fournies pour les réseaux visibles: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir les propriétés.

  • rappel

    function facultatif

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

    (result: NetworkStateProperties) => void

Renvoie

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125 ou version ultérieure

    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 de 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 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 (version 63 ou ultérieure)

    Si ce champ est fourni, demande une analyse spécifique au type. Pour les réseaux mobiles, vous devrez effectuer une recherche de réseau si cette fonctionnalité est disponible.

setProperties()

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

Définit les propriétés du réseau associé à l'ID networkGuid. Ce champ est uniquement valide pour les réseaux configurés (Source != Aucun). 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 les propriétés.

  • Propriétés à définir.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome 125 ou version ultérieure

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

startConnect()

<ph type="x-smartling-placeholder"></ph> 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

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome 125 ou version ultérieure

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

startDisconnect()

<ph type="x-smartling-placeholder"></ph> 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 duquel se déconnecter.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome 125 ou version ultérieure

    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 été modifiée ou lorsque des propriétés d'état des appareils ont changé.

Paramètres

  • rappel

    fonction

    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 été modifiée. Envoie la liste complète des GUID pour tous les réseaux actuels.

Paramètres

  • rappel

    fonction

    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 la liste des GUID pour les réseaux dont les propriétés ont été modifiées.

Paramètres

  • rappel

    fonction

    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é lorsqu'une détection de portail pour un réseau se termine. Envoie le GUID du réseau et l'état correspondant du portail captif.

Paramètres