Disponibilidad:
El aprovisionamiento Zero-Touch (ZTP) está disponible generalmente (GA) para dispositivos compatibles que ejecutan RoomOS 26.5.0 o posterior.
Beneficios clave
- Registro automático de dispositivos: los dispositivos pueden ser integrados usando su dirección MAC cuando se asignan a un espacio de trabajo compartido o a una cuenta de usuario personal, lo que reduce la necesidad de ingresar manualmente el código de activación cuando se utiliza la incorporación de direcciones MAC. Webex Edge Las implementaciones soportadas pueden usar el mismo proceso con las llamadas a las instalaciones.
- Configuración simplificada: Aprovechando la configuración predeterminada y las preconfiguraciones de Control Hub, la experiencia del Asistente para la Primera Vez (FTW) se optimiza, lo que reduce significativamente los pasos manuales durante la configuración del dispositivo físico.
- Operaciones masivas eficientes: Los dispositivos se pueden agregar de forma masiva importando archivos CSV que contengan direcciones MAC, lo que permite implementaciones a gran escala con un mínimo esfuerzo.
- Capacidad de preactivación: Los dispositivos se pueden activar por adelantado, incluso antes de que se conecten a la red. Los dispositivos pueden preconfigurarse para un espacio de trabajo o una cuenta de usuario personal.
- Complejidad de incorporación reducida: Al automatizar la incorporación de la red y el aprovisionamiento de dispositivos, ZTP reduce el tiempo, el costo y la complejidad tradicionalmente asociados con la configuración del dispositivo.
Términos clave para la incorporación de dispositivos en Control Hub
- No reclamado: La dirección MAC del dispositivo no está registrada dentro de su organización.
- Reclamado: La dirección MAC del dispositivo se ha agregado a su organización.
- Sin asignar: un dispositivo reclamado que aún no se ha vinculado a un espacio de trabajo o cuenta de usuario personal.
- Asignado: Un dispositivo reclamado vinculado a un espacio de trabajo o a una cuenta de usuario personal.
- Pendiente: El estado que se muestra en Control Hub para un dispositivo que ha sido reclamado y/o asignado pero que aún no ha entrado en línea.
- Preconfiguración: El proceso de aplicar los ajustes de configuración del dispositivo a un dispositivo pendiente antes de que se conecte a la red o se conecte.
- Activado: El dispositivo ha completado el Webex o el proceso de Webex Edge activación correspondiente.
- Dispositivo personal: Un dispositivo asignado a una cuenta de usuario en lugar de a un espacio de trabajo.
- Webex Edge: Un modelo de implementación en el que el dispositivo permanece registrado en la infraestructura local mientras recibe funciones y administración de la nube compatibles. Consulte Webex Edgela documentación.
Requerimientos
Asegúrese de que su entorno cumpla con estos requisitos antes de la implementación:
- Versión de software: Los dispositivos deben ejecutar RoomOS 26.5.0 o posterior. RoomOS 11 no es compatible.
- Conectividad de red: Los dispositivos requieren acceso confiable a la red con conectividad a los servicios de Webex.
- Configuración predeterminada: defina los valores predeterminados de organización y ubicación en Control Hub para formato de hora, zona horaria e idioma para minimizar las solicitudes de incorporación durante el Asistente para la primera vez (FTW).
Para el modo personal, el usuario ya debe existir en Control Hub antes de que se asigne el dispositivo.
Para Webex Edge ZTP, la detección CUCM/TFTP debe estar disponible donde lo requiera la
implementación, incluida la opción 150 de DHCP cuando se usa. Valide el comportamiento de
AllowDataLogging y resuelva cualquier conflicto entre las configuraciones controladas por CUCM y
controladas por el concentrador de control antes de la incorporación.
Requisitos previos: Actualización a la versión mínima para la activación sin contacto
Para actualizar a la versión 26.5, tendrá que realizar la actualización manualmente por ahora. En los próximos meses, una función de actualización previa a bordo automatizará este proceso, y las imágenes de fábrica se actualizarán en consecuencia. Hasta entonces, los clientes deben actualizar mediante los enlaces de paquetes o la interfaz xcommand para instalar la actualización, seguido de realizar un restablecimiento de fábrica para completar el proceso.
Versión de software durante la incorporación: Si un dispositivo está por debajo de la versión de incorporación FTW, ZTP puede actualizarlo antes del registro. Esta actualización se produce independientemente del canal de software del espacio de trabajo, incluido un canal establecido a través de la configuración del dispositivo pendiente. Una vez completado ZTP, se aplican las reglas de software normales del espacio de trabajo y el dispositivo puede actualizarse o degradarse a la versión requerida por ese canal. Este comportamiento es esperado. Dispositivos Microsoft Teams Rooms: Si ZTP actualiza un dispositivo MTR a una versión posterior a la versión asignada a su canal aprobado por Microsoft, el dispositivo no se degrada automáticamente mientras opera en modo MTR.
Mapeo de paquetes y comandos
Seleccione el paquete adecuado en función de su hardware. Utilice el
XCommand proporcionado para iniciar la actualización.
| Categoría de dispositivo | Nombre del paquete |
|---|---|
| Cisco Room Navigator |
bifrost.pkg
|
| Productos más nuevos (Codec Pro G2, Desk Pro G2) |
luna.pkg
|
| Puntos finales RoomOS estándar (Room Bar, Room Kit EQ, Board Pro, Escritorio, Codec Pro) |
zenith.pkg
|
Para CiscoRoom Navigator:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True
Para Codec Pro G2 y Desk Pro G2:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/luna.pkg" Forced: True
Para Room Bar, Room Kit EQ, Board Pro, Escritorio y Codec Pro:
xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True
Iniciando la activación Zero Touch a través de CLI
Puede activar manualmente el proceso de activación Zero Touch mediante la interfaz de línea de comandos (CLI) o la API. Utilice el siguiente comando para iniciar el flujo de trabajo:
xCommand Webex Registration ZeroTouchProvisioning Start SecurityAction: <Harden, NoAction>
Parameters:
Harden: Applies enhanced security settings to the device during the activation process.
NoAction: Proceeds with the activation using the current device security configuration.
Pasos de configuración en Control Hub
-
Configurar valores predeterminados
La configuración predeterminada ayuda al dispositivo a omitir los pasos de configuración manual durante la incorporación. Vaya a Control Hub y configure lo siguiente:
- Hora -> TimeFormat (por ejemplo, 12h/24h)
- Hora -> Zona (por ejemplo, America/New_York)
- Interfaz de usuario -> Idioma (por ejemplo, inglés)
Opcionalmente, asigne el espacio de trabajo a la ubicación donde se configuran estos valores predeterminados o aplique los valores predeterminados de toda la organización.
Antes de usar la Activación Zero Touch, confirme que el dispositivo no requiere llamadas híbridas. Los dispositivos que requieren llamadas híbridas deben estar integrados mediante el código de activación o el flujo de trabajo de incorporación manual.
-
Agregue el dispositivo por dirección MAC
- Vaya a Control Hub -> Dispositivos -> Agregar dispositivo (o Crear espacio de trabajo). También puede comenzar desde Usuarios, seleccionar un usuario, abrir la pestaña Dispositivos y seleccionar Agregar dispositivo.
- Seleccione Dispositivo Cisco Room o Desk, elija Uso compartido o Uso personal y seleccione Dirección MAC. Introduzca la dirección MAC Ethernet cableada, el tipo de producto y la plataforma (RoomOS o Microsoft Teams). Si selecciona Microsoft Teams, la plataforma se instalará automáticamente al finalizar el asistente.
- Para un dispositivo personal, seleccione la cuenta de usuario a la que asignarlo. Para una Webex Edge implementación compatible, seleccione Llamadas a las instalaciones cuando esté disponible y siga la ruta de aprovisionamiento CUCM/local configurada.
-
Si el dispositivo ya está reclamado pero no asignado, abra el dispositivo en Control Hub, seleccione Asignar y elija Asignar un dispositivo a un usuario. Los dispositivos reclamados que aún no se han conectado aparecen como pendientes.
Consulte la sección para localizar la etiqueta de dirección MAC física de su dispositivo para obtener información sobre cómo encontrar la dirección MAC del dispositivo.
Puede filtrar todos los dispositivos que se han reclamado, ya sea que estén actualmente en línea o fuera de línea, utilizando el filtro Propiedad en la página Dispositivos y seleccionando Reclamado.
-
Aplicar preconfiguraciones a dispositivos pendientes (opcional, recomendado)
Puede aplicar preconfiguraciones a nivel de dispositivo antes de que el dispositivo esté en línea para cualquier configuración admitida siguiendo estos pasos:
- Abra la página del dispositivo pendiente en Control Hub.
- Haga clic en “Todas las configuraciones”.
- Aplique la configuración necesaria.
Durante la incorporación, el dispositivo consume los ajustes de configuración de estos orígenes en orden jerárquico:
- Valores predeterminados a nivel de organización
- Valores predeterminados a nivel de ubicación
- Preconfiguraciones a nivel de dispositivo en el dispositivo pendiente
La configuración definida en cualquiera de estos niveles se aplica automáticamente durante el flujo de incorporación del Asistente por primera vez.
Para que el asistente de incorporación automática se complete correctamente, se deben establecer las siguientes configuraciones:
Todos los dispositivos:
- Hora > TimeFormat (por ejemplo, 12h/24h)
- Hora > Zona (por ejemplo, America/New_York)
- Interfaz de usuario > Idioma (por ejemplo, inglés)
Solo serie de juntas:
- Audio > Colocación (montaje en pared, independiente)
Resultado:
- Según el método de incorporación, el dispositivo aparece como Reclamado, Asignado o Pendiente. Cuando el dispositivo se conecta, completa la incorporación automática.
- Está preconfigurado con configuración de ubicación y nivel de dispositivo.
- Cuando el dispositivo de restablecimiento de fábrica se conecta a la red, se registrará y se incorporará automáticamente.
Localice la etiqueta de dirección MAC física de su dispositivo
Si no puede localizar su dirección MAC, generalmente está impresa en la etiqueta del producto que se encuentra en la parte posterior o inferior de su dispositivo. Esta etiqueta a menudo incluye otros identificadores importantes como el número de serie y la identificación del producto. Para muchos productos Cisco, la etiqueta de dirección MAC está claramente marcada y se puede encontrar en el chasis o en una bandeja de etiquetas. Si no puede localizarlo físicamente, algunos dispositivos también le permiten ver la dirección MAC a través de su interfaz de usuario o página web en la configuración de información del producto o del sistema.
Proceso de incorporación
Webex Edgeadmite secuencias de incorporación en primer lugar en el dispositivo y en la nube. Dependiendo de la implementación, el dispositivo puede descubrir primero la configuración CUCM/TFTP y luego completar la Webex Edge activación, o usar su asignación de Control Hub antes de conectarse al entorno de aprovisionamiento local .
Una vez que el dispositivo es reclamado y asignado en Control Hub:
- Asegúrese de que el dispositivo esté restablecido de fábrica.
- Conecte el dispositivo a la red.
- En la pantalla de bienvenida, seleccione la opción de incorporación automática.

Activación del dispositivo en curso - Siga las indicaciones restantes para los elementos no configurados en Control Hub.
- Si no completó ciertos ajustes durante la preconfiguración, el asistente de configuración le pedirá que configure estos elementos durante la incorporación del dispositivo.
- Además, complete la configuración de hardware necesaria, como colocar la cámara correctamente, para garantizar un rendimiento óptimo del dispositivo.
Si no se muestra la opción de incorporación automática, verifique lo siguiente:
- La dirección MAC se introduce correctamente y se asigna al espacio de trabajo previsto o a la cuenta de usuario personal
- El dispositivo se ha restablecido de fábrica.
- El dispositivo tiene acceso a Internet verificado a los servicios de Webex.
- El dispositivo está ejecutando la versión de software mínima requerida (RoomOS 26.5.0+).
Incorporación masiva de dispositivos (CSV)
Utilice el proceso de incorporación masiva para reclamar y asignar varios dispositivos en una sola importación.
- En Control Hub, vaya a Dispositivos y haga clic en Agregar dispositivo.
- Seleccione Agregar dispositivos de forma masiva.

Agregar dispositivos de forma masiva - En el menú desplegable de plantillas, elija la plantilla de incorporación sin contacto y
descargue el archivo CSV.

Selección de plantilla de cero toques - Complete el archivo CSV con su dispositivo y la información de asignación, asegurándose de que se completen todos los campos obligatorios. Para dispositivos de modo personal, escriba la dirección de correo electrónico del usuario en la columna Cuenta. El comportamiento CSV compartido y del espacio de trabajo existente permanece sin cambios.
- Cargue el archivo CSV completo y envíe la importación.
- Abra la página Tareas para supervisar el progreso de la importación y descargar un
archivo CSV de error si falla alguna fila.

Estado de la tarea de importación masiva - Verifique los dispositivos importados en la lista Dispositivos, donde inicialmente pueden
aparecer como reclamados y pendientes antes de su primera conexión.

Dispositivos importados en estado pendiente
Incorporación de la página web del dispositivo (remota)
Utilice la página web del dispositivo para la incorporación remota cuando no tenga acceso físico a la interfaz del dispositivo. Este método es especialmente útil para implementaciones sin Room Navigator conexión, como dispositivos Room Bar BYOD y Room Bar Pro BYOD.
- Abra un navegador web e ingrese la dirección IP del dispositivo en la barra de direcciones.
- Inicie sesión con el nombre de usuario admin sin contraseña.

Página de inicio de la página web del dispositivo - En la página web del dispositivo, abra la página del sistema y haga clic en Registrarse en Webex.

Regístrese en Webex - En el cuadro de diálogo de registro, haga clic en Iniciar incorporación automática para comenzar el
proceso. La incorporación automática también admite dispositivos que se han asignado a una cuenta de usuario
personal. Para Webex Edge implementaciones soportadas, el dispositivo continúa
a través de la ruta de aprovisionamiento CUCM/local configurada.

Inicio de la incorporación automática - Espere a que comience la incorporación. Luego, verifique el estado del dispositivo y el estado de registro en Control Hub para garantizar una incorporación exitosa.
Información adicional
- Este método de incorporación le permite configurar y administrar dispositivos de forma remota sin necesidad de una interacción física Room Navigator o directa con el dispositivo.
- Después del registro, el dispositivo puede ser administrado y monitoreado a través deCisco Webex Control Hub.
- Para los dispositivos BYOD Room Bar, este proceso permite habilitar la conectividad de red y el registro del centro de control, lo que desbloquea funciones avanzadas como administración de software, visibilidad periférica y acceso remoto.
- Asegúrese de que el dispositivo esté conectado a la red y sea accesible a través de su dirección IP antes de comenzar el proceso de incorporación.
Este proceso de incorporación remota optimizado ayuda a simplificar la implementación y administración de dispositivos de colaboración de Cisco en entornos donde el acceso físico es limitado o no está disponible.
Comportamiento del asistente por primera vez (FTW)
El Asistente para la Primera Vez (FTW) guía el proceso de incorporación inicial para dispositivos de colaboración de Cisco. Su comportamiento incluye las siguientes acciones clave:
- Inicio de incorporación automática: La FTW comienza la incorporación una vez que el usuario selecciona la opción de incorporación automática en la pantalla de bienvenida. El FTW reconoce si el dispositivo es compartido o personal. Los dispositivos personales utilizan la cuenta de usuario asignada y no requieren la entrada manual del código de activación cuando se selecciona la incorporación basada en Mac. Tenga en cuenta que los dispositivos de modo personal no finalizarán el asistente hasta que sean desbloqueados por el usuario previsto. Si se establece un pin en la cuenta del usuario, el usuario tendrá que desbloquearlo primero o ir a https://user.webex.com/ para restablecer su pin. Si no usan un pin, primero tendrán que emparejarse con el dispositivo (código QR, ultrasonido o usb-c) antes de desbloquearlo.
- Webex EdgeAprovisionamiento: Para las implementaciones soportadas, la FTW conserva la ruta de aprovisionamiento CUCM/TFTP antes de completar la activación. Webex Edge
- Uso de valores predeterminados configurados: cuando está disponible, el asistente aplica valores predeterminados configurados como idioma y zona horaria.
- Aplicación de preconfiguraciones: Aplica configuraciones de la Organización, Ubicación y cualquier preconfiguración de dispositivo pendiente establecida en Control Hub.
- Solicitud de configuración que falta: el asistente solicita al usuario que introduzca cualquier configuración que aún no esté configurada en Control Hub.
- Instalación de Microsoft Teams: Si se seleccionó la plataforma Microsoft Teams durante el proceso Agregar dispositivo, el asistente instala Microsoft Teams al final de la incorporación.
- Comprobaciones manuales de hardware: Ciertas tareas de configuración de hardware, como el posicionamiento de la cámara, requieren que el usuario las complete manualmente.
Limitaciones y tareas manuales
- La instalación de hardware físico, como la colocación y el montaje de la cámara, aún debe realizarse manualmente.
- No se admite la asignación de autoservicio del User Hub de una dirección MAC.
- No se admite el cambio de un dispositivo entre los principales modos de llamada después del registro.
- Es posible que necesite completar manualmente ciertos pasos del Asistente por primera vez si la configuración predeterminada correspondiente no está configurada en Control Hub.
- Llamadas híbridas: las llamadas híbridas no se admiten mediante el aprovisionamiento Zero Touch. No aprovisione dispositivos que requieran llamadas híbridas mediante el flujo de trabajo ZTP. En su lugar, utilice el código de activación existente o el flujo de trabajo de incorporación manual. La opción Llamada híbrida no aparece en el flujo de configuración de ZTP; esto es de esperar.
- El emparejamiento Zero Touch no está disponible en la versión inicial. El soporte para esta función está previsto para una actualización futura.
- Los proxies de interceptación TLS actualmente no son compatibles. Para que la Activación Zero Touch funcione, el dispositivo debe establecer una conexión directa y de confianza con los servicios de Webex. Actualmente se está desarrollando un proceso de arranque de confianza simplificado para estos entornos.
- Para implementaciones que requieren 802.1X o SCEP, la inscripción de certificados sigue siendo un proceso manual y se maneja independientemente de la Activación Zero Touch. Si bien actualmente se está desarrollando una herramienta automatizada de carga de certificados, el flujo de trabajo Zero Touch actual asume que el dispositivo ya ha establecido conectividad de red con los servicios de Webex.