chrome.networking.onc

Descrizione

L'API chrome.networking.onc viene utilizzata per configurare le connessioni di rete (Rete dati, Ethernet, VPN o Wi-Fi). Questa API è disponibile in sessioni kiosk di ChromeOS con avvio automatico.

Le configurazioni delle connessioni di rete vengono specificate in base alla specifica Open Network Configuration (ONC).

NOTA: la maggior parte delle proprietà dei dizionari e dei valori enum utilizza UpperCamelCase per corrispondere alle specifiche ONC anziché la convenzione bottomCamelCase JavaScript.

Autorizzazioni

networking.onc

Disponibilità

Chrome 59 e versioni successive Solo ChromeOS

Tipi

ActivationStateType

Enum

"Attivato"

"Attivazione"

"Non attivato"

"Parzialmente attivato"

CaptivePortalStatus

Enum

"Sconosciuto"

"Offline"

"Online"

"Portale"

"ProxyAuthRequired"

CellularProperties

Proprietà

  • ActivationState

    ActivationStateType facoltativo

    Stato di attivazione dell'account dell'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

    Indica se la rete mobile deve essere connessa automaticamente (quando nel raggio d'azione).

  • Famiglia

    stringa facoltativo

    Famiglia di tecnologia dei dispositivi mobili: CDMA o GSM.

  • FirmwareRevision

    stringa facoltativo

    La revisione del firmware caricata nel modem cellulare.

  • FoundNetworks

    FoundNetworkProperties[] facoltativo

    L'elenco di reti trovate durante la scansione delle reti più recente.

  • 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 del modello del modem cellulare.

  • NetworkTechnology

    stringa facoltativo

    Se il modem è registrato su una rete, viene usata la tecnologia di rete attualmente in uso.

  • PaymentPortal

    PaymentPortal facoltativo

    Portale di pagamento online che l'utente può utilizzare per sottoscrivere o modificare un piano dati mobili.

  • RoamingState

    stringa facoltativo

    Lo stato di roaming del modem cellulare sulla rete attuale.

  • SIMLockStatus

    SIMLockStatus facoltativo

    Lo stato del blocco SIM per le reti famiglia GSM.

  • SIMPresent

    booleano facoltativo

    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 cui rete è attualmente registrato il modem.

  • SignalStrength

    numero facoltativo

    L'intensità del segnale di rete attuale.

  • SupportNetworkScan

    booleano facoltativo

    Se la rete mobile supporta la scansione.

CellularProviderProperties

Proprietà

  • Codice

    stringa

    L'ID della rete mobile è una semplice concatenazione dei codici Centro clienti (Mobile Network Code) e MNC (Mobile Network Code) della rete.

  • Paese

    stringa facoltativo

    Il codice 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 al 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 dell'emittente del certificato. Un certificato deve essere firmato da uno di loro per far corrispondere questo pattern.

  • Oggetto

    IssuerSubjectPattern Facoltativo

    Se impostato, il pattern in base al quale devono essere abbinate le impostazioni del soggetto X.509.

ClientCertificateType

Enum

"Rif"

"Sequenza"

ConnectionStateType

Enum

"Connesso"

"Connessione in corso..."

"Non connesso"

DeviceStateProperties

Proprietà

  • SIMLockStatus

    SIMLockStatus facoltativo

    Chrome 62 e versioni successive .

    Lo stato del blocco della SIM se Tipo = Cellulare e SIMPresent = True.

  • SIMPresent

    booleano facoltativo

    Chrome 62 e versioni successive .

    Imposta lo stato attuale della SIM se il tipo di dispositivo è Rete dati.

  • Scansione in corso

    booleano facoltativo

    Imposta se il dispositivo è attivo. True se il dispositivo è attualmente in scansione.

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

"Attivazione"
Lo stato Attivato è stato richiesto, ma non è stato completato.

"Abilitato"
Il dispositivo è attivato.

"Vietato"
Il dispositivo è vietato.

EAPProperties

Proprietà

  • AnonymousIdentity

    stringa facoltativo

  • IDClientCertPKCS11Id

    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

  • Outer

    stringa facoltativo

    Il tipo EAP esterno. Richiesto dall'ONC, ma non può essere fornito durante 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. Obbligatorio 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à sulla rete.

  • Tecnologia

    stringa

    Tecnologia di accesso utilizzata dalla rete.

GlobalPolicy

Proprietà

  • AllowOnlyPolicyNetworksToAutoconnect

    booleano facoltativo

    Se impostato su true, solo le reti dei criteri possono connettersi automaticamente. Il valore predefinito è false.

  • AllowOnlyPolicyNetworksToConnect

    booleano facoltativo

    Se impostato su true, è possibile connettere solo le reti dei criteri 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, è possibile connettere 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. Non sono consentite connessioni a reti bloccate. 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. Per maggiori dettagli, vedi onc_spec.md.

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

  • IncludedRoutes

    string[] facoltativo

    Chrome 76 e versioni successive .

    Array di blocchi IP in notazione CIDR. Per maggiori dettagli, vedi onc_spec.md.

  • 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 riportato su DHCP.

IPConfigType

Enum

"DHCP"

"Statico"

IssuerSubjectPattern

Proprietà

  • CommonName

    stringa facoltativo

    Se impostato, il valore in base al quale corrispondere al nome comune del soggetto del certificato.

  • Località

    stringa facoltativo

    Se impostato, il valore in base al quale corrispondere alla posizione comune del soggetto del certificato.

  • Organizzazione

    stringa facoltativo

    Se impostato, il valore in base al quale corrispondere alle organizzazioni dell'oggetto del certificato. Almeno un'organizzazione deve corrispondere al valore.

  • OrganizationalUnit

    stringa facoltativo

    Se impostato, il valore in base al quale corrispondere alle unità organizzative del soggetto del certificato. Almeno un'unità organizzativa deve corrispondere al valore.

ManagedBoolean

Proprietà

  • Attivo

    booleano facoltativo

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    booleano facoltativo

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    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 un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del 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 un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    stringa facoltativo

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    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 un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del 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 un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    string[] facoltativo

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    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 un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del 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 un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    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 un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del 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 un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    numero facoltativo

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    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 un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del 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

    ProxySettingsType optional

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se un DevicePolicy per la proprietà esiste e consente la modifica della proprietà (ad esempio il criterio che imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • DevicePolicy

    ProxySettingsType optional

    Il valore della proprietà fornito dai criteri relativi ai dispositivi.

  • Valida

    stringa facoltativo

    La sorgente da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    ProxySettingsType optional

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se un criterio UserPolicy per la proprietà esiste e consente la modifica della proprietà (ovvero il valore della proprietà consigliato per l'impostazione del criterio). Il valore predefinito è false.

  • UserPolicy

    ProxySettingsType optional

    Il valore della proprietà fornito dai criteri relativi agli utenti.

  • UserSetting

    ProxySettingsType optional

    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.

  • CALZINI

    ProxyLocation facoltativo

    Impostazioni per il proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP sicuro.

NetworkConfigProperties

Proprietà

NetworkFilter

Proprietà

  • configurato

    booleano facoltativo

    Se impostato su true, includi 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. Utilizza 0 per nessun limite.

  • networkType

    Tipo di rete

    Il tipo di reti da restituire.

  • visibile

    booleano facoltativo

    Se impostato su true, includi solo reti visibili (connesse fisicamente o nel raggio d'azione). Il valore predefinito è "false".

NetworkProperties

Proprietà

  • Cellulare

    CellularProperties facoltativo

    Per le reti mobili, le proprietà delle reti mobili.

  • Collegabili

    booleano facoltativo

    Se la rete è connettebile.

  • ConnectionState

    ConnectionStateType optional

    Stato attuale della connessione di rete.

  • ErrorState

    stringa facoltativo

    L'ultimo stato di errore di rete registrato.

  • Ethernet

    EthernetProperties facoltativo

    Per le reti Ethernet, vengono indicate 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 semplice 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 di rete.

  • RestrictedConnectivity

    booleano facoltativo

    Per una rete connessa, se la connettività di rete a internet è limitata, ad esempio se la rete è dietro un portale o se la rete mobile non è attiva.

  • 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

    'Nessuna' è in conflitto con la generazione del codice estensione, quindi dobbiamo usare una stringa per "Source" invece di un'enumerazione SourceType.

  • StaticIPConfig

    IPConfigProperties facoltativo

    La configurazione dell'IP statico della rete.

  • TrafficCounterResetTime

    numero facoltativo

    Chrome 125 e versioni successive .

    Data dell'ultima reimpostazione dei contatori del traffico.

  • Il tipo di rete.

  • VPN

    VPNProperties facoltativo

    Per le reti VPN, le proprietà VPN della rete.

  • Wi-Fi

    WiFiProperties facoltativo

    Per le reti Wi-Fi, le proprietà Wi-Fi della rete.

NetworkStateProperties

Proprietà

NetworkType

Enum

"Tutte"

"Rete dati"

"Ethernet"

"Tethering"

"VPN"

"Wireless"

"Wi-Fi"

PaymentPortal

Proprietà

  • Metodo

    stringa

    Il metodo HTTP da utilizzare per il portale di pagamento.

  • PostData

    stringa facoltativo

    I dati pubblicati 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 sono escluse le impostazioni manuali del proxy.

  • Manuale

    ManualProxySettings facoltativo

    Impostazioni manuali del proxy: utilizzate solo per le impostazioni del proxy Manual.

  • PAC

    stringa facoltativo

    URL per il file di configurazione automatica del proxy.

  • Il tipo di impostazioni del proxy.

ProxySettingsType

Enum

"Diretto"

"Manuale"

"PAC"

"WPAD"

SIMLockStatus

Proprietà

  • LockEnabled

    booleano

    Se il blocco SIM è attivo.

  • LockType

    stringa

    Lo stato del blocco 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. Non può essere un'enumerazione a causa di "L2TP-IPSec". Questa opzione è facoltativa per NetworkConfigProperties, che viene passata a setProperties, che può essere utilizzata solo per impostare proprietà specifiche.

VPNStateProperties

Proprietà

WiFiProperties

Proprietà

  • AllowGatewayARPPolling

    booleano facoltativo

    Indica se è consentito il polling ARP del gateway predefinito. Il valore predefinito è true.

  • AutoConnect

    booleano facoltativo

    Indica se la rete Wi-Fi deve essere connessa automaticamente quando è nel raggio d'azione.

  • BSSID

    stringa facoltativo

    Il BSSID del punto di accesso associato.

  • EAP

    EAPProperties facoltativo

    Le proprietà EAP della 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 corrente a cui la rete è connessa. In caso contrario, la frequenza del miglior BSS disponibile.

  • FrequencyList

    numero[] facoltativo

    Contiene tutte le frequenze di funzionamento rilevate di recente per la rete Wi-Fi.

  • HexSSID

    stringa facoltativo

    Copia con codifica esadecimale dell'SSID di rete.

  • HiddenSSID

    booleano facoltativo

    Indica se verrà trasmesso l'SSID della rete.

  • Passphrase

    stringa facoltativo

    Chrome 66 e versioni successive .

    La passphrase per le connessioni WEP/WPA/WPA2. Questa proprietà può solo essere impostata. Le proprietà restituite da getProperties non conterranno questo valore.

  • RoamThreshold

    numero facoltativo

    Deprecato, ignorato.

  • SSID

    stringa facoltativo

    L'SSID della rete.

  • Sicurezza

    stringa facoltativo

    Il tipo di sicurezza di 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 della rete.

Metodi

createNetwork()

Promesso .
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 riuscirà. In caso contrario, restituisce il GUID della nuova rete.

Parametri

  • condiviso

    booleano

    Se true, condividi questa configurazione di rete con altri utenti.

    Questa opzione è esposta solo all'UI web di Chrome.* Quando le app vengono chiamate, 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

Resi

  • Promise<string>

    Chrome 125 e versioni successive .

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

disableNetworkType()

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

Disattiva tutti i dispositivi corrispondenti al tipo di rete specificato. Vedi nota per enableNetworkType.

Parametri

enableNetworkType()

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

Attiva tutti i dispositivi corrispondenti al tipo di rete specificato. Tieni presente che il tipo potrebbe rappresentare più tipi di rete (ad esempio "Wireless").

Parametri

forgetNetwork()

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

Dimentica una configurazione di rete cancellando tutte le proprietà configurate per la rete con GUID networkGuid. Potrebbero essere incluse anche eventuali altre reti con identificatori corrispondenti (ad esempio SSID della rete Wi-Fi e sicurezza). Se questa configurazione non esiste, verrà impostato un errore e l'operazione non riuscirà.

Nelle sessioni kiosk, questo metodo non riuscirà a 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

Resi

  • Promesso<void>

    Chrome 125 e versioni successive .

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

getCaptivePortalStatus()

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

Restituisce lo stato del captive portal per la rete corrispondente a "networkGuid".

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

Resi

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125 e versioni successive .

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

getDeviceStates()

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

Restituisce gli stati dei dispositivi di networking disponibili.

Parametri

Resi

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125 e versioni successive .

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

getGlobalPolicy()

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

Ottiene 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

Resi

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125 e versioni successive .

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

getManagedProperties()

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

Restituisce le proprietà unite della rete con l'ID networkGuid dalle origini: impostazioni utente, impostazioni condivise, criteri 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

Resi

  • Promise&lt;ManagedProperties&gt;

    Chrome 125 e versioni successive .

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

getNetworks()

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

Restituisce un elenco di oggetti di rete con le stesse proprietà fornite da getState. È disponibile un filtro per specificare il tipo di reti restituite e limitare il numero di reti. Le reti vengono ordinate dal sistema in base alla loro priorità. Le reti connesse o connesse sono elencate per prime.

Parametri

Resi

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125 e versioni successive .

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

getProperties()

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

Ottiene 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

Resi

  • Promise&lt;NetworkProperties&gt;

    Chrome 125 e versioni successive .

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

getState()

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

Ottiene le proprietà di sola lettura memorizzate nella cache della rete con ID networkGuid. Questa deve essere una funzione con prestazioni più elevate 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. Per le reti visibili vengono fornite proprietà aggiuntive: 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

Resi

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125 e versioni successive .

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

requestNetworkScan()

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

Richiesta che il sottosistema di rete esegua la scansione di nuove reti e aggiorni l'elenco restituito da getVisibleNetworks. Si tratta solo di una richiesta: il sottosistema di rete può scegliere di ignorarla. Se l'elenco viene aggiornato, verrà attivato l'evento onNetworkListChanged.

Parametri

  • networkType

    NetworkType facoltativo

    Chrome 63 e versioni successive .

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

setProperties()

Promesso .
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 dovrebbero usare invece createNetwork. Nelle sessioni kiosk, la chiamata di questo metodo su una rete condivisa non riuscirà.

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

Resi

  • Promesso<void>

    Chrome 125 e versioni successive .

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

startConnect()

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

Avvia una connessione alla rete con networkGuid.

Parametri

  • networkGuid

    stringa

    Il GUID della rete a cui connettersi.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 125 e versioni successive .

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

startDisconnect()

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

Resi

  • Promesso<void>

    Chrome 125 e versioni successive .

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

Eventi

onDeviceStateListChanged

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

Attivato quando l'elenco dei dispositivi è stato modificato o le proprietà dello stato del dispositivo sono state modificate.

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 è stato modificato. Invia un elenco completo di GUID per tutte le reti attuali.

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 delle reti. 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 quando viene completato un rilevamento del portale per una rete. Invia il GUID della rete e lo stato del captive portal corrispondente.

Parametri