roNetworkConfiguration

73 min

este objeto proporciona varios métodos para configurar las interfaces de red en un reproductor brightsign el equivalente en javascript es configuracióndered docid qpnvwgjt 7xggv l0vna (consulte guía de migración de brightscript javascript docid\ imtbd2lffaoroxiergc2a para ver los métodos equivalentes) creación de objetos el objeto ronetworkconfiguration se crea con un único parámetro createobject("ronetworkconfiguration", network interface as dynamic) el parámetro network interface puede ser cualquiera de los siguientes 0 o "eth0" el puerto ethernet en el reproductor brightsign "eth1" el puerto ethernet de “control” en reproductores que tienen uno tenga en cuenta que el puerto no está habilitado de forma predeterminada y debe habilitarse explícitamente (lo que se puede hacer desde el prompt de shell de brightsign, javascript o brightscript) 1 o "wlan0" el wifi interno 2 o "ppp0" un módem conectado "usb0" , "usb1" , etc interfaces ethernet usb si la network interface se especifica como un entero, la interfaz debe existir actualmente en el reproductor; de lo contrario, la función de creación de objetos devolverá inválido por el contrario, especificar la network interface como una cadena le permite crear una instancia de ronetworkconfiguration para una interfaz que actualmente no está presente en el reproductor la interfaz de red puede configurarse como una vlan utilizando el siguiente formato de cadena "\[parent interface] \[vlan id]" (p ej , "eth0 42" ) una vez que se configuran las interfaces vlan, deben habilitarse en la interfaz de red principal (p ej , "eth0") usando el método setvlanids() las interfaces vlan usan dhcp de forma predeterminada solo son compatibles con reproductores series 4 (xtx44, xdx34, hdx24, ls424) y series 3 (xtx43, xdx33, hdx23, ls423, ho523) consulte también métricas de enrutamiento predeterminadas docid 0jdtagrv4albwlyfjnj45 ejemplo n6 = createobject("ronetworkconfiguration", "eth0 6") algunas de las siguientes configuraciones son específicas de la interfaz de red, mientras que otras son utilizadas por el host de brightsign para todas las interfaces de red ifnetworkconfiguration \(configuración de la interfaz de red)\ \estas configuraciones se aplican a la interfaz pasada a \ createobject() apply() as boolean aplica los cambios solicitados a la interfaz de red este método devuelve falso si los cambios no pudieron aplicarse a la interfaz de red, aunque los cambios realizados usando métodos "set" y "reset" se conservarán durante futuros reinicios incluso si aplicar() falla la configuración puede tardar varios segundos en completarse los métodos "set" y "reset" no surten efecto hasta que se llama a aplicar() setclientidentifier(a as string) as boolean establece el identificador del cliente dhcp getclientidentifier() as string devuelve el identificador del cliente dhcp setinboundshaperrate(rate as integer) as boolean establece el límite de ancho de banda para el tráfico entrante en bits por segundo y afecta a todo el tráfico en la interfaz de red para el límite de ancho de banda predeterminado, pase 1 al método; para ningún límite de ancho de banda, pase 0 (aunque estas dos configuraciones son funcionalmente iguales) deberá llamar a aplicar() para que esta configuración surta efecto, y cambiar esta configuración en cualquier momento provocará que la interfaz de red se desactive y se reinicialice setmtu(mtu as integer) as boolean establece la unidad máxima de transmisión (mtu) para la interfaz de red en bytes actualmente, la configuración de mtu no se devuelve cuando se llama al método getcurrentconfig() setroutingmetric(a as integer) as boolean configura la métrica para la puerta de enlace predeterminada en la interfaz de red actual las rutas con métricas más bajas tienen prioridad sobre las rutas con métricas más altas esta función devuelve verdadero si se ejecuta correctamente setdhcp() as boolean (interface) habilita dhcp y desactiva todas las demás configuraciones esta función devuelve verdadero si se ejecuta correctamente setenabledprotocols(protocols as roarray) as boolean habilita o deshabilita la compatibilidad con ipv4/ipv6 en una interfaz de red de forma predeterminada, ambas versiones del protocolo son compatibles, y la configuración de la red local determina qué versión utiliza la interfaz este método le permite restringir la compatibilidad a una sola versión de ip la matriz pasada a este método puede tener los siguientes valores de cadena "ipv4" o "ipv6" si la matriz contiene ambos valores, ambos protocolos serán compatibles; si no contiene ninguno, la interfaz de red se activará pero no proporcionará conectividad este método devuelve verdadero si se ejecuta correctamente y falso si falla; utilice el método getfailurereason() para obtener más información en caso de error ejemplo ' disable ipv6 and leave ipv4 enabled n1=createobject("ronetworkconfiguration", 1) print n1 setenabledprotocols(\["ipv4"]) print n1 apply() getenabledprotocols() as roarray devuelve las versiones de ip habilitadas en la interfaz la matriz puede contener los valores de cadena "ipv4" y "ipv6" setip4address(ip as string) as boolean (interface) setip4netmask(netmask as string) as boolean (interface) setip4broadcast(broadcast as string) as boolean (interface) setip4gateway(gateway as string) as boolean (interface) establece la configuración ipv4 de la interfaz todos los valores deben especificarse explícitamente a diferencia del comando shell ifconfig , no hay inferencia automática el parámetro es una cadena decimal punteada de cuatro partes (es decir, "192 168 1 2" o similar) devuelve verdadero si se ejecuta correctamente ejemplo nc = createobject("ronetworkconfiguration",0) nc setip4address("192 168 1 42") nc setip4netmask("255 255 255 0") nc setip4broadcast("192 168 1 255") nc setip4gateway("192 168 1 1") setvlanids(vlan ids as roarray) as boolean habilita los id de vlan especificados (y solo esos id) en la interfaz de red (las interfaces vlan deben configurarse primero) este método acepta una matriz de enteros la interfaz física ( eth0 en el ejemplo) está deshabilitada de forma predeterminada cuando las vlan están habilitadas para usar tanto la interfaz física (es decir, sin etiquetas vlan) como las vlan, los usuarios deben especificar un id de vlan de cero en la matriz al llamar a setvlanids ejemplo ' configure the vlans first use defaults for vlan6 n6=createobject("ronetworkconfiguration", "eth0 6") print n6 resetinterfacesettings() print n6 apply() ' use defaults for vlan11 n11=createobject("ronetworkconfiguration", "eth0 11") print n11 resetinterfacesettings() print n11 apply() ' use static ip for vlan15 n15=createobject("ronetworkconfiguration", "eth0 15") print n15 setip4address("192 168 15 100") print n15 setip4netmask("255 255 255 0") print n15 apply() ' now enable vlans 6, 11 and 15 on eth0 n0=createobject("ronetworkconfiguration", "eth0") print n0 setvlanids(\[6, 11, 15]) print n0 apply() la configuración de vlan es persistente, incluso cuando vlan no está habilitada si utiliza el método setvlanids() para eliminar y luego agregar id de vlan, volverán con la configuración anterior de forma predeterminada puede utilizar el método resetinterfacesettings() para eliminar cualquier configuración anterior setwifiessid(essid as string) as boolean configura el essid wifi de la red inalámbrica a la que se conectará el reproductor este método devuelve verdadero si se ejecuta correctamente getwifiessid() as string recupera el essid wifi configurado, incluso si el reproductor no está conectado actualmente a esa red inalámbrica utilice el valor getcurrentconfig() wifi essid para recuperar el essid de la red inalámbrica a la que el reproductor está conectado actualmente setwifipassphrase(passphrase as string) as boolean configura la frase de contraseña o clave para la red inalámbrica este método acepta una frase de contraseña en texto plano devuelve verdadero si la frase de contraseña se establece correctamente setwifipassphraseandobfuscate(a as string) as string configura la frase de contraseña o clave para la red inalámbrica este método acepta una frase de contraseña en texto plano y devuelve el resultado ofuscado si no se establece la frase de contraseña, se devuelve una cadena vacía setobfuscatedwifipassphrase(password as string) as boolean configura la frase de contraseña o clave para la red inalámbrica este método acepta una frase de contraseña que ha sido ofuscada usando un secreto compartido devuelve verdadero si la contraseña se configura correctamente contacte con support\@brightsign biz mailto\ support\@brightsign biz para obtener más información sobre cómo generar una clave para la ofuscación y almacenarla en el reproductor setwififrequencies(frequencies as string) as boolean establece frecuencias wifi válidas en el rango especificado admite 2ghz, 5ghz o una lista de frecuencias escritas en mhz("2412 2417") devuelve verdadero si la frecuencia se configura correctamente setwifiaccesspointmode(enable as boolean) as boolean habilita o deshabilita el modo de punto de acceso wifi pasar verdadero a este método indica al reproductor que actúe como un punto de acceso inalámbrico, que utiliza el essid y la frase de contraseña configurados con los métodos setwifiessid() y setwifipassphrase() (o setobfuscatedwifipassphrase() ) si se ha configurado una frase de contraseña, el punto de acceso inalámbrico utilizará autenticación wpa2; de lo contrario, no utilizará autenticación este método devuelve verdadero en caso de éxito y falso en caso de error; use el método getfailurereason() para obtener más información en caso de error el modo de punto de acceso wifi debe utilizarse solo para configuración ofrece un servidor dhcp mínimo, pero no proporciona servidores dns ni enrutamiento a ethernet recomendamos asignar una dirección ip estática a la interfaz inalámbrica, aunque esto no es impuesto por el firmware setwifiaccesspointhidden(bool hidden) si hidden es true, el ssid queda oculto; si es false, será visible el valor predeterminado es no oculto, que era el comportamiento anterior el modo de punto de acceso wifi no está disponible en series 2 (4kx42, xdx32, hdx22) ni en modelos anteriores setwifiaccesspointfrequencymhz(frequency as integer) as boolean establece la frecuencia https //en wikipedia org/wiki/list of wlan channels del punto de acceso inalámbrico (en mhz) este método devuelve verdadero en caso de éxito y falso en caso de error; use el método getfailurereason() para obtener más información en caso de error los siguientes métodos configurarwifi se utilizan para configurar wpa enterprise con eap tls setwifiidentity(identity as string) as boolean establece la identidad radius en el modo eap tls, la identidad se obtendrá del certificado del cliente si no se llama a este método (se utilizará "subjectaltname" si está presente; de lo contrario, se utiliza "commonname") en el modo eap peap/mschap, se debe llamar a este método para establecer la identidad setwifieaptlsoptions(options as string) as boolean establece opciones específicas de eap actualmente, este método puede utilizarse para habilitar o deshabilitar la compatibilidad con md5 ("md5=enable" o "md5=disable") y para establecer una identidad anónima para configuraciones eap peap/mschap ("anonymous identity=anon\@brightsign biz") se pueden establecer múltiples parámetros con una lista separada por espacios para borrar configuraciones anteriores, pase una cadena vacía a este método setwificacertificates(certificates as dynamic) as boolean establece el archivo de certificado ca para eap tls (los certificados también pueden enviarse desde un peer eap) los datos del certificado pueden especificarse como un robytearray de datos base64 (para formatos de archivo cer , pfx o p12 ) o un rostring (para el formato de archivo pem ) los formatos binarios compatibles son asn 1 der (para certificados y claves separados) y pkcs#12 (para un único archivo que puede contener tanto certificados como claves) el formato de texto compatible es pem setwificlientcertificate(certificate as dynamic) as boolean establece el certificado de cliente para eap tls los datos del certificado pueden especificarse como un robytearray de datos base64 o un rostring setwifiprivatekey(key as dynamic) as boolean establece la clave privada para autenticación los datos del certificado pueden especificarse como un robytearray de datos base64 o un rostring si la clave privada está protegida por contraseña, use el método setwifipassphrase() para establecer la contraseña si el certificado de cliente y la clave privada asociada están en el mismo archivo pkcs#12, el contenido del archivo debe especificarse usando el método setwifiprivatekey() y el valor de setwificlientcertificate() debe dejarse vacío setwifisecuritymode(mode as string) as boolean establece el método de cifrado wifi de forma predeterminada, se permiten tanto el cifrado wpa (tkip) como wpa2 (ccmp) este método acepta una lista separada por espacios, sin distinción entre mayúsculas y minúsculas, que puede incluir valores "tkip" o "ccmp" pasar una cadena vacía establece el modo predeterminado si se permiten tanto ccmp como tkip, ccmp siempre tiene prioridad configuredhcpserver(config as roassociativearray) as boolean configura un servidor dhcp en el puerto ethernet o en el punto de acceso inalámbrico este método acepta un array asociativo con los siguientes parámetros ip4 start \string\ \required\ el inicio del rango de direcciones ip ofrecidas ip4 end \string\ \required\ el final del rango de direcciones ip ofrecidas name servers \roarray\ un array de cadenas que contiene las direcciones ipv4 de los servidores de nombres (las direcciones ipv6 actualmente no son compatibles) dominio \string\ el sufijo de dominio que usarán los clientes ip4 gateway \string\ la dirección ipv4 de la puerta de enlace que usarán los clientes para deshabilitar el servidor dhcp, pase un array asociativo vacío ( {} ) a este método este método devuelve verdadero en caso de éxito y falso en caso de error; use el método getfailurereason() para obtener información en caso de error la información de arrendamiento dhcp puede verse accediendo a cualquiera de las siguientes direcciones ip mediante un navegador web en la red local http //\<brightsign ip>/dhcp server html o http //\<brightsign ip>/dhcp server txt setdomain(domain as string) as boolean (host) establece el nombre de dominio del dispositivo este se añadirá a los nombres para calificarlos completamente, aunque no es necesario llamar a este método este método devuelve verdadero en caso de éxito ejemplo nc setdomain("brightsign biz") setdnsservers(servers as roarray) as boolean (host) establece la lista de servidores dns si no había servidores dns cuando se creó el objeto este método acepta un array de cadenas, cada una de las cuales contiene la dirección ip en formato dotted quad de un servidor dns, y devuelve verdadero en caso de éxito actualmente hay un máximo de tres servidores; el método devolverá falso si intenta añadir más de tres servidores para borrar la lista de servidores dns, llame a setdnsservers(\[]) adddnsserver(server as string) as boolean (host) añade otro servidor dns a la lista si no había servidores dns cuando se creó el objeto este método acepta la dirección ip en formato dotted quad de un servidor dns como una cadena y devuelve verdadero en caso de éxito actualmente hay un máximo de tres servidores; el método devolverá falso si intenta añadir más de tres servidores enableleds(enable as boolean) as boolean habilita o deshabilita el led de actividad ethernet (es decir, el parpadeo durante el comportamiento de enlace y actividad) el led ethernet está habilitado de forma predeterminada los cambios en esta configuración no persisten tras reiniciar este método devuelve verdadero en caso de éxito y falso en caso de error tenga en cuenta que este método no está disponible en los modelos hdx10, hdx20 y lsx22 resetinterfacesettings() as boolean borra todas las configuraciones específicas de la interfaz (por ejemplo, la dirección ip y la puerta de enlace predeterminada) este método es ideal para restablecer una interfaz a un estado vacío conocido antes de configurar ajustes específicos getfailurereason() as string devuelve información adicional cuando una función miembro devuelve falso testinterface() as object realiza varias pruebas en la interfaz de red para determinar si parece estar funcionando correctamente informa los resultados mediante un array asociativo que contiene los siguientes miembros valor tipo descripción ok boolean este valor es verdadero si las pruebas no encuentran problemas, o falso si se identificó al menos un problema diagnosis string un diagnóstico de una sola línea del primer problema identificado en la interfaz de red log roarray de cadenas un registro completo de todas las pruebas realizadas y sus resultados setdialupinitstring(cmds as string) as boolean especifique la cadena de inicialización, si corresponde, requerida para configurar el módem celular instalado para operación de datos normalmente tendría la forma at+cgdcont=1,"ip","myapn" donde myapn es la cadena apn especificada por el operador de red consulte a su proveedor de módem y operador de red para obtener orientación adicional setdialupnumber(number as string) as boolean especifique el número de teléfono que debe “marcarse” para establecer una conexión de datos a través de la interfaz celular, normalmente 99# consulte a su proveedor de módem para obtener orientación adicional setdialupuser(user as string) as boolean setdialuppassword(password as string) as boolean especifique las credenciales pap/chap, si corresponde, requeridas para establecer una conexión de datos celular en la mayoría de los casos no son necesarias consulte a su operador de red para obtener orientación \ifnetworkconfiguration (configuración del host)\ \estas configuraciones se aplican globalmente sin importar qué interfaz se haya pasado a \ createobject() setupdws(settings as roassociativearray) as boolean configura el diagnostic web server (dws) este método devuelve verdadero si se requiere un reinicio para que los cambios surtan efecto devolverá falso si no se requiere un reinicio o si el método falló; el método getfailurereason() devuelve una cadena no vacía en caso de fallo \el local dws (ldws) está deshabilitado de forma predeterminada en bos 9 0 218 en la rama 9 0, y en bos 9 1 75 en la rama 9 1 \ \para habilitar el ldws, consulte en versiones anteriores de bos, el ldws está habilitado de forma predeterminada\ en el puerto 80, con el número de serie del reproductor como contraseña las configuraciones para el ld \ws se especifican en un arreglo asociativo estas propiedades se escriben en el registro y persisten después del reinicio \ puerto el número de puerto del ldws, ubicado en la dirección ip del reproductor configurar este valor en 0 deshabilitará el ldws, mientras que configurarlo en "default" hará que el ldws sea accesible en el puerto predeterminado (80) contraseña una contraseña ofuscada para el ldws este método utiliza autenticación de acceso digest especificar este parámetro sin configurar un número de puerto hará que el ldws sea accesible en el puerto predeterminado abrir una contraseña no ofuscada para el ldws este método utiliza autenticación de acceso digest el puerto predeterminado es 80 especificar este parámetro sin configurar un número de puerto hará que el ldws sea accesible en el puerto predeterminado especificar este parámetro en el arreglo asociativo con una cadena vacía equivale a habilitar el ldws sin protección por contraseña básico un indicador que señala si se debe usar autenticación básica o no establecer este parámetro en verdadero permite validar la contraseña establecida con el parámetro abrir mediante autenticación básica, en lugar de autenticación de acceso digest esta opción permite compatibilidad con versiones anteriores en plataformas antiguas; la mayoría, si no todos, los navegadores modernos requieren que la autenticación básica esté deshabilitada para comunicarse con el ldws el nombre de usuario es "admin" para todas las configuraciones de autenticación getrecoveryurl() as string devuelve la url de recuperación actual, que se almacena en la entrada "ru" de la sección del registro docid\ zkg2it0mwzhiyugeupuib si la url de recuperación se establece mediante la opción 43 de dhcp, tendrá prioridad sobre la entrada de registro "ru" flushdnscache() vacía la caché dns del reproductor este método está disponible en brightsign os 8 3 32 y versiones posteriores tenga en cuenta que ciertos objetos (como rourltransfer) pueden continuar usando los resultados antiguos durante un breve período después de la versión os 8 3 32 para usar este método nc = createobject("ronetworkconfiguration", 0) if not nc flushdnscache() then print "flush dns cache failed "; nc getfailurereason() end if resethostsettings() as boolean borra todas las configuraciones del host (es decir, configuraciones que no tienen en cuenta el número de interfaz y que no afectan la interfaz de red especificada; por ejemplo, el servidor de hora) setloginpassword(password as string) as boolean especifica una contraseña de inicio de sesión para la conexión ssh (si ssh se ha habilitado en el registro) este método acepta una contraseña en texto plano cuando un cliente ssh reciente intenta conectarse al sshd en un reproductor brightsign, la conexión debe especificar los algoritmos de clave de host que se probarán; de lo contrario, el reproductor no encontrará un algoritmo compatible “ssh o hostkeyalgorithms=ssh rsa,ssh dss brightsign\@172 22 200 74” ofrece una lista de posibles claves de host setobfuscatedloginpassword(password as string) as boolean especifica una contraseña de inicio de sesión para la conexión ssh (si ssh se ha habilitado en el registro) este método acepta una contraseña que ha sido ofuscada usando un secreto compartido póngase en contacto con support\@brightsign biz mailto\ support\@brightsign biz para obtener más información sobre cómo generar una clave para la ofuscación y almacenarla en el reproductor setforwardingpolicy(parameters as roassociativearray) as boolean configura la política de reenvío global del host (este método se aplica a todas las interfaces de red, sin importar en qué instancia de ronetworkconfiguration se llame) el valor de retorno es verdadero en caso de éxito o falso en caso de error este método acepta un arreglo asociativo con los siguientes parámetros forwarding enabled \boolean\ (obligatorio) un indicador que habilita o deshabilita el reenvío ip reenvío activado debe especificarse como verdadero o falso si forwarding enabled es falso , no se realiza ningún reenvío ip este es el valor predeterminado y coincide con el comportamiento anterior nat enabled \boolean\ (obligatorio) un indicador que habilita o deshabilita la traducción de direcciones con reenvío ip si forwarding enabled es verdadero , nat enabled debe especificarse como verdadero o falso si forwarding enabled es verdadero y nat enabled es falso , los datagramas ip se reenvían entre todas las interfaces y no se realiza ninguna traducción de direcciones si forwarding enabled es verdadero y nat enabled es verdadero , los datagramas ip se reenvían entre todas las interfaces, pero snat se aplica a cualquier datagrama que se envíe fuera de una interfaz "upstream" para este propósito, una interfaz "upstream" es cualquiera en la que se establece una ruta predeterminada tenga en cuenta que puede haber más de una interfaz de este tipo los datagramas destinados a una interfaz que no tiene una ruta predeterminada se reenvían sin nat tenga en cuenta que la política de reenvío es una configuración de todo el host y no hace ninguna diferencia qué interfaz se seleccionó cuando el objeto ronetworkconfiguration fue creado settimeserver(time server as string) as boolean (host) establece el servidor de hora predeterminado, que es "time brightsignnetwork com" puede deshabilitar el uso de ntp llamando a settimeserver("") puede usar la sintaxis de url para especificar que el reproductor use un servidor http o https para sincronizar el reloj las siguientes son direcciones válidas de servidores de hora http //time brightsignnetwork com/ https //time brightsignnetwork com/ ntp\ //time brightsignnetwork com/ time brightsignnetwork com las dos últimas direcciones son equivalentes gettimeserver() as string recupera el servidor de hora (host) actualmente en uso settimeserverintervalseconds(interval in seconds as integer) as boolean especifica con qué frecuencia el reproductor debe comunicarse con el servidor de hora y ajustar su reloj el intervalo predeterminado es de 12 horas; pasar un valor de 0 especifica el intervalo predeterminado el intervalo mínimo permitido es de 120 segundos gettimeserverintervalseconds() as integer devuelve el intervalo actual para la renovación del servidor de hora (en segundos) sethostname(name as string) as boolean (host) establece el nombre de host del dispositivo si no se ha establecido explícitamente ningún nombre de host, entonces se genera automáticamente un nombre de host basado en el número de serie del dispositivo pasar una cadena vacía a este método restablece el nombre de host del dispositivo a su valor generado automáticamente gethostname() as string (host) recupera el nombre de host actualmente en uso setproxy(proxy as string) as boolean (host) establece el nombre o la dirección del servidor proxy utilizado para solicitudes http, https y ftp la cadena del proxy debe tener el formato "http //user\ password\@hostname\ port" el hostname puede contener hasta cuatro caracteres " "; cada carácter " " puede utilizarse para reemplazar un octeto de la dirección ip actual por ejemplo, si la dirección ip es actualmente 192 168 1 2 y el proxy está configurado como "proxy ", entonces el reproductor intentará usar un proxy llamado "proxy 192 168" los siguientes caracteres deben codificarse con porcentaje para el nombre de usuario y la contraseña spc %20 " %22 # %23 % %25 / %2f < %3c > %3e ? %3f @ %40 \[ %5b \ %5c ] %5d ^ %5e ` %60 { %7b | %7c } %7d getproxy() as string (host) devuelve el nombre o la dirección del servidor proxy setproxybypass(hostnames as array) as boolean exime a los hosts especificados de la configuración del proxy el array pasado debe constar de uno o más nombres de host el reproductor intentará acceder a los hosts especificados directamente en lugar de usar el proxy que se ha especificado con el método setproxy() por ejemplo, el nombre de host "http //example com " eximiría a "http //example com ", "http //example com 80 " y "http //www example com " de la configuración del proxy getproxybypass() as roarray devuelve un array de nombres de host que se han eximido de la configuración de proxy mediante el método setproxybypass() testinternetconnectivity() as object realiza varias pruebas en la conexión a internet (a través de cualquier interfaz de red disponible, no necesariamente la especificada cuando se creó el objeto ronetworkconfiguration ) para determinar si parece estar funcionando correctamente informa los resultados mediante un array asociativo que contiene los siguientes miembros valor tipo descripción ok boolean este valor es verdadero si las pruebas no encuentran problemas, o falso si se identificó al menos un problema diagnosis string un diagnóstico en una sola línea del primer problema identificado con la conexión a internet log roarray de strings un registro completo de todas las pruebas realizadas y sus resultados \getsshauthorizedkeys() as object \ \disponible a partir de bos 10 0 11, esto d\ \evuelve un roarray de strings con una string de línea de clave pública autorizada \ \consulte\ formato de clave pública docid gp4o6du0giajtyc8 hl2 \setsshauthorizedkeys(keys as object) as boolean \ \disponible a partir de bos 10 0 11, esto \ \a\ \cepta un contenedor enumerable (normalmente un roarray) de strings que contienen el conjunto completo de claves públicas autorizadas en las que confiar devuelve `verdadero` si tiene éxito o `falso` en caso de error si se devuelve `falso` , entonces llamar a `getfailurereason()` proporcionará más información el nuevo conjunto de claves públicas tendrá efecto inmediatamente una vez que se llame a `aplicar()` \ \consulte\ formato de clave pública docid gp4o6du0giajtyc8 hl2 resetsshhostkeys() as boolean borra todas las claves de host del servidor ssh si el método devuelve verdadero entonces se requiere un reinicio para que el servidor comience a utilizar las nuevas claves si el método devuelve falso entonces llame a getfailurereason() si eso devuelve una string vacía, entonces la llamada fue exitosa y no se requiere reinicio para que las nuevas claves tengan efecto si getfailurereason() devuelve una string no vacía, entonces la llamada falló \ifnetworkconfiguration\ \(interfaz de red y configuración de host)\ getcurrentconfig() as object recupera toda la configuración actual como un arreglo asociativo que contiene los siguientes miembros valor tipo host/interfaz descripción metric integer interfaz devuelve la métrica de enrutamiento actual de la interfaz consulte la entrada setroutingmetric() para obtener más detalles dhcp boolean interfaz devuelve verdadero si el sistema está configurado actualmente para usar dhcp devuelve falso en caso contrario hostname string host el nombre de host configurado actualmente mdns hostname string host el nombre de host zeroconf actualmente en uso puede ser más largo que el nombre de host si existe una colisión en la red actual ethernet mac string interfaz la dirección mac de ethernet ip4 address string interfaz la dirección ipv4 actual si actualmente no hay ninguna configurada, la cadena estará vacía ip4 netmask string interfaz la máscara de red ipv4 actual si actualmente no hay ninguna configurada, la cadena estará vacía ip4 broadcast string interfaz la dirección de broadcast ipv4 actual si ninguna está configurada actualmente, la cadena estará vacía ip4 gateway string interfaz la dirección de gateway ipv4 actual si ninguna está configurada actualmente, la cadena estará vacía domain string host una lista de dominios separados por espacios en blanco que se anexarán a nombres no calificados al resolverlos domains roarray de strings host los dominios que se anexarán a nombres no calificados al resolver nombres dns servers roarray de strings host los servidores dns actualmente activos time server string host el servidor de hora actual configured proxy string host el proxy configurado actualmente este puede contener caracteres mágicos como se explica en setproxy() arriba current proxy string host el proxy actualmente activo cualquier carácter mágico habrá sido reemplazado como se explica en setproxy() arriba shape inbound integer interfaz el modelado de ancho de banda actual para el tráfico entrante determinado por el método setinboundshaperrate() type string interfaz ya sea "wired" o "wifi" link boolean interfaz indica si la interfaz de red está conectada actualmente wifi essid string interfaz el nombre de la red wi‑fi actual (si existe) wifi signal integer interfaz una indicación de la intensidad de la señal recibida el valor absoluto de este campo normalmente no es significativo, pero puede compararse con el valor informado en otras redes o en diferentes ubicaciones getneighborinformation() as roassociativearray recupera información de ubicación de la infraestructura de red mediante el protocolo lldp med la información se devuelve como un arreglo asociativo de cadenas correspondientes a tipos de direcciones cívicas, que se definen de la siguiente manera según la especificación lldp med catype etiqueta descripción 1 a1 subdivisiones nacionales (estado, región, provincia, prefectura) 2 a2 condado, parroquia, gun(jp), distrito(in) 3 a3 ciudad, municipio, shi(jp) 4 a4 división de ciudad, municipio, distrito de ciudad, barrio, chou(jp) 5 a5 vecindario, bloque 6 a6 calle catype nena pidf descripción ejemplos 0 idioma i default \[3] 16 prd prd dirección inicial de la calle n 17 pod pod sufijo final de la calle sw 18 sts sts sufijo de la calle ave, platz 19 hno hno número de casa 123 20 hns hns sufijo del número de casa a, 1/2 21 lmk lmk punto de referencia o dirección personalizada universidad de columbia 22 loc loc información adicional de ubicación ala sur 23 nam nam nombre (ocupante de la residencia y la oficina) barbería de joe 24 zip pc código postal/zip 10027 1234 25 edificio (estructura) low library 26 unidad (apartamento, suite) apt 42 27 flr piso 4 28 número de habitación 450f 29 tipo de lugar oficina 30 pcn nombre de la comunidad postal leonia 31 apartado postal (p o box) 12345 32 código adicional 13203000003 128 script latn 255 reservado ifwificonfiguration scanwifi() as roarray busca redes inalámbricas disponibles los resultados se informan como un roarray que contiene uno o más arrays asociativos con los siguientes miembros valor tipo descripción essid string nombre de la red bssid string bssid del punto de acceso signal integer indicación de intensidad de señal recibida el valor absoluto de este campo normalmente no es relevante, pero puede compararse con el valor informado en otras redes o en diferentes ubicaciones scanwifi puede fallar si no se ha completado un escaneo anterior, o si hay un escaneo en segundo plano en curso este posible fallo debe manejarse en el script, y el script debe reintentar scanwifi si falla reassociatewifi(enable as boolean) as boolean este método no toma parámetros e intenta desconectarse y reconectarse a la red wifi configurada actualmente normalmente esto no debería ser necesario, pero podría resultar útil al diagnosticar problemas de red devuelve verdadero en caso de éxito o falso en caso de fallo cuando se devuelve falso llamar a getfailurereason() puede proporcionar más información sobre el motivo este método está presente en bos 8 4 20 y versiones posteriores, bos 8 5 26 y versiones posteriores, y en todas las versiones de bos 9 0 tenga en cuenta que esta función puede devolver el control antes de que la red se haya reconectado use ronetworkhotplug para determinar cuándo se completa la reconexión autenticación de red los reproductores brightsign admiten los formatos de cifrado inalámbrico más utilizados wep (64 y 128), wpa (tkip) y wpa2 (aes) wpa enterprise es compatible con eap tls (con certificados der, pem o pkcs#12) y peapv0/mschapv2 (con un nombre de usuario y una frase de contraseña) también se admite la autenticación cableada mediante 802 1x las instrucciones de configuración a continuación se aplican tanto a la autenticación wifi como a la autenticación cableada mediante 802 1x; la única diferencia es el parámetro cableado/inalámbrico (0/1) pasado durante la inicialización de ronetworkconfiguration eap tls la autenticación eap tls requiere un certificado de cliente y una clave privada hay dos formas de lograrlo empaquetar el certificado de cliente y la clave privada en un solo archivo en formato pkcs#12 (usando codificación pem o der), normalmente con una extensión de archivo p12 para hacerlo, configure el archivo pkcs#12 usando el método setwifiprivatekey() y pase una cadena vacía al método setwificlientcertificate() empaquetar el certificado de cliente como un certificado x 509 (usando codificación pem o der) y, opcionalmente, proteger la clave con una frase de contraseña (en lugar de la frase de contraseña wifi habitual) para hacerlo, configure el certificado de cliente usando el método setwificlientcertificate() y la clave usando el método setwifiprivatekey() si la clave está protegida con una frase de contraseña, entonces debe llamar a setwifipassphrase() las claves de certificados pueden contener datos binarios si no tienen formato pem en este caso, deben proporcionarse como un objeto robytearray los formatos de texto pueden pasarse usando una cadena o robytearray ejemplo configuración de eap tls con un archivo p12 nc = createobject("ronetworkconfiguration",1) p12 = createobject("robytearray") p12 readfile("client p12") nc setwificlientcertificate("") nc setwifiprivatekey(p12) nc setwifipassphrase("passwordgoeshere") durante la autenticación, se pasa una identidad al servidor radius de forma predeterminada, la identidad se tomará del certificado del cliente si el certificado tiene un "subjectaltname", se utilizará; de lo contrario, se utiliza el "commonname" si ninguno de estos es correcto, la identidad puede sobrescribirse este comportamiento predeterminado puede sobrescribirse llamando a setwifiidentity() , o puede especificarse pasando una cadena vacía a setwifiidentity() peap/mschap este modo requiere una identidad (nombre de usuario) y contraseña, en lugar de un certificado de cliente también puede haber una segunda identidad "externa"; consulte la sección casos especiales a continuación para obtener detalles de configuración nc = createobject("ronetworkconfiguration",1) nc setwifiidentity("user\@brightsign example com") nc setwifipassphrase("passwordgoeshere") variantes comunes certificados adicionales a menudo se requieren certificados ca adicionales cuando se utiliza una ca privada o interna para la autenticación además, algunas jerarquías de ca requieren certificados intermedios, que a veces se suministran mediante eap si el servidor no los suministra, pueden añadirse al archivo ca usando el método setwificacertififcates() este método admite certificados pem si no se proporciona una ca, no se realizará ninguna verificación de pares y se producirá una autenticación/conexión no validada nc = createobject("ronetworkconfiguration",1) ca = createobject("robytearray") ca readfile("ca pem") nc setwificacertificates(ca) contraseña wifi ofuscada si se requiere una contraseña wifi ofuscada, puede sustituir el método setobfuscatedwifipassphrase() por el método setwifipassphrase() comuníquese con support\@brightsign biz mailto\ support\@brightsign biz para obtener más información sobre cómo generar una clave para la ofuscación y almacenarla en el reproductor cifrado tkip/ccmp de forma predeterminada, se permite tanto el cifrado wpa (tkip) como wpa2 (ccmp) puede modificar este comportamiento utilizando el método setsecuritymode() , que acepta una lista separada por espacios y no sensible a mayúsculas/minúsculas de modos permitidos ("ccmp" y "tkip") si se permiten tanto ccmp como tkip, ccmp siempre tiene prioridad nc = createobject("ronetworkconfiguration",1) nc setwifisecuritymode("") 'sets the default mode nc setwifisecuritymode("ccmp tkip") 'explicitly allows both modes (same as the default mode) nc setwifisecuritymode("ccmp") 'requires the use of ccmp casos especiales compatibilidad con md5 la compatibilidad con md5 está habilitada de forma predeterminada por razones de compatibilidad con versiones anteriores este comportamiento puede modificarse pasando la cadena "md5=enable" o "md5=disable" al método setwifieaptlsoptions() nc = createobject("ronetworkconfiguration",1) nc setwifieaptlsoptions("md5=disable") identidad anónima algunas configuraciones de eap peap/mschap requieren una identidad anónima de forma predeterminada, el reproductor brightsign utiliza la misma identidad interna y externa se puede configurar una identidad anónima con el método setwifieapttlsoptions() nc = createobject("ronetworkconfiguration",1) nc setwifieaptlsoptions("anonymous identity=anon\@brightsign biz") si no se están utilizando opciones de md5 ni de identidad, la configuración debe borrarse pasando una cadena vacía al método setwifieapttlsoptions() fechas de validez las fechas de validez son necesarias tanto para eap tls como para peap/mschap se requiere la hora actual para verificar el certificado si el reloj del reproductor no se ha configurado, normalmente establecerá la hora usando la red, pero esto primero requiere autenticación eap para evitar este problema, hay dos excepciones especiales eap tls cuando el reloj no está configurado, la hora se establece diez segundos después de que el certificado del cliente entra en vigor, lo que normalmente es suficiente para autenticarse (aunque esto puede no ser suficiente para servidores con certificados más nuevos que el cliente) peap/mschap no hay certificado de cliente y la hora del certificado del servidor no se verifica cuando la fecha no está configurada el reloj también puede configurarse mediante el servidor web de diagnóstico (dws) docid\ qxt4yhey7iej m9dh73wm , lo que evita que se utilice cualquiera de las excepciones anteriores normalmente, el reloj también se configura desde la red una vez que está disponible, por lo que estas excepciones solo se utilizan en el primer arranque o cuando la batería del reloj se ha agotado completamente ejemplos el siguiente script deshabilita la configuración de wpa enterprise (que de otro modo es persistente) nc = createobject("ronetworkconfiguration", 1) nc setwifisecuritymode("") nc setwifiessid("") nc setwifiidentity("") nc setwificacertificates("") nc setwificlientcertificate("") nc setwifiprivatekey("") nc setwifipassphrase("") nc setwifieaptlsoptions("") ok = nc apply() el siguiente script configura el wifi para eap tls usando un archivo pkcs#12 ( p12 ), sin certificados de ca adicionales essid = "brightwifi" pkcs12file = "client p12" pkcspass = "passwordgoeshere" nc = createobject("ronetworkconfiguration", 1) nc setwifiessid(essid) p12 = createobject("robytearray") ok = p12 readfile(pkcs12file) if ok then nc setwificlientcertificate("") nc setwifiprivatekey(p12) nc setwifipassphrase(pkcspass) nc setwificacertificates("") nc setwifisecuritymode("") nc setwifiidentity("") nc setwifieaptlsoptions("") ok = nc apply() end if el siguiente script configura el wifi para eap tls con certificados adicionales essid = "brightwifi" cafile = "cacert pem" pkcs12file = "client p12" pkcspass = "passwordgoeshere" nc = createobject("ronetworkconfiguration", 1) nc setwifiessid(essid) p12 = createobject("robytearray") ok = p12 readfile(pkcs12file) ca = createobject("robytearray") ok = ca readfile(cafile) and ok if ok then nc setwificlientcertificate("") nc setwifiprivatekey(p12) nc setwifipassphrase(pkcspass) nc setwificacertificates("") nc setwifisecuritymode("") nc setwifiidentity("") nc setwifieaptlsoptions("") ok = nc apply() end if el siguiente script configura el wifi para peap/mschap con archivos de ca adicionales essid = "brightwifi" cafile = "ca pem" user = "someuser\@brightsign biz" pass = "whatever" ca = createobject("robytearray") ok = ca readfile(cafile) if ok then nc = createobject("ronetworkconfiguration", 1) nc setwifiessid(essid) nc setwifiidentity(user) nc setwifipassphrase(pass) nc setwificacertificates(ca) nc setwificlientcertificate("") nc setwifiprivatekey("") 'use this if an anonymous outer identity is required 'nc setwifieaptlsoptions("anonymous identity=anon\@brightsign biz") nc setwifieaptlsoptions("") ok = nc apply() if not ok then fail = "unable to set configuration " + nc getfailurereason() end if else fail = "unable to read file " + cafile end if ' if not ok, do something with the failure message el siguiente script realiza varias configuraciones de vlan en la interfaz ethernet ' configure the vlans first use defaults for vlan6 n6=createobject("ronetworkconfiguration", "eth0 6") print n6 resetinterfacesettings() print n6 apply() ' use defaults for vlan11 n11=createobject("ronetworkconfiguration", "eth0 11") print n11 resetinterfacesettings() print n11 apply() ' use static ip for vlan15 n15=createobject("ronetworkconfiguration", "eth0 15") print n15 setip4address("192 168 15 100") print n15 setip4netmask("255 255 255 0") print n15 apply() ' now enable vlans 6, 11 and 15 on eth0 n0=createobject("ronetworkconfiguration", "eth0") print n0 setvlanids(\[6, 11, 15]) print n0 apply()