--- title: Integración de la API de BSN.Cloud slug: develop/es/integracion-de-la-api-de-bsncloud docTags: createdAt: 2025-03-11T07:03:32.131Z --- BSN.Cloud es nuestro servicio gratuito para aprovisionamiento, diagnósticos y control de reproductores BrightSign. Permite el aprovisionamiento automatizado de los reproductores de sus clientes a su solución CMS. También puede usar BSN.Cloud para realizar una gran cantidad de acciones de diagnóstico en un reproductor BrightSign. Esta página le mostrará cómo aprovisionar reproductores BrightSign listos para usar (y ayudar a sus clientes a hacer lo mismo, si es necesario) e interactuar con el reproductor a través de internet usando la REST API de BSN.Cloud. ## Glosario de términos - **BSN.Cloud**: Un conjunto de servicios de administración e implementación de reproductores que incluyen la API de B-Deploy, Remote DWS, servicios de autenticación y un conjunto de APIs - **Socio**: El sistema de gestión de contenido (CMS) que se integrará con BrightSign - **Credenciales de cliente**: Un conjunto de credenciales, proporcionadas por BrightSign, que permite al socio crear y administrar redes - **Cliente**: La persona que compra servicios de gestión de contenido del socio para administrar reproductores BrightSign - **Persona**: Un conjunto de credenciales (correo electrónico y contraseña) que permite a una persona crear redes y acceder a ellas como usuario. - **Red**: La estructura para administrar y supervisar reproductores en BSN.Cloud: - Una red puede tener cualquier número de reproductores, pero un reproductor solo puede pertenecer a una única red a la vez. Para cambiar un reproductor a otra red, la entrada del dispositivo debe eliminarse de la red original en los servicios BSN y B-Deploy. - Una red puede tener varios usuarios (es decir, personas), y las personas pueden pertenecer a varias redes. La persona que crea la red es el administrador de la red, pero el administrador puede otorgar a otros usuarios privilegios equivalentes. - Se requiere una o más suscripciones de reproductor para actualizar una red a BrightSign Author Plus o Control Plus. ## Recursos Los siguientes recursos se utilizan para las operaciones de BrightSign Author y Control Plus: - [APIs de BSN.Cloud](docId\:hTJt91tjlkYM96cdoxsDS) - [API de Remote DWS](docId\:Fy7YnOrkjN664uxDkKwjn) - [B-Deploy ](https://brightsign.atlassian.net/wiki/spaces/DOC/pages/378831792/B-Deploy+Device+Provisioning)[B-Deploy/APIs de aprovisionamiento](docId:1Is4_wL6MClI4D1T5lyDa) ## Obtención de credenciales de cliente de BSN.Cloud Consulte [Autenticación](docId\:u_-NJ27EzaIs8KnCUX2mf). ## Determine la estructura de su red Antes de crear redes de BSN.Cloud, deberá determinar cómo administrar los reproductores de clientes en BSN.Cloud. Hay tres opciones: - **Una red para todos los clientes**: Usted administra una única red para los reproductores de todos los clientes. No hay forma de segregar los reproductores por usuario, por lo que no podría dar a los clientes acceso directo a la funcionalidad de Remote DWS o B-Deploy. - **Usted crea redes para los clientes**: Usted creará una red para cada uno de sus clientes. Puede crear un usuario adicional en la red para dar acceso al cliente (como creador, usted permanece como propietario de la red). El cliente puede tener permisos completos o un subconjunto de permisos. - **Cada cliente crea una red**: El cliente crea una red usando la UI de BSN.Cloud (o una UI personalizada que usted cree usando las APIs). Si desea acceso a las redes de sus clientes, deberán agregarlo a la red o entregarle sus credenciales. ## Determine las prioridades de la interfaz de red ### Lógica de métricas de BrightSignOS Antes de OS 8.4.6, BrightSignOS (BOS) actualizaba las métricas (prioridad de interfaz) de las interfaces cableadas e inalámbricas usando 0 como el valor de métrica más alto y 1 como el valor secundario, cuando se especificaba mediante BrightSign Author. En BrightSignOS 8.4.6 y versiones posteriores, el BOS asignará métricas en los siguientes casos: - Interfaces objetivo: Una vez que el reproductor se haya conectado correctamente a BSN.Cloud, las métricas se actualizarán en las interfaces proporcionadas por el paquete Device Setup. - Interfaces descubiertas: Una vez que el reproductor se haya conectado correctamente a BSN.Cloud, las métricas se actualizarán en las interfaces que se descubran ya sea mediante una conexión de interfaz física antes de aplicar alimentación o como conexión en caliente después de aplicar alimentación. La lógica del valor de la métrica se utiliza para determinar el valor real usado al aplicarse al BOS. En relación con el orden de todas las Interfaces objetivo e Interfaces descubiertas, la métrica se calculará comenzando la "asignación de métricas" en 100. La ubicación (o índice) de la interfaz se ordena en relación con otras interfaces, luego se multiplica por 10 y después se incrementa en 100. Por ejemplo: | Interfaz | Índice | Valor final de la métrica ((Índice \* 10) + 100) | | -------- | ------ | ------------------------------------------------ | | eth0 | 0 | 100 | | wlan0 | 1 | 110 | | ppp0 | 2 | 120 | | usb0 | 3 | 130 | ### Definiciones de rangos de métricas Estas definiciones de rangos de métricas son flexibles; no hay restricciones reales. - 0 - 99: Se utiliza para interfaces que no son asignadas por el BOS, posiblemente porque el reproductor no está conectado a BSN.Cloud o a una versión anterior de BOS, o debido a autorun. Estas serían asignadas explícitamente por software anterior. - 100 - 199: Se utiliza para el BOS al asignar métricas. - 200 - n: Se utiliza para interfaces que no son asignadas por el BOS. Esto puede deberse a que el reproductor no está conectado a BSN.Cloud, o a que se está ejecutando una versión anterior de BOS o autorun, donde estas no eran asignadas por ningún software. ### Deshabilitar las métricas de BrightSignOS Para evitar que el BOS aplique métricas para todas las interfaces, establezca `supervisor_apply_metrics` en `falso` en la clave del registro de la sección de red. ## Determine su flujo de trabajo de aprovisionamiento Dependiendo de la estructura de red que haya decidido utilizar, existen dos flujos de trabajo para aprovisionar reproductores de clientes para su CMS y BSN.Cloud: - **Opción A - El partner aprovisiona los dispositivos del cliente**: Utilizará las APIs de B-Deploy para generar un objeto Device para cada reproductor (utilizando el número de serie) y asociar los objetos Device con uno o más objetos Device Setup. Puede agregar objetos Device utilizando sus credenciales de cliente (por ejemplo, antes de enviarlos desde su almacén), o puede permitir que los clientes introduzcan ellos mismos los números de serie (lo que requeriría que desarrollara una UI orientada al cliente que interactúe con las APIs de B-Deploy en el backend). Cuando el cliente conecte los reproductores a Internet en el sitio, se comunicarán con los servidores de B-Deploy y se aprovisionarán automáticamente para su CMS. - **Opción B - El cliente vincula la red BSN.Cloud con el CMS del partner**: Haga que el cliente agregue reproductores a su red BSN.Cloud, a la cual su CMS tiene acceso. Los reproductores que estén registrados en la red del cliente se aprovisionarán automáticamente para su CMS. Esta opción requiere que obtenga acceso a una red de cliente; hay dos maneras de hacerlo: - Usted crea una red BSN.Cloud para el cliente utilizando las APIs de BSN.Cloud y entrega las credenciales al cliente. - El cliente crea una cuenta utilizando el nuevo esquema de activación de dispositivos BrightSign. Luego, el cliente deberá entregarle las credenciales. ## Alojar un paquete de aprovisionamiento Puede utilizar la aplicación B-Deploy para configurar reproductores para su aplicación CMS. Para ello, deberá alojar una URL de aplicación fija que los reproductores BrightSign puedan utilizar para descargar un paquete de aprovisionamiento. Comuníquese con BrightSign para obtener ayuda al generar un paquete de aprovisionamiento. ## Seguridad El reproductor BrightSign expone algunas APIs que proporcionan información requerida por varios procesos internos. Estas son APIs abiertas, que no son seguras. Sin embargo, solo pueden ser llamadas por otros procesos que se estén ejecutando en el reproductor, no externamente, y no proporcionan ninguna información confidencial.