chrome.networking.onc

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à

Chrome 59 e versioni successive Solo ChromeOS

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 o GSM.

  • 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 successive

    True 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à

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 successive

    Lo stato di blocco della SIM se Type = Cellular e SIMPresent = True.

  • SIMPresent

    booleano facoltativo

    Chrome 62 e versioni successive

    Imposta 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.

  • Lo stato attuale del dispositivo.

  • 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

    ClientCertificateType

  • 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 e 8021X.

  • 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à

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 successive

    Se 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 successive

    Elenco 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 successive

    Array 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 successive

    Array 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 successive

    Array 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 o IPv6.

  • 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à.

  • SharedSetting

    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à

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à.

  • SharedSetting

    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à.

  • SharedSetting

    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à

ManagedIPConfigProperties

Proprietà

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à.

  • SharedSetting

    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à.

  • SharedSetting

    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à

ManagedProperties

Proprietà

ManagedProxyLocation

Proprietà

ManagedProxySettings

Proprietà

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à.

  • SharedSetting

    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à

ManagedVPNProperties

Proprietà

ManagedWiFiProperties

Proprietà

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à

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

    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 successive

    Indica 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

    In attesa

    Data/ora dell'ultima reimpostazione dei contatori di traffico.

  • 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à

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 sia POST.

  • 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.

  • 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à

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 e WPA-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 successive

    La 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à

WiMAXProperties

Proprietà

  • AutoConnect

    booleano facoltativo

    Indica se la rete deve essere connessa automaticamente.

  • EAP

    EAPProperties facoltativo

    Le proprietà EAP rete.

Metodi

createNetwork()

Promessa 
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

  • condiviso

    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.

  • 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>

    In attesa

    Le 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

    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

    NetworkType

    Il tipo di rete da abilitare.

forgetNetwork()

Promessa 
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>

    In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getCaptivePortalStatus()

Promessa 
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

Ritorni

  • In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getDeviceStates()

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

Restituisce gli stati dei dispositivi di rete disponibili.

Parametri

Ritorni

  • In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getGlobalPolicy()

Promessa 
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

Ritorni

  • Promise<GlobalPolicy>

    In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getManagedProperties()

Promessa 
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

Ritorni

  • In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getNetworks()

Promessa 
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

Ritorni

  • In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getProperties()

Promessa 
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

Ritorni

  • In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

getState()

Promessa 
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

Ritorni

  • In attesa

    Le 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 successive

    Se fornito, richiede una scansione specifica per il tipo. Per il cellulare, verrà richiesta una ricerca della rete mobile, se supportata.

setProperties()

Promessa 
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à.

  • Le proprietà da impostare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

startConnect()

Promessa 
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>

    In attesa

    Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.

startDisconnect()

Promessa 
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>

    In attesa

    Le 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