Descrizione
L'API chrome.networking.onc
viene utilizzata per la configurazione delle connessioni di rete (rete mobile, Ethernet, VPN o Wi-Fi). Questa API è disponibile nelle sessioni kiosk di ChromeOS con avvio automatico.
Le configurazioni delle connessioni di rete vengono specificate seguendo la specifica Open Network Configuration (ONC).
NOTA: la maggior parte delle proprietà del dizionario e dei valori di enum utilizzano UpperCamelCase per corrispondere alla specifica ONC anziché alla convenzione JavaScript belowCamelCase.
Autorizzazioni
networking.onc
Disponibilità
Tipi
ActivationStateType
Enum
CaptivePortalStatus
Enum
"Offline"
"Online"
"ProxyAuthRequired"
CellularProperties
Proprietà
-
ActivationState
Facoltativo ActivationStateType
Stato attivazione account operatore.
-
ActivationType
stringa facoltativo
Il tipo di attivazione della rete mobile.
-
AllowRoaming
booleano facoltativo
Indica se il roaming è consentito per la rete.
-
AutoConnect
booleano facoltativo
Se la rete cellulare deve essere connessa automaticamente (quando si trova nel raggio d'azione).
-
Famiglia
stringa facoltativo
Famiglia di tecnologia dei dispositivi mobili:
CDMA
oGSM
. -
FirmwareRevision
stringa facoltativo
La revisione del firmware è stata caricata nel modem cellulare.
-
FoundNetworks
FoundNetworkProperties[] facoltativo
L'elenco di reti trovate durante la ricerca più recente della rete.
-
HardwareRevision
stringa facoltativo
La revisione dell'hardware del modem cellulare.
-
HomeProvider
CellularProviderProperties facoltativo
Informazioni sull'operatore che ha emesso la scheda SIM attualmente installata nel modem.
-
Produttore
stringa facoltativo
Il produttore del modem cellulare.
-
ModelID
stringa facoltativo
L'ID modello del modem cellulare.
-
NetworkTechnology
stringa facoltativo
Se il modem è registrato su una rete, significa che la tecnologia di rete attualmente in uso.
-
PaymentPortal
PaymentPortal facoltativo
Portale di pagamento online che un utente può utilizzare per registrarsi o modificare un piano dati mobili.
-
RoamingState
stringa facoltativo
Lo stato di roaming del modem cellulare sulla rete corrente.
-
SIMLockStatus
Facoltativo SIMLockStatus
Lo stato del blocco della SIM per le reti familiari GSM.
-
SIMPresent
booleano facoltativo
Indica se è presente una scheda SIM.
-
Scansione in corso
booleano facoltativo
Chrome 63 e versioni successiveTrue quando è in corso una ricerca della rete mobile.
-
ServingOperator
CellularProviderProperties facoltativo
Informazioni sull'operatore sulla rete su cui è attualmente registrato il modem.
-
SignalStrength
numero facoltativo
L'intensità del segnale di rete corrente.
-
SupportNetworkScan
booleano facoltativo
Se la rete cellulare supporta la scansione.
CellularProviderProperties
Proprietà
-
Codice
stringa
L'ID rete mobile è una semplice concatenazione del Centro clienti (Mobile Country Code) e della MNC (Mobile Network Code) della rete.
-
Paese
stringa facoltativo
Il codice del paese di due lettere.
-
Nome
stringa
Il nome dell'operatore.
CellularStateProperties
Proprietà
-
ActivationState
Facoltativo ActivationStateType
-
NetworkTechnology
stringa facoltativo
-
RoamingState
stringa facoltativo
-
SIMPresent
booleano facoltativo
-
SignalStrength
numero facoltativo
CertificatePattern
Proprietà
-
EnrollmentURI
string[] facoltativo
Elenco di URI a cui l'utente può essere indirizzato nel caso in cui non vengano trovati certificati corrispondenti a questo pattern.
-
Emittente
IssuerSubjectPattern facoltativo
Se impostato, il pattern in base al quale devono essere abbinate le impostazioni dell'emittente X.509.
-
IssuerCARef
string[] facoltativo
Elenco dei certificati CA emittente del certificato. Un certificato deve essere firmato da uno di loro per corrispondere a questo pattern.
-
Oggetto
IssuerSubjectPattern facoltativo
Se impostato, sequenza a cui associare le impostazioni del soggetto X.509.
ClientCertificateType
Enum
ConnectionStateType
Enum
DeviceStateProperties
Proprietà
-
SIMLockStatus
Facoltativo SIMLockStatus
Chrome 62 e versioni successiveLo stato di blocco della SIM se Type = Cellular e SIMPresent = True.
-
SIMPresent
booleano facoltativo
Chrome 62 e versioni successiveImposta lo stato presente della SIM se il tipo di dispositivo è Cellulare.
-
Scansione in corso
booleano facoltativo
Da impostare se il dispositivo è attivo. True se il dispositivo è in fase di scansione.
-
Stato
Lo stato attuale del dispositivo.
-
Tipo
Il tipo di rete associato al dispositivo (Rete dati, Ethernet o Wi-Fi).
DeviceStateType
Enum
"Non inizializzato"
Il dispositivo è disponibile ma non inizializzato.
"Disattivato"
Il dispositivo è stato inizializzato, ma non è abilitato.
"Abilitazione"
Lo stato Attivato è stato richiesto, ma non è stato completato.
"Attivato"
Dispositivo attivato.
"Vietato"
Dispositivo vietato.
EAPProperties
Proprietà
-
AnonymousIdentity
stringa facoltativo
-
ClientCertPKCS11Id
stringa facoltativo
Chrome 60 e versioni successive -
ClientCertPattern
CertificatePattern facoltativo
-
ClientCertProvisioningProfileId
stringa facoltativo
Chrome 93 e versioni successive -
ClientCertRef
stringa facoltativo
-
ClientCertType
-
Identità
stringa facoltativo
-
Inner
stringa facoltativo
-
Esterno
stringa facoltativo
Il tipo EAP esterno. Obbligatorio da ONC, ma potrebbe non essere fornito per la traduzione da Shill.
-
Password
stringa facoltativo
-
SaveCredentials
booleano facoltativo
-
ServerCAPEMs
string[] facoltativo
-
ServerCARefs
string[] facoltativo
-
SubjectMatch
ManagedDOMString facoltativo
Chrome 60 e versioni successive -
UseProactiveKeyCaching
booleano facoltativo
-
UseSystemCAs
booleano facoltativo
EthernetProperties
Proprietà
-
Autenticazione
stringa facoltativo
L'autenticazione utilizzata dalla rete Ethernet. I valori possibili sono
None
e8021X
. -
AutoConnect
booleano facoltativo
Indica se la rete Ethernet deve essere connessa automaticamente.
-
EAP
EAPProperties facoltativo
Impostazioni EAP della rete. Richiesto per l'autenticazione 8021X.
EthernetStateProperties
Proprietà
-
Autenticazione
stringa
FoundNetworkProperties
Proprietà
-
LongName
stringa facoltativo
Il nome nel formato lungo dell'operatore di rete.
-
NetworkId
stringa
ID rete.
-
ShortName
stringa facoltativo
Il nome nel formato breve dell'operatore di rete.
-
Stato
stringa
Disponibilità della rete.
-
Tecnologia
stringa
Accedi alla tecnologia utilizzata dalla rete.
GlobalPolicy
Proprietà
-
AllowOnlyPolicyNetworksToAutoconnect
booleano facoltativo
Se il valore è true, solo le reti di criteri possono connettersi automaticamente. Il valore predefinito è false.
-
AllowOnlyPolicyNetworksToConnect
booleano facoltativo
Se il valore è true, solo le reti dei criteri possono essere connesse e non è possibile aggiungere o configurare nuove reti. Il valore predefinito è false.
-
AllowOnlyPolicyNetworksToConnectIfAvailable
booleano facoltativo
Chrome 70 e versioni successiveSe il valore true e una rete gestita è disponibile nell'elenco di reti visibile, possono essere connesse solo le reti di criteri e non è possibile aggiungere o configurare nuove reti. Il valore predefinito è false.
-
BlockedHexSSIDs
string[] facoltativo
Chrome 86 e versioni successiveElenco delle reti bloccate. Le connessioni a reti bloccate sono vietate. Le reti possono essere sbloccate di nuovo specificando una configurazione di rete esplicita. Il valore predefinito è un elenco vuoto.
IPConfigProperties
Proprietà
-
ExcludedRoutes
string[] facoltativo
Chrome 76 e versioni successiveArray di blocchi IP in notazione CIDR, consulta onc_spec.md per i dettagli.
-
Gateway
stringa facoltativo
Indirizzo del gateway utilizzato per la configurazione IP.
-
IPAddress
stringa facoltativo
L'indirizzo IP di una connessione. Può essere un indirizzo IPv4 o IPv6, a seconda del valore di
Type
. -
IncludedRoutes
string[] facoltativo
Chrome 76 e versioni successiveArray di blocchi IP in notazione CIDR, consulta onc_spec.md per i dettagli.
-
NameServers
string[] facoltativo
Array di indirizzi utilizzati per i server dei nomi.
-
RoutingPrefix
numero facoltativo
Il prefisso di routing.
-
SearchDomains
string[] facoltativo
Chrome 76 e versioni successiveArray di stringhe per la risoluzione dei nomi, vedi onc_spec.md per i dettagli.
-
Tipo
stringa facoltativo
Il tipo di configurazione IP. Può essere
IPv4
oIPv6
. -
WebProxyAutoDiscoveryUrl
stringa facoltativo
L'URL per il rilevamento automatico del proxy WEb, come segnalato tramite DHCP.
IPConfigType
Enum
"DHCP"
IssuerSubjectPattern
Proprietà
-
CommonName
stringa facoltativo
Se impostato, il valore in base al quale far corrispondere il nome comune dell'oggetto del certificato.
-
Località
stringa facoltativo
Se impostato, il valore in base al quale far corrispondere la posizione comune dell'oggetto del certificato.
-
Organizzazione
stringa facoltativo
Se impostato, il valore in base al quale trovare corrispondenze per le organizzazioni dell'oggetto del certificato. Almeno un'organizzazione deve corrispondere al valore.
-
OrganizationalUnit
stringa facoltativo
Se impostato, il valore in base al quale far corrispondere le unità organizzative dell'oggetto del certificato. Il valore deve corrispondere ad almeno un'unità organizzativa.
ManagedBoolean
Proprietà
-
Attivo
booleano facoltativo
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
booleano facoltativo
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
booleano facoltativo
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
booleano facoltativo
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
booleano facoltativo
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedCellularProperties
Proprietà
-
ActivationState
Facoltativo ActivationStateType
-
ActivationType
stringa facoltativo
-
AllowRoaming
booleano facoltativo
-
AutoConnect
ManagedBoolean facoltativo
-
Famiglia
stringa facoltativo
-
FirmwareRevision
stringa facoltativo
-
FoundNetworks
FoundNetworkProperties[] facoltativo
-
HardwareRevision
stringa facoltativo
-
HomeProvider
CellularProviderProperties[] facoltativo
-
Produttore
stringa facoltativo
-
ModelID
stringa facoltativo
-
NetworkTechnology
stringa facoltativo
-
PaymentPortal
PaymentPortal facoltativo
-
RoamingState
stringa facoltativo
-
SIMLockStatus
Facoltativo SIMLockStatus
-
SIMPresent
booleano facoltativo
-
Scansione in corso
booleano facoltativo
Chrome 63 e versioni successive -
ServingOperator
CellularProviderProperties facoltativo
-
SignalStrength
numero facoltativo
-
SupportNetworkScan
booleano facoltativo
ManagedDOMString
Proprietà
-
Attivo
stringa facoltativo
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
stringa facoltativo
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
stringa facoltativo
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
stringa facoltativo
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
stringa facoltativo
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedDOMStringList
Proprietà
-
Attivo
string[] facoltativo
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
string[] facoltativo
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
string[] facoltativo
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
string[] facoltativo
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
string[] facoltativo
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedEthernetProperties
Proprietà
-
Autenticazione
ManagedDOMString facoltativo
-
AutoConnect
ManagedBoolean facoltativo
ManagedIPConfigProperties
Proprietà
-
Gateway
ManagedDOMString facoltativo
-
IPAddress
ManagedDOMString facoltativo
-
NameServers
Facoltativo ManagedDOMStringList
-
RoutingPrefix
ManagedLong facoltativo
-
Tipo
ManagedDOMString facoltativo
Vedi
IPConfigProperties.Type
. -
WebProxyAutoDiscoveryUrl
ManagedDOMString facoltativo
ManagedIPConfigType
Proprietà
-
Attivo
IPConfigType facoltativo
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
IPConfigType facoltativo
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
IPConfigType facoltativo
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
IPConfigType facoltativo
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
IPConfigType facoltativo
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedLong
Proprietà
-
Attivo
numero facoltativo
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
numero facoltativo
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
numero facoltativo
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
numero facoltativo
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
numero facoltativo
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedManualProxySettings
Proprietà
-
FTPProxy
ManagedProxyLocation facoltativo
-
HTTPProxy
ManagedProxyLocation facoltativo
-
CALZI
ManagedProxyLocation facoltativo
-
SecureHTTPProxy
ManagedProxyLocation facoltativo
ManagedProperties
Proprietà
-
Rete dati
ManagedCellularProperties facoltativo
-
Collegabile
booleano facoltativo
-
ConnectionState
ConnectionStateType facoltativo
-
ErrorState
stringa facoltativo
-
Ethernet
ManagedEthernetProperties facoltativo
-
GUID
stringa
Vedi
NetworkProperties.GUID
. -
IPAddressConfigType
Facoltativo ManagedIPConfigType
-
IPConfigs
IPConfigProperties[] facoltativo
-
MacAddress
stringa facoltativo
-
A consumo
ManagedBoolean facoltativo
Chrome 85 e versioni successive -
Nome
ManagedDOMString facoltativo
Vedi
NetworkProperties.Name
. -
NameServersConfigType
Facoltativo ManagedIPConfigType
-
Priorità
ManagedLong facoltativo
-
ProxySettings
ManagedProxySettings facoltativo
-
RestrictedConnectivity
booleano facoltativo
-
SavedIPConfig
IPConfigProperties facoltativo
-
Origine
stringa facoltativo
Vedi
NetworkProperties.Source
. -
StaticIPConfig
ManagedIPConfigProperties facoltativo
-
TrafficCounterResetTime
numero facoltativo
Chrome 125 e versioni successive -
Tipo
Vedi
NetworkProperties.Type
. -
VPN
ManagedVPNProperties facoltativo
Vedi
NetworkProperties.VPN
. -
WiFi
ManagedWiFiProperties facoltativo
Vedi
NetworkProperties.WiFi
.
ManagedProxyLocation
Proprietà
-
Host
Vedi
ProxyLocation.Host
. -
Porta
Vedi
ProxyLocation.Port
.
ManagedProxySettings
Proprietà
-
ExcludeDomains
Facoltativo ManagedDOMStringList
-
Manuale
ManagedManualProxySettings facoltativo
Vedi
ProxySettings.Manual
. -
PAC
ManagedDOMString facoltativo
Vedi
ProxySettings.PAC
. -
Vedi
ProxySettings.Type
.
ManagedProxySettingsType
Proprietà
-
Attivo
Facoltativo ProxySettingsType
Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).
-
DeviceEditable
booleano facoltativo
Indica se esiste un DevicePolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato di criteri). Il valore predefinito è
false
. -
DevicePolicy
Facoltativo ProxySettingsType
Il valore della proprietà fornito dal criterio relativo ai dispositivi.
-
In vigore
stringa facoltativo
La sorgente da cui è stato determinato il valore effettivo della proprietà.
-
Facoltativo ProxySettingsType
Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se
DeviceEditiable
ètrue
. -
UserEditable
booleano facoltativo
Indica se esiste un UserPolicy per la proprietà e consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato sul criterio). Il valore predefinito è
false
. -
UserPolicy
Facoltativo ProxySettingsType
Il valore della proprietà fornito dai criteri relativi agli utenti.
-
UserSetting
Facoltativo ProxySettingsType
Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se
UserEditable
ètrue
.
ManagedThirdPartyVPNProperties
Proprietà
-
ExtensionID
-
ProviderName
stringa facoltativo
ManagedVPNProperties
Proprietà
-
AutoConnect
ManagedBoolean facoltativo
-
Host
ManagedDOMString facoltativo
Vedi
VPNProperties.Host
. -
Tipo
ManagedDOMString facoltativo
Vedi
VPNProperties.Type
.
ManagedWiFiProperties
Proprietà
-
AllowGatewayARPPolling
ManagedBoolean facoltativo
-
AutoConnect
ManagedBoolean facoltativo
-
BSSID
stringa facoltativo
Vedi
WiFiProperties.BSSID
. -
Frequenza
numero facoltativo
Vedi
WiFiProperties.Frequency
. -
FrequencyList
number[] facoltativo
-
HexSSID
ManagedDOMString facoltativo
Vedi
WiFiProperties.HexSSID
. -
HiddenSSID
ManagedBoolean facoltativo
-
RoamThreshold
ManagedLong facoltativo
Obsoleto, ignorato. Vedi
WiFiProperties.RoamThreshold
. -
SSID
ManagedDOMString facoltativo
Vedi
WiFiProperties.SSID
. -
Sicurezza
Vedi
WiFiProperties.Security
. -
SignalStrength
numero facoltativo
ManualProxySettings
Proprietà
-
FTPProxy
ProxyLocation facoltativo
Impostazioni per il proxy FTP.
-
HTTPProxy
ProxyLocation facoltativo
Impostazioni per il proxy HTTP.
-
CALZI
ProxyLocation facoltativo
Impostazioni per il proxy SOCKS.
-
SecureHTTPProxy
ProxyLocation facoltativo
Impostazioni per il proxy HTTP sicuro.
NetworkConfigProperties
Proprietà
-
Rete dati
CellularProperties facoltativo
-
Ethernet
Facoltativo EthernetProperties
-
GUID
stringa facoltativo
Vedi
NetworkProperties.GUID
. -
IPAddressConfigType
IPConfigType facoltativo
-
Nome
stringa facoltativo
Vedi
NetworkProperties.Name
. -
NameServersConfigType
IPConfigType facoltativo
-
Priorità
numero facoltativo
-
Tipo
Facoltativo NetworkType
Vedi
NetworkProperties.Type
. -
VPN
VPNProperties facoltativo
Vedi
NetworkProperties.VPN
. -
WiFi
WiFiProperties facoltativo
Vedi
NetworkProperties.WiFi
. -
WiMAX
WiMAXProperties facoltativo
Deprecato.
NetworkFilter
Proprietà
-
configurato
booleano facoltativo
Se true, include solo le reti configurate (salvate). Il valore predefinito è "false".
-
limite
numero facoltativo
Numero massimo di reti da restituire. Se non specificato, il valore predefinito è 1000. Usa 0 per non impostare alcun limite.
-
networkType
Il tipo di reti da restituire.
-
visibile
booleano facoltativo
Se il valore è true, includi solo le reti visibili (fisicamente connesse o nel raggio d'azione). Il valore predefinito è "false".
NetworkProperties
Proprietà
-
Rete dati
CellularProperties facoltativo
Per le reti mobili, le proprietà delle reti mobili.
-
Collegabile
booleano facoltativo
Indica se la rete è collegabile.
-
ConnectionState
ConnectionStateType facoltativo
Lo stato attuale della connessione della rete.
-
ErrorState
stringa facoltativo
L'ultimo stato di errore di rete registrato.
-
Ethernet
Facoltativo EthernetProperties
Per le reti Ethernet, le proprietà della rete Ethernet.
-
GUID
stringa
Il GUID di rete.
-
IPAddressConfigType
IPConfigType facoltativo
Il tipo di configurazione dell'indirizzo IP della rete.
-
IPConfigs
IPConfigProperties[] facoltativo
La configurazione IP della rete.
-
MacAddress
stringa facoltativo
L'indirizzo MAC della rete.
-
A consumo
booleano facoltativo
Chrome 85 e versioni successiveIndica se la rete è a consumo.
-
Nome
stringa facoltativo
Un nome di rete facile da usare.
-
NameServersConfigType
IPConfigType facoltativo
Il tipo di configurazione IP per i server dei nomi utilizzati dalla rete.
-
Priorità
numero facoltativo
La priorità della rete.
-
ProxySettings
ProxySettings facoltativo
Le impostazioni del proxy della rete.
-
RestrictedConnectivity
booleano facoltativo
Nel caso di una rete connessa, indica se la connettività di rete a internet è limitata, ad esempio se la rete si trova dietro un portale o se non è attiva una rete cellulare.
-
SavedIPConfig
IPConfigProperties facoltativo
Configurazione IP ricevuta dal server DHCP prima di applicare la configurazione IP statico.
-
Origine
stringa facoltativo
Indica se e come è configurata la rete. I valori possibili sono:
Device
DevicePolicy
User
UserPolicy
None
"Nessuno" è in conflitto con la generazione del codice dell'estensione, pertanto dobbiamo utilizzare una stringa per "Origine" anziché un'enumerazione SourceType.
-
StaticIPConfig
IPConfigProperties facoltativo
La configurazione dell'IP statico della rete.
-
TrafficCounterResetTime
numero facoltativo
Chrome 125 e versioni successiveData/ora dell'ultima reimpostazione dei contatori di traffico.
-
Tipo
Il tipo di rete.
-
VPN
VPNProperties facoltativo
Per le reti VPN, le proprietà VPN di rete.
-
WiFi
WiFiProperties facoltativo
Per le reti Wi-Fi, le proprietà della rete Wi-Fi.
NetworkStateProperties
Proprietà
-
Rete dati
CellularStateProperties facoltativo
-
Collegabile
booleano facoltativo
-
ConnectionState
ConnectionStateType facoltativo
-
ErrorState
stringa facoltativo
-
Ethernet
Facoltativo EthernetStateProperties
-
GUID
stringa
Vedi
NetworkProperties.GUID
. -
Nome
stringa facoltativo
Vedi
NetworkProperties.Name
. -
Priorità
numero facoltativo
-
Origine
stringa facoltativo
Vedi
NetworkProperties.Source
. -
Tipo
Vedi
NetworkProperties.Type
. -
VPN
VPNStateProperties facoltativo
Vedi
NetworkProperties.VPN
. -
WiFi
WiFiStateProperties facoltativo
Vedi
NetworkProperties.WiFi
.
NetworkType
Enum
"Ethernet"
"VPN"
"Wireless"
PaymentPortal
Proprietà
-
Metodo
stringa
Il metodo HTTP da utilizzare per il portale di pagamento.
-
PostData
stringa facoltativo
I dati di caricamento da inviare al portale di pagamento. Ignorato a meno che
Method
non siaPOST
. -
URL
stringa facoltativo
L'URL del portale di pagamento.
ProxyLocation
Proprietà
-
Host
stringa
L'host dell'indirizzo IP del proxy.
-
Porta
numero
La porta da utilizzare per il proxy.
ProxySettings
Proprietà
-
ExcludeDomains
string[] facoltativo
Domini e host per i quali le impostazioni manuali del proxy sono escluse.
-
Manuale
ManualProxySettings facoltativo
Impostazioni manuali del proxy - utilizzate solo per le impostazioni proxy
Manual
. -
PAC
stringa facoltativo
URL per il file di configurazione automatica del proxy.
-
Tipo
Il tipo di impostazioni del proxy.
ProxySettingsType
Enum
"PAC"
"WPAD"
SIMLockStatus
Proprietà
-
LockEnabled
boolean
Indica se il blocco della SIM è attivo.
-
LockType
stringa
Lo stato del blocco della SIM; i valori possibili sono
'sim-pin'
,'sim-puk'
e''
. -
RetriesLeft
numero facoltativo
Numero di tentativi di blocco con PIN consentiti prima che sia necessario il PUK per sbloccare la SIM.
ThirdPartyVPNProperties
Proprietà
-
ExtensionID
stringa
ID dell'estensione del provider VPN di terze parti.
-
ProviderName
stringa facoltativo
Il nome del provider VPN.
VPNProperties
Proprietà
-
AutoConnect
booleano facoltativo
Indica se la rete VPN deve essere connessa automaticamente.
-
Host
stringa facoltativo
L'host della VPN.
-
Tipo
stringa facoltativo
Il tipo di VPN. Questa non può essere un'enumerazione a causa di "L2TP-IPSec". Questo campo è facoltativo per NetworkConfigProperties, che viene passato a setProperties che può essere utilizzato per impostare solo proprietà specifiche.
VPNStateProperties
Proprietà
-
Tipo
stringa
Vedi
VPNProperties.Type
.
WiFiProperties
Proprietà
-
AllowGatewayARPPolling
booleano facoltativo
Indica se il polling ARP del gateway predefinito è consentito. Il valore predefinito è true.
-
AutoConnect
booleano facoltativo
Indica se la rete Wi-Fi deve connettersi automaticamente quando è nel raggio d'azione.
-
BSSID
stringa facoltativo
Il BSSID del punto di accesso associato.
-
EAP
EAPProperties facoltativo
Le proprietà EAP rete. Obbligatorio per le reti
WEP-8021X
eWPA-EAP
. -
Frequenza
numero facoltativo
La frequenza di funzionamento del servizio Wi-Fi in MHz. Per le reti connesse, la frequenza attuale a cui è connessa la rete. Altrimenti, la frequenza del miglior BSS disponibile.
-
FrequencyList
number[] facoltativo
Contiene tutte le frequenze operative rilevate di recente per la rete Wi-Fi.
-
HexSSID
stringa facoltativo
Copia con codifica esadecimale dell'SSID di rete.
-
HiddenSSID
booleano facoltativo
Se l'SSID della rete verrà trasmesso.
-
Passphrase
stringa facoltativo
Chrome 66 e versioni successiveLa passphrase per le connessioni WEP/WPA/WPA2. Questa proprietà può essere impostata solo. Le proprietà restituite da
getProperties
non conterranno questo valore. -
RoamThreshold
numero facoltativo
Obsoleto, ignorato.
-
SSID
stringa facoltativo
L'SSID della rete.
-
Sicurezza
stringa facoltativo
Il tipo di sicurezza della rete.
-
SignalStrength
numero facoltativo
L'intensità del segnale di rete.
WiFiStateProperties
Proprietà
-
BSSID
stringa facoltativo
Vedi
WiFiProperties.BSSID
. -
Frequenza
numero facoltativo
Vedi
WiFiProperties.Frequency
. -
HexSSID
stringa facoltativo
Chrome 62 e versioni successiveVedi
WiFiProperties.HexSSID
. -
SSID
stringa facoltativo
Chrome 62 e versioni successiveVedi
WiFiProperties.SSID
. -
Sicurezza
stringa
Vedi
WiFiProperties.Security
. -
SignalStrength
numero facoltativo
WiMAXProperties
Proprietà
-
AutoConnect
booleano facoltativo
Indica se la rete deve essere connessa automaticamente.
-
EAP
EAPProperties facoltativo
Le proprietà EAP rete.
Metodi
createNetwork()
chrome.networking.onc.createNetwork(
shared: boolean,
properties: NetworkConfigProperties,
callback?: function,
)
Crea una nuova configurazione di rete dalle proprietà. Se esiste già una rete configurata corrispondente, l'operazione non andrà a buon fine. In caso contrario, restituisce il GUID della nuova rete.
Parametri
-
boolean
Se
true
, condividi questa configurazione di rete con altri utenti.Questa opzione è esposta solo all'interfaccia utente web di Chrome*. Quando viene chiamato dalle app,
false
è l'unico valore consentito. -
proprietà
Le proprietà con cui configurare la nuova rete.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: string) => void
-
risultato
stringa
-
Ritorni
-
Promessa<string>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
disableNetworkType()
chrome.networking.onc.disableNetworkType(
networkType: NetworkType,
)
Disattiva tutti i dispositivi corrispondenti al tipo di rete specificato. Vedi la nota per enableNetworkType
.
Parametri
-
networkType
Il tipo di rete da disabilitare.
enableNetworkType()
chrome.networking.onc.enableNetworkType(
networkType: NetworkType,
)
Consente di attivare tutti i dispositivi corrispondenti al tipo di rete specificato. Tieni presente che il tipo potrebbe rappresentare più tipi di rete (ad es. "Wireless").
Parametri
-
networkType
Il tipo di rete da abilitare.
forgetNetwork()
chrome.networking.onc.forgetNetwork(
networkGuid: string,
callback?: function,
)
Elimina una configurazione di rete cancellando le eventuali proprietà configurate per la rete con GUID networkGuid
. Potrebbero essere incluse anche altre reti con identificatori corrispondenti (ad esempio SSID e sicurezza del Wi-Fi). Se questa configurazione non esiste, verrà impostato un errore e l'operazione non andrà a buon fine.
Nelle sessioni kiosk, questo metodo non consentirà di dimenticare le configurazioni di rete condivise.
Parametri
-
networkGuid
stringa
Il GUID della rete da dimenticare.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getCaptivePortalStatus()
chrome.networking.onc.getCaptivePortalStatus(
networkGuid: string,
callback?: function,
)
Restituisce lo stato del captive portal per la rete "networkGuid" corrispondente.
Parametri
-
networkGuid
stringa
Il GUID della rete per cui ottenere lo stato del captive portal.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: CaptivePortalStatus) => void
-
risultato
-
Ritorni
-
Promise<CaptivePortalStatus>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDeviceStates()
chrome.networking.onc.getDeviceStates(
callback?: function,
)
Restituisce gli stati dei dispositivi di rete disponibili.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: DeviceStateProperties[]) => void
-
risultato
-
Ritorni
-
Promise<DeviceStateProperties[]>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getGlobalPolicy()
chrome.networking.onc.getGlobalPolicy(
callback?: function,
)
Recupera le proprietà del criterio globale. Non è previsto che queste proprietà cambino durante una sessione.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: GlobalPolicy) => void
-
risultato
-
Ritorni
-
Promise<GlobalPolicy>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getManagedProperties()
chrome.networking.onc.getManagedProperties(
networkGuid: string,
callback?: function,
)
Recupera le proprietà unite della rete con ID networkGuid dalle origini: Impostazioni utente, Impostazioni condivise, criteri relativi agli utenti, criteri relativi ai dispositivi e impostazioni attualmente attive.
Parametri
-
networkGuid
stringa
Il GUID della rete per cui ottenere le proprietà.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: ManagedProperties) => void
-
risultato
-
Ritorni
-
Promise<ManagedProperties>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getNetworks()
chrome.networking.onc.getNetworks(
filter: NetworkFilter,
callback?: function,
)
Restituisce un elenco di oggetti di rete con le stesse proprietà fornite da getState
. Viene fornito un filtro per specificare il tipo di reti restituito e per limitare il numero di reti. Le reti sono ordinate dal sistema in base alla loro priorità; le reti connesse o connesse sono elencate per prime.
Parametri
-
filter
Descrive le reti da restituire.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: NetworkStateProperties[]) => void
-
risultato
-
Ritorni
-
Promise<NetworkStateProperties[]>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getProperties()
chrome.networking.onc.getProperties(
networkGuid: string,
callback?: function,
)
Recupera tutte le proprietà della rete con ID networkGuid. Include tutte le proprietà della rete (valori di sola lettura e lettura/scrittura).
Parametri
-
networkGuid
stringa
Il GUID della rete per cui ottenere le proprietà.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: NetworkProperties) => void
-
risultato
-
Ritorni
-
Promise<NetworkProperties>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getState()
chrome.networking.onc.getState(
networkGuid: string,
callback?: function,
)
Recupera le proprietà di sola lettura memorizzate nella cache della rete con ID networkGuid. Si tratta di una funzione con prestazioni superiori rispetto a getProperties
, che richiede un round trip per eseguire query sul sottosistema di networking. Per tutte le reti vengono restituite le seguenti proprietà: GUID, Type, Name, WiFi.Security. Vengono fornite proprietà aggiuntive per le reti visibili: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.
Parametri
-
networkGuid
stringa
Il GUID della rete per cui ottenere le proprietà.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: NetworkStateProperties) => void
-
risultato
-
Ritorni
-
Promise<NetworkStateProperties>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
requestNetworkScan()
chrome.networking.onc.requestNetworkScan(
networkType?: NetworkType,
)
Richieste che il sottosistema di networking cerchi nuove reti e aggiorni l'elenco restituito da getVisibleNetworks
. Questa è solo una richiesta: il sottosistema di rete può scegliere di ignorarla. Se l'elenco viene aggiornato, verrà attivato l'evento onNetworkListChanged
.
Parametri
-
networkType
Facoltativo NetworkType
Chrome 63 e versioni successiveSe fornito, richiede una scansione specifica per il tipo. Per il cellulare, verrà richiesta una ricerca della rete mobile, se supportata.
setProperties()
chrome.networking.onc.setProperties(
networkGuid: string,
properties: NetworkConfigProperties,
callback?: function,
)
Imposta le proprietà della rete con ID networkGuid
. È valido solo per le reti configurate (Origine != Nessuna). Le reti visibili non configurate devono invece utilizzare createNetwork
. Nelle sessioni kiosk, questo metodo di chiamata su una rete condivisa non andrà a buon fine.
Parametri
-
networkGuid
stringa
Il GUID della rete per cui impostare le proprietà.
-
proprietà
Le proprietà da impostare.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
startConnect()
chrome.networking.onc.startConnect(
networkGuid: string,
callback?: function,
)
Avvia una connessione alla rete con networkGuid.
Parametri
-
networkGuid
stringa
Il GUID della rete a cui connetterti.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
startDisconnect()
chrome.networking.onc.startDisconnect(
networkGuid: string,
callback?: function,
)
Avvia una disconnessione dalla rete con networkGuid.
Parametri
-
networkGuid
stringa
Il GUID della rete da cui disconnettersi.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 125 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
Eventi
onDeviceStateListChanged
chrome.networking.onc.onDeviceStateListChanged.addListener(
callback: function,
)
Viene attivato quando l'elenco dei dispositivi viene modificato o le proprietà dello stato dei dispositivi cambiano.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:() => void
onNetworkListChanged
chrome.networking.onc.onNetworkListChanged.addListener(
callback: function,
)
Attivato quando l'elenco di reti viene modificato. Invia un elenco completo dei GUID per tutte le reti correnti.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(changes: string[]) => void
-
modifiche
stringa[]
-
onNetworksChanged
chrome.networking.onc.onNetworksChanged.addListener(
callback: function,
)
Attivato quando le proprietà cambiano su una rete. Invia un elenco di GUID per le reti le cui proprietà sono state modificate.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(changes: string[]) => void
-
modifiche
stringa[]
-
onPortalDetectionCompleted
chrome.networking.onc.onPortalDetectionCompleted.addListener(
callback: function,
)
Attivato al completamento del rilevamento di un portale per una rete. Invia il GUID della rete e lo stato del captive portal corrispondente.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(networkGuid: string, status: CaptivePortalStatus) => void
-
networkGuid
stringa
-
status
-