Descripción
La API de chrome.networking.onc
se usa para configurar conexiones de red (datos móviles, Ethernet, VPN o Wi-Fi). Esta API está disponible en las sesiones de kiosco de ChromeOS con inicio automático.
Las configuraciones de conexión de red se especifican de acuerdo con la especificación de Open Network Configuration (ONC).
NOTA: La mayoría de las propiedades del diccionario y los valores de enumeración usan UpperCamelCase para coincidir con la especificación de ONC en lugar de la convención lowerCamelCase de JavaScript.
Permisos
networking.onc
Disponibilidad
Tipos
ActivationStateType
Enum
“Activado”
"Activando"
"NotActivated"
"PartiallyActivated"
CaptivePortalStatus
Enum
"Unknown"
"Sin conexión"
“En línea”
"Portal"
"ProxyAuthRequired"
CellularProperties
Propiedades
-
ActivationState
ActivationStateType opcional
Estado de activación de la cuenta del operador.
-
ActivationType
cadena opcional
Es el tipo de activación de la red móvil.
-
AllowRoaming
booleano opcional
Indica si se permite el roaming en la red.
-
AutoConnect
booleano opcional
Indica si la red móvil debe conectarse automáticamente (cuando está dentro del alcance).
-
Familiar
string opcional
Familia de tecnología de dispositivos celulares:
CDMA
oGSM
. -
FirmwareRevision
string opcional
Es la revisión del firmware cargada en el módem celular.
-
FoundNetworks
FoundNetworkProperties[] opcional
Es la lista de redes encontradas durante la búsqueda de red más reciente.
-
HardwareRevision
cadena opcional
Revisión del hardware del módem celular
-
HomeProvider
CellularProviderProperties opcional
Información sobre el operador que emitió la tarjeta SIM instalada actualmente en el módem.
-
Fabricante
string opcional
El fabricante del módem celular.
-
ModelID
cadena opcional
Es el ID del modelo del módem celular.
-
NetworkTechnology
cadena opcional
Si el módem está registrado en una red, la tecnología de red que se está usando
-
PaymentPortal
PaymentPortal opcional
Portal de pagos en línea que un usuario puede usar para registrarse en un plan de datos móviles o modificarlo.
-
RoamingState
cadena opcional
El estado de roaming del módem celular en la red actual.
-
SIMLockStatus
SIMLockStatus opcional
Es el estado del bloqueo de SIM para las redes de la familia GSM.
-
SIMPresent
booleano opcional
Indica si hay una tarjeta SIM.
-
Análisis
booleano opcional
Chrome 63 y versiones posterioresVerdadero cuando una búsqueda de red móvil está en curso.
-
ServingOperator
CellularProviderProperties opcional
Es la información sobre el operador en cuya red está registrado el módem actualmente.
-
SignalStrength
número opcional
La intensidad de la señal de red actual.
-
SupportNetworkScan
booleano opcional
Indica si la red celular admite el escaneo.
CellularProviderProperties
Propiedades
-
Código
string
El ID de red celular como una concatenación simple del MCC (código de país móvil) y el MNC (código de red móvil) de la red
-
País
string opcional
El código de país de dos letras
-
Nombre
string
El nombre del operador.
CellularStateProperties
Propiedades
-
ActivationState
ActivationStateType opcional
Consulta
CellularProperties.ActivationState
. -
NetworkTechnology
cadena opcional
Consulta
CellularProperties.NetworkTechnology
. -
RoamingState
cadena opcional
Consulta
CellularProperties.RoamingState
. -
SIMPresent
booleano opcional
Consulta
CellularProperties.SIMPresent
. -
SignalStrength
número opcional
Consulta
CellularProperties.SignalStrength
.
CertificatePattern
Propiedades
-
EnrollmentURI
string[] opcional
Es la lista de URIs a los que se puede dirigir al usuario en caso de que no se encuentren certificados que coincidan con este patrón.
-
Emisor
IssuerSubjectPattern opcional
Si se establece, es el patrón con el que se debe hacer coincidir la configuración del emisor X.509.
-
IssuerCARef
string[] opcional
Es la lista de certificados de la AC de la entidad emisora de certificados. Uno de ellos debe firmar un certificado para que coincida con este patrón.
-
Asunto
IssuerSubjectPattern opcional
Si se establece, patrón con el que debe coincidir la configuración del sujeto X.509.
ClientCertificateType
Enum
"Ref"
"Patrón"
ConnectionStateType
Enum
"Conectado"
“Conectándose”
"No conectada"
DeviceStateProperties
Propiedades
-
SIMLockStatus
SIMLockStatus opcional
Chrome 62 y versiones posterioresEs el estado del bloqueo de la SIM si Type = Cellular y SIMPresent = True.
-
SIMPresent
booleano opcional
Chrome 62 y versiones posterioresEstablece el estado de SIM presente si el tipo de dispositivo es celular.
-
Análisis
booleano opcional
Establece si el dispositivo está habilitado. Es verdadero si el dispositivo está escaneando.
-
Estado
El estado actual del dispositivo.
-
Tipo
El tipo de red asociado con el dispositivo (móvil, Ethernet o Wi-Fi)
DeviceStateType
Enum
"Sin inicializar"
El dispositivo está disponible, pero no se inicializó.
“Disabled”
El dispositivo se inicializó, pero no se habilitó.
"Habilitando"
Se solicitó el estado habilitado, pero no se completó.
"Habilitado"
El dispositivo está habilitado.
"Prohibido"
El dispositivo está prohibido.
EAPProperties
Propiedades
-
AnonymousIdentity
cadena opcional
-
ClientCertPKCS11Id
cadena opcional
Chrome 60 y versiones posteriores -
ClientCertPattern
CertificatePattern opcional
-
ClientCertProvisioningProfileId
cadena opcional
Chrome 93 y versiones posteriores -
ClientCertRef
string opcional
-
ClientCertType
-
Identidad
cadena opcional
-
Interna
cadena opcional
-
Externa
string opcional
Es el tipo de EAP externo. Es obligatorio para la ONC, pero es posible que no se proporcione cuando se realiza la traducción desde Shill.
-
Contraseña
cadena opcional
-
SaveCredentials
booleano opcional
-
ServerCAPEMs
string[] opcional
-
ServerCARefs
string[] opcional
-
SubjectMatch
ManagedDOMString opcional
Chrome 60 y versiones posteriores -
UseProactiveKeyCaching
booleano opcional
-
UseSystemCAs
booleano opcional
EthernetProperties
Propiedades
-
Autenticación
cadena opcional
Es la autenticación que usa la red Ethernet. Los valores posibles son
None
y8021X
. -
AutoConnect
booleano opcional
Si la red Ethernet debe conectarse automáticamente.
-
EAP
EAPProperties opcional
Configuración de EAP de la red. Obligatorio para la autenticación 8021X.
EthernetStateProperties
Propiedades
-
Autenticación
string
Consulta
EthernetProperties.Authentication
.
FoundNetworkProperties
Propiedades
-
LongName
cadena opcional
Es el nombre de formato largo del operador de red.
-
NetworkId
string
Es el ID de red.
-
ShortName
cadena opcional
El nombre corto del operador de red.
-
Estado
string
Disponibilidad de la red
-
Tecnología
string
Acceder a la tecnología que usa la red
GlobalPolicy
Propiedades
-
AllowOnlyPolicyNetworksToAutoconnect
booleano opcional
Si es verdadero, solo las redes de políticas pueden conectarse automáticamente. La configuración predeterminada es "false".
-
AllowOnlyPolicyNetworksToConnect
booleano opcional
Si esta preferencia se establece como "true", solo se podrán conectar redes de políticas y no se podrán agregar ni configurar redes nuevas. La configuración predeterminada es "false".
-
AllowOnlyPolicyNetworksToConnectIfAvailable
booleano opcional
Chrome 70 y versiones posterioresSi es verdadera y hay una red administrada disponible en la lista de redes visibles, solo se podrán conectar redes de políticas y no se podrán agregar ni configurar nuevas redes. La configuración predeterminada es "false".
-
BlockedHexSSIDs
string[] opcional
Chrome 86 y versiones posterioresEs la lista de redes bloqueadas. Se prohíben las conexiones a redes bloqueadas. Para desbloquear las redes nuevamente, especifica una configuración de red explícita. La configuración predeterminada es una lista vacía.
IPConfigProperties
Propiedades
-
ExcludedRoutes
string[] opcional
Chrome 76 y versiones posterioresEs un array de bloques de IP en notación CIDR. Consulta onc_spec.md para obtener más información.
-
Puerta de enlace
cadena opcional
Es la dirección de puerta de enlace que se usa para la configuración de IP.
-
IPAddress
string opcional
Es la dirección IP de una conexión. Puede ser una dirección IPv4 o IPv6, según el valor de
Type
. -
IncludedRoutes
string[] opcional
Chrome 76 y versiones posterioresArray de bloques de IP en notación CIDR. Para obtener más información, consulta onc_spec.md.
-
NameServers
string[] opcional
Es un array de direcciones que se usan para los servidores de nombres.
-
RoutingPrefix
número opcional
Es el prefijo de enrutamiento.
-
SearchDomains
string[] opcional
Chrome 76 y versiones posterioresEs un array de cadenas para la resolución de nombres. Consulta onc_spec.md para obtener más información.
-
Tipo
string opcional
Es el tipo de configuración de IP. Puede ser
IPv4
oIPv6
. -
WebProxyAutoDiscoveryUrl
cadena opcional
Es la URL para la detección automática de proxy web, como se informa a través de DHCP.
IPConfigType
Enum
"DHCP"
"Estático"
IssuerSubjectPattern
Propiedades
-
CommonName
cadena opcional
Si se establece, es el valor con el que se debe hacer coincidir el nombre común del sujeto del certificado.
-
Localidad
cadena opcional
Si se establece, es el valor con el que se debe hacer coincidir la ubicación común del sujeto del certificado.
-
Organización
string opcional
Si se establece, es el valor con el que se deben hacer coincidir las organizaciones del sujeto del certificado. Al menos una organización debe coincidir con el valor.
-
OrganizationalUnit
cadena opcional
Si se establece, es el valor con el que se deben hacer coincidir las unidades organizativas del sujeto del certificado. Al menos una unidad organizacional debe coincidir con el valor.
ManagedBoolean
Propiedades
-
Activo
booleano opcional
El valor activo que utiliza actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
booleano opcional
El valor de propiedad proporcionado por la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
booleano opcional
Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
booleano opcional
Es el valor de la propiedad que proporciona la política del usuario.
-
UserSetting
booleano opcional
Es el valor de la propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedCellularProperties
Propiedades
-
ActivationState
ActivationStateType opcional
Consulta
CellularProperties.ActivationState
. -
ActivationType
cadena opcional
Consulta
CellularProperties.ActivationType
. -
AllowRoaming
booleano opcional
Consulta
CellularProperties.AllowRoaming
. -
AutoConnect
ManagedBoolean opcional
Consulta
CellularProperties.AutoConnect
. -
Familiar
cadena opcional
Consulta
CellularProperties.Family
. -
FirmwareRevision
cadena opcional
Consulta
CellularProperties.FirmwareRevision
. -
FoundNetworks
FoundNetworkProperties[] opcional
Consulta
CellularProperties.FoundNetworks
. -
HardwareRevision
cadena opcional
Consulta
CellularProperties.HardwareRevision
. -
HomeProvider
CellularProviderProperties[] opcional
Consulta
CellularProperties.HomeProvider
. -
Fabricante
string opcional
Consulta
CellularProperties.Manufacturer
. -
ModelID
cadena opcional
Consulta
CellularProperties.ModelID
. -
NetworkTechnology
string opcional
Consulta
CellularProperties.NetworkTechnology
. -
PaymentPortal
PaymentPortal opcional
Consulta
CellularProperties.PaymentPortal
. -
RoamingState
cadena opcional
Consulta
CellularProperties.RoamingState
. -
SIMLockStatus
SIMLockStatus opcional
Consulta
CellularProperties.SIMLockStatus
. -
SIMPresent
booleano opcional
Consulta
CellularProperties.SIMPresent
. -
Análisis
booleano opcional
Chrome 63 y versiones posterioresConsulta
CellularProperties.Scanning
. -
ServingOperator
CellularProviderProperties opcional
Consulta
CellularProperties.ServingOperator
. -
SignalStrength
número opcional
Consulta
CellularProperties.SignalStrength
. -
SupportNetworkScan
booleano opcional
Consulta
CellularProperties.SupportNetworkScan
.
ManagedDOMString
Propiedades
-
Activo
string opcional
Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
cadena opcional
Es el valor de la propiedad que proporciona la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
string opcional
Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
cadena opcional
El valor de propiedad proporcionado por la política del usuario.
-
UserSetting
string opcional
El valor de propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedDOMStringList
Propiedades
-
Activo
string[] opcional
Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
string[] opcional
El valor de propiedad proporcionado por la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
string[] opcional
Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
string[] opcional
Es el valor de la propiedad que proporciona la política del usuario.
-
UserSetting
string[] opcional
El valor de propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedEthernetProperties
Propiedades
-
Autenticación
ManagedDOMString opcional
Consulta
EthernetProperties.Authentication
. -
AutoConnect
ManagedBoolean opcional
Consulta
EthernetProperties.AutoConnect
.
ManagedIPConfigProperties
Propiedades
-
Puerta de enlace
ManagedDOMString opcional
Consulta
IPConfigProperties.Gateway
. -
IPAddress
ManagedDOMString opcional
Consulta
IPConfigProperties.IPAddress
. -
NameServers
ManagedDOMStringList opcional
Consulta
IPConfigProperties.NameServers
. -
RoutingPrefix
ManagedLong opcional
Consulta
IPConfigProperties.RoutingPrefix
. -
Tipo
ManagedDOMString opcional
Consulta
IPConfigProperties.Type
. -
WebProxyAutoDiscoveryUrl
ManagedDOMString opcional
ManagedIPConfigType
Propiedades
-
Activo
IPConfigType opcional
Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
IPConfigType opcional
Es el valor de la propiedad que proporciona la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
IPConfigType: Opcional
El valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
IPConfigType opcional
El valor de propiedad proporcionado por la política del usuario.
-
UserSetting
IPConfigType opcional
Es el valor de la propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedLong
Propiedades
-
Activo
número opcional
Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
número opcional
Es el valor de la propiedad que proporciona la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
número opcional
Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
número opcional
Es el valor de la propiedad que proporciona la política del usuario.
-
UserSetting
número opcional
Es el valor de la propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedManualProxySettings
Propiedades
-
FTPProxy
ManagedProxyLocation opcional
Consulta
ManualProxySettings.FTPProxy
. -
HTTPProxy
ManagedProxyLocation opcional
Consulta
ManualProxySettings.HTTPProxy
. -
calcetines
ManagedProxyLocation opcional
Consulta
ManualProxySettings.SOCKS
. -
SecureHTTPProxy
ManagedProxyLocation opcional
Consulta
ManualProxySettings.SecureHTTPProxy
.
ManagedProperties
Propiedades
-
Móvil
ManagedCellularProperties opcional
Consulta
NetworkProperties.Cellular
. -
Conectable
booleano opcional
Consulta
NetworkProperties.Connectable
. -
ConnectionState
ConnectionStateType opcional
Consulta
NetworkProperties.ConnectionState
. -
ErrorState
cadena opcional
Consulta
NetworkProperties.ErrorState
. -
Ethernet
ManagedEthernetProperties opcional
Consulta
NetworkProperties.Ethernet
. -
GUID
string
Consulta
NetworkProperties.GUID
. -
IPAddressConfigType
ManagedIPConfigType opcional
Consulta
NetworkProperties.IPAddressConfigType
. -
IPConfigs
IPConfigProperties[] opcional
Consulta
NetworkProperties.IPConfigs
. -
MacAddress
string opcional
Consulta
NetworkProperties.MacAddress
. -
De uso medido
ManagedBoolean opcional
Chrome 85 y versiones posterioresConsulta
NetworkProperties.Metered
. -
Nombre
ManagedDOMString opcional
Consulta
NetworkProperties.Name
. -
NameServersConfigType
ManagedIPConfigType opcional
Consulta
NetworkProperties.NameServersConfigType
. -
Prioridad
ManagedLong opcional
Consulta
NetworkProperties.Priority
. -
ProxySettings
ManagedProxySettings opcional
Consulta
NetworkProperties.ProxySettings
. -
RestrictedConnectivity
booleano opcional
Consulta
NetworkProperties.RestrictedConnectivity
. -
SavedIPConfig
IPConfigProperties opcional
Consulta
NetworkProperties.SavedIPConfig
. -
Fuente
cadena opcional
Consulta
NetworkProperties.Source
. -
StaticIPConfig
ManagedIPConfigProperties opcional
Consulta
NetworkProperties.StaticIPConfig
. -
TrafficCounterResetTime
número opcional
Chrome 125 y versiones posteriores -
Tipo
Consulta
NetworkProperties.Type
. -
VPN
ManagedVPNProperties opcional
Consulta
NetworkProperties.VPN
. -
Wi-Fi
ManagedWiFiProperties opcional
Consulta
NetworkProperties.WiFi
.
ManagedProxyLocation
Propiedades
-
Host
Consulta
ProxyLocation.Host
. -
Puerto
Consulta
ProxyLocation.Port
.
ManagedProxySettings
Propiedades
-
ExcludeDomains
ManagedDOMStringList opcional
Consulta
ProxySettings.ExcludeDomains
. -
Manual
ManagedManualProxySettings opcional
Consulta
ProxySettings.Manual
. -
Comisión de acción política
ManagedDOMString opcional
Consulta
ProxySettings.PAC
. -
Consulta
ProxySettings.Type
.
ManagedProxySettingsType
Propiedades
-
Activo
ProxySettingsType opcional
Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).
-
DeviceEditable
booleano opcional
Indica si existe una DevicePolicy para la propiedad y si permite que se edite (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es
false
. -
DevicePolicy
ProxySettingsType opcional
Es el valor de la propiedad que proporciona la política de dispositivo.
-
Entrada en vigencia:
string opcional
Es la fuente a partir de la cual se determinó el valor de propiedad efectivo.
-
ProxySettingsType opcional
Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si
DeviceEditiable
estrue
. -
UserEditable
booleano opcional
Indica si existe una UserPolicy para la propiedad y si permite que se edite (es decir, si la política estableció el valor de propiedad recomendado). La configuración predeterminada es
false
. -
UserPolicy
ProxySettingsType opcional
El valor de propiedad proporcionado por la política del usuario.
-
UserSetting
ProxySettingsType opcional
El valor de propiedad que estableció el usuario que accedió. Solo se proporciona si
UserEditable
estrue
.
ManagedThirdPartyVPNProperties
Propiedades
-
ExtensionID
Consulta
ThirdPartyVPNProperties.ExtensionID
. -
ProviderName
cadena opcional
Consulta
ThirdPartyVPNProperties.ProviderName
.
ManagedVPNProperties
Propiedades
-
AutoConnect
ManagedBoolean opcional
Consulta
VPNProperties.AutoConnect
. -
Host
ManagedDOMString opcional
Consulta
VPNProperties.Host
. -
Tipo
ManagedDOMString opcional
Consulta
VPNProperties.Type
.
ManagedWiFiProperties
Propiedades
-
AllowGatewayARPPolling
ManagedBoolean opcional
Consulta
WiFiProperties.AllowGatewayARPPolling
. -
AutoConnect
ManagedBoolean opcional
Consulta
WiFiProperties.AutoConnect
. -
BSSID
cadena opcional
Consulta
WiFiProperties.BSSID
. -
Frecuencia
número opcional
Consulta
WiFiProperties.Frequency
. -
FrequencyList
number[] opcional
Consulta
WiFiProperties.FrequencyList
. -
HexSSID
ManagedDOMString opcional
Consulta
WiFiProperties.HexSSID
. -
HiddenSSID
ManagedBoolean opcional
Consulta
WiFiProperties.HiddenSSID
. -
RoamThreshold
ManagedLong opcional
Dejó de estar disponible y se ignora. Consulta
WiFiProperties.RoamThreshold
. -
SSID
ManagedDOMString opcional
Consulta
WiFiProperties.SSID
. -
Seguridad
Consulta
WiFiProperties.Security
. -
SignalStrength
número opcional
Consulta
WiFiProperties.SignalStrength
.
ManualProxySettings
Propiedades
-
FTPProxy
ProxyLocation opcional
Configuración del proxy de FTP.
-
HTTPProxy
ProxyLocation opcional
Configuración para Proxy HTTP.
-
CALCETINES
ProxyLocation opcional
Configuración del proxy de SOCKS.
-
SecureHTTPProxy
ProxyLocation opcional
Configuración del proxy HTTP seguro
NetworkConfigProperties
Propiedades
-
Móvil
CellularProperties opcional
Consulta
NetworkProperties.Cellular
. -
Ethernet
EthernetProperties opcional
Consulta
NetworkProperties.Ethernet
. -
GUID
cadena opcional
Consulta
NetworkProperties.GUID
. -
IPAddressConfigType
IPConfigType opcional
Consulta
NetworkProperties.IPAddressConfigType
. -
Nombre
string opcional
Consulta
NetworkProperties.Name
. -
NameServersConfigType
IPConfigType opcional
Consulta
NetworkProperties.NameServersConfigType
. -
Prioridad
número opcional
Consulta
NetworkProperties.Priority
. -
Tipo
NetworkType opcional
Consulta
NetworkProperties.Type
. -
VPN
VPNProperties opcional
Consulta
NetworkProperties.VPN
. -
Wi-Fi
WiFiProperties opcional
Consulta
NetworkProperties.WiFi
. -
WiMAX
WiMAXProperties opcional
Obsoleta.
NetworkFilter
Propiedades
-
configurados
booleano opcional
Si esta preferencia se establece como verdadera, solo se incluyen las redes configuradas (guardadas). La configuración predeterminada es “false”.
-
límite
número opcional
Es la cantidad máxima de redes que se mostrarán. Si no se especifica, el valor predeterminado es 1,000. Usa 0 para no tener límite.
-
networkType
Es el tipo de redes que se mostrarán.
-
visible
booleano opcional
Si es verdadero, solo incluye las redes visibles (conectadas físicamente o dentro del alcance). La configuración predeterminada es “false”.
NetworkProperties
Propiedades
-
Móvil
CellularProperties opcional
Para redes móviles, propiedades de red móvil.
-
Conectable
booleano opcional
Si la red se puede conectar.
-
ConnectionState
ConnectionStateType opcional
El estado de conexión actual de la red.
-
ErrorState
cadena opcional
Es el último estado de error de red registrado.
-
Ethernet
EthernetProperties opcional
En el caso de las redes Ethernet, corresponde a las propiedades de red de Ethernet.
-
GUID
string
El GUID de la red
-
IPAddressConfigType
IPConfigType opcional
El tipo de configuración de la dirección IP de la red.
-
IPConfigs
IPConfigProperties[] opcional
La configuración de IP de la red
-
MacAddress
cadena opcional
La dirección MAC de la red
-
De uso medido
booleano opcional
Chrome 85 y versiones posterioresIndica si la red es medida.
-
Nombre
cadena opcional
Un nombre de red fácil de usar.
-
NameServersConfigType
IPConfigType: Opcional
Es el tipo de configuración de IP para los servidores de nombres que usa la red.
-
Prioridad
número opcional
Es la prioridad de la red.
-
ProxySettings
ProxySettings opcional
La configuración de proxy de la red
-
RestrictedConnectivity
booleano opcional
En el caso de una red conectada, si la conectividad de la red a Internet es limitada, p.ej., si la red está detrás de un portal o si una red móvil no está activada.
-
SavedIPConfig
IPConfigProperties opcional
Es la configuración de IP que se recibió del servidor DHCP antes de aplicar la configuración de IP estática.
-
Fuente
cadena opcional
Indica si la red está configurada y cómo. Los valores posibles son:
Device
DevicePolicy
User
UserPolicy
None
"None" entra en conflicto con la generación del código de extensión, por lo que debemos usar una cadena para "Source" en lugar de una enumeración de SourceType.
-
StaticIPConfig
IPConfigProperties opcional
La configuración de IP estática de la red
-
TrafficCounterResetTime
número opcional
Chrome 125 y versiones posterioresCuándo se restablecieron los contadores de tráfico por última vez.
-
Tipo
Es el tipo de red.
-
VPN
VPNProperties opcional
En el caso de las redes VPN, las propiedades de VPN de red.
-
Wi-Fi
WiFiProperties opcional
Para las redes Wi-Fi, las propiedades de Wi-Fi de la red
NetworkStateProperties
Propiedades
-
Móvil
CellularStateProperties opcional
Consulta
NetworkProperties.Cellular
. -
Conectable
booleano opcional
Consulta
NetworkProperties.Connectable
. -
ConnectionState
ConnectionStateType opcional
Consulta
NetworkProperties.ConnectionState
. -
ErrorState
cadena opcional
Consulta
NetworkProperties.ErrorState
. -
Ethernet
EthernetStateProperties opcional
Consulta
NetworkProperties.Ethernet
. -
GUID
string
Consulta
NetworkProperties.GUID
. -
Nombre
string opcional
Consulta
NetworkProperties.Name
. -
Prioridad
número opcional
Consulta
NetworkProperties.Priority
. -
Fuente
cadena opcional
Consulta
NetworkProperties.Source
. -
Tipo
Consulta
NetworkProperties.Type
. -
VPN
VPNStateProperties opcional
Consulta
NetworkProperties.VPN
. -
Wi-Fi
WiFiStateProperties opcional
Consulta
NetworkProperties.WiFi
.
NetworkType
Enum
"Todos"
"Celular"
"Ethernet"
“Conectar”
"VPN"
“Inalámbrico”
"Wi-Fi"
PaymentPortal
Propiedades
-
Método
string
Es el método HTTP que se usará para el portal de pagos.
-
PostData
string opcional
Los datos de publicación que se enviarán al portal de pago. Se ignorará, a menos que
Method
seaPOST
. -
URL
cadena opcional
La URL del portal de pagos.
ProxyLocation
Propiedades
-
Host
string
Es el host de la dirección IP del proxy.
-
Puerto
número
El puerto que se usará para el proxy.
ProxySettings
Propiedades
-
ExcludeDomains
string[] opcional
Son los dominios y hosts para los que se excluye la configuración manual de proxy.
-
Manual
ManualProxySettings opcional
Configuración manual de proxy: Se usa solo para la configuración de proxy de
Manual
. -
Comisión de acción política
cadena opcional
URL del archivo de configuración automática de proxy.
-
Tipo
El tipo de configuración de proxy.
ProxySettingsType
Enum
"Direct"
"Manual"
“PAC”
"WPAD"
SIMLockStatus
Propiedades
-
LockEnabled
booleano
Si está habilitado el bloqueo de SIM.
-
LockType
string
Es el estado del bloqueo de SIM. Los valores posibles son
'sim-pin'
,'sim-puk'
y''
. -
RetriesLeft
número opcional
Cantidad de intentos de bloqueo de PIN permitidos antes de que se requiera el PUK para desbloquear la SIM.
ThirdPartyVPNProperties
Propiedades
-
ExtensionID
string
Es el ID de la extensión del proveedor de VPN de terceros.
-
ProviderName
cadena opcional
Es el nombre del proveedor de VPN.
VPNProperties
Propiedades
-
AutoConnect
booleano opcional
Indica si la red de VPN debe conectarse automáticamente.
-
Host
cadena opcional
El host de la VPN
-
Tipo
cadena opcional
El tipo de VPN. No puede ser una enumeración debido a "L2TP-IPSec". Esto es opcional para NetworkConfigProperties, que se pasa a setProperties, que se puede usar para establecer solo propiedades específicas.
VPNStateProperties
Propiedades
-
Tipo
string
Consulta
VPNProperties.Type
.
WiFiProperties
Propiedades
-
AllowGatewayARPPolling
booleano opcional
Se dejó de usar desde Chrome 131Se quitó en M131. No hay sondeos de ARP activos en este momento.
-
AutoConnect
booleano opcional
Si la red Wi-Fi debe conectarse automáticamente cuando está dentro del alcance.
-
BSSID
cadena opcional
El BSSID del punto de acceso asociado.
-
EAP
EAPProperties opcional
Las propiedades EAP de la red Necesaria para las redes
WEP-8021X
yWPA-EAP
. -
Frecuencia
número opcional
Es la frecuencia de operación del servicio Wi-Fi en MHz. En el caso de las redes conectadas, es la frecuencia actual a la que está conectada la red. De lo contrario, es la frecuencia del mejor BSS disponible.
-
FrequencyList
number[] opcional
Contiene todas las frecuencias de funcionamiento que se vieron recientemente para la red Wi-Fi.
-
HexSSID
cadena opcional
Copia con codificación hexadecimal del SSID de la red.
-
HiddenSSID
booleano opcional
Si se transmitirá el SSID de la red.
-
Frase de contraseña
string opcional
Chrome 66 y versiones posterioresIndica la frase de contraseña para las conexiones WEP, WPA o WPA2. Esta propiedad solo se puede establecer. Las propiedades que devuelve
getProperties
no contendrán este valor. -
RoamThreshold
número opcional
Dejó de estar disponible y se ignora.
-
SSID
cadena opcional
El SSID de la red
-
Seguridad
string opcional
El tipo de seguridad de la red.
-
SignalStrength
número opcional
La intensidad de la señal de la red.
WiFiStateProperties
Propiedades
-
BSSID
cadena opcional
Consulta
WiFiProperties.BSSID
. -
Frecuencia
número opcional
Consulta
WiFiProperties.Frequency
. -
HexSSID
cadena opcional
Chrome 62 y versiones posterioresConsulta
WiFiProperties.HexSSID
. -
SSID
string opcional
Chrome 62 y versiones posterioresConsulta
WiFiProperties.SSID
. -
Seguridad
string
Consulta
WiFiProperties.Security
. -
SignalStrength
número opcional
Consulta
WiFiProperties.SignalStrength
.
WiMAXProperties
Propiedades
-
AutoConnect
booleano opcional
Indica si la red se debe conectar automáticamente.
-
EAP
EAPProperties opcional
Las propiedades EAP de la red
Métodos
createNetwork()
chrome.networking.onc.createNetwork(
shared: boolean,
properties: NetworkConfigProperties,
callback?: function,
)
Crea una nueva configuración de red a partir de propiedades. Si ya existe una red configurada que coincida, se producirá un error. De lo contrario, muestra el GUID de la red nueva.
Parámetros
-
booleano
Si es
true
, comparte esta configuración de red con otros usuarios.Esta opción solo se expone a la IU web de Chrome.* Cuando las apps lo llaman,
false
es el único valor permitido. -
properties
Son las propiedades con las que se configura la red nueva.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: string) => void
-
resultado
string
-
Muestra
-
Promise<string>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
disableNetworkType()
chrome.networking.onc.disableNetworkType(
networkType: NetworkType,
)
Inhabilita todos los dispositivos que coincidan con el tipo de red especificado. Consulta la nota de enableNetworkType
.
Parámetros
-
networkType
Es el tipo de red que se inhabilitará.
enableNetworkType()
chrome.networking.onc.enableNetworkType(
networkType: NetworkType,
)
Habilita todos los dispositivos que coincidan con el tipo de red especificado. Ten en cuenta que el tipo puede representar varios tipos de red (p.ej., “Inalámbrico”).
Parámetros
-
networkType
El tipo de red que se habilitará.
forgetNetwork()
chrome.networking.onc.forgetNetwork(
networkGuid: string,
callback?: function,
)
Borra las propiedades configuradas de la red con el GUID networkGuid
para olvidar una configuración de red. Esto también puede incluir cualquier otra red con identificadores coincidentes (p.ej., SSID y seguridad de Wi-Fi). Si no existe tal configuración, se establecerá un error y la operación fallará.
En las sesiones de kiosco, este método no podrá olvidar las configuraciones de red compartidas.
Parámetros
-
networkGuid
string
Es el GUID de la red que se olvidará.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promise<void>
Chrome 125 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getCaptivePortalStatus()
chrome.networking.onc.getCaptivePortalStatus(
networkGuid: string,
callback?: function,
)
Muestra el estado del portal cautivo de la red que coincide con "networkGuid".
Parámetros
-
networkGuid
string
El GUID de la red para el que se obtendrá el estado del portal cautivo.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: CaptivePortalStatus) => void
-
resultado
-
Muestra
-
Promise<CaptivePortalStatus>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
getDeviceStates()
chrome.networking.onc.getDeviceStates(
callback?: function,
)
Muestra los estados de los dispositivos de red disponibles.
Parámetros
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: DeviceStateProperties[]) => void
-
resultado
-
Muestra
-
Promise<DeviceStateProperties[]>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
getGlobalPolicy()
chrome.networking.onc.getGlobalPolicy(
callback?: function,
)
Obtiene las propiedades de la política global. No se espera que estas propiedades cambien durante una sesión.
Parámetros
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: GlobalPolicy) => void
-
resultado
-
Muestra
-
Promise<GlobalPolicy>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
getManagedProperties()
chrome.networking.onc.getManagedProperties(
networkGuid: string,
callback?: function,
)
Obtiene las propiedades combinadas de la red con el ID networkGuid de las fuentes: configuración del usuario, configuración compartida, política del usuario, política de dispositivo y configuración actualmente activa.
Parámetros
-
networkGuid
string
El GUID de la red para la que se obtendrán propiedades.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: ManagedProperties) => void
-
resultado
-
Muestra
-
Promesa<ManagedProperties>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
getNetworks()
chrome.networking.onc.getNetworks(
filter: NetworkFilter,
callback?: function,
)
Muestra una lista de objetos de red con las mismas propiedades que proporciona getState
. Se proporciona un filtro para especificar el tipo de redes que se muestran y limitar su cantidad. El sistema ordena las redes según su prioridad, y las redes conectadas o en proceso de conexión aparecen primero.
Parámetros
-
filter
Describe qué redes se deben mostrar.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: NetworkStateProperties[]) => void
-
resultado
-
Muestra
-
Promise<NetworkStateProperties[]>
Chrome 125 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getProperties()
chrome.networking.onc.getProperties(
networkGuid: string,
callback?: function,
)
Obtiene todas las propiedades de la red con el ID networkGuid. Incluye todas las propiedades de la red (valores de solo lectura y de lectura y escritura).
Parámetros
-
networkGuid
string
El GUID de la red para la que se obtendrán propiedades.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: NetworkProperties) => void
-
resultado
-
Muestra
-
Promise<NetworkProperties>
Chrome 125 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getState()
chrome.networking.onc.getState(
networkGuid: string,
callback?: function,
)
Obtiene las propiedades de solo lectura almacenadas en caché de la red con el ID networkGuid. Esta es una función de mayor rendimiento que getProperties
, que requiere un viaje de ida y vuelta para consultar el subsistema de red. Se muestran las siguientes propiedades para todas las redes: GUID, Type, Name, WiFi.Security. Se proporcionan propiedades adicionales para las redes visibles: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.
Parámetros
-
networkGuid
string
El GUID de la red para la que se obtendrán propiedades.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: NetworkStateProperties) => void
-
resultado
-
Muestra
-
Promise<NetworkStateProperties>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
requestNetworkScan()
chrome.networking.onc.requestNetworkScan(
networkType?: NetworkType,
)
Solicita que el subsistema de red escanee redes nuevas y actualice la lista que muestra getVisibleNetworks
. Esto es solo una solicitud: el subsistema de red puede optar por ignorarla. Si se actualiza la lista, se activará el evento onNetworkListChanged
.
Parámetros
-
networkType
NetworkType opcional
Chrome 63 y versiones posterioresSi se proporciona, solicita un análisis específico del tipo. En el caso de la red móvil, se solicitará un escaneo de red móvil si es compatible.
setProperties()
chrome.networking.onc.setProperties(
networkGuid: string,
properties: NetworkConfigProperties,
callback?: function,
)
Establece las propiedades de la red con el ID networkGuid
. Esto solo es válido para las redes configuradas (Source != None). En su lugar, las redes visibles no configuradas deben usar createNetwork
. En las sesiones de kiosco, no se podrá llamar a este método en una red compartida.
Parámetros
-
networkGuid
string
Es el GUID de la red para la que se establecerán las propiedades.
-
properties
Las propiedades que se deben establecer.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promise<void>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
startConnect()
chrome.networking.onc.startConnect(
networkGuid: string,
callback?: function,
)
Inicia una conexión a la red con networkGuid.
Parámetros
-
networkGuid
string
El GUID de la red a la que te conectarás.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promise<void>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
startDisconnect()
chrome.networking.onc.startDisconnect(
networkGuid: string,
callback?: function,
)
Inicia una desconexión de la red con networkGuid.
Parámetros
-
networkGuid
string
Es el GUID de la red de la que se desconecta el dispositivo.
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Muestra
-
Promise<void>
Chrome 125 y versiones posterioresLas promesas solo se admiten para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.
Eventos
onDeviceStateListChanged
chrome.networking.onc.onDeviceStateListChanged.addListener(
callback: function,
)
Se activa cuando cambia la lista de dispositivos o alguna propiedad del estado del dispositivo.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:() => void
onNetworkListChanged
chrome.networking.onc.onNetworkListChanged.addListener(
callback: function,
)
Se activa cuando cambia la lista de redes. Envía una lista completa de los GUID de todas las redes actuales.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(changes: string[]) => void
-
Cambios
string[]
-
onNetworksChanged
chrome.networking.onc.onNetworksChanged.addListener(
callback: function,
)
Se activa cuando cambian las propiedades en cualquiera de las redes. Envía una lista de GUID para las redes cuyas propiedades cambiaron.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(changes: string[]) => void
-
Cambios
string[]
-
onPortalDetectionCompleted
chrome.networking.onc.onPortalDetectionCompleted.addListener(
callback: function,
)
Se activa cuando se completa la detección de portal de una red. Envía el GUID de la red y el estado del portal cautivo correspondiente.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(networkGuid: string, status: CaptivePortalStatus) => void
-
networkGuid
string
-
estado
-