Ervimento por toque (ZTP) nos dispositivos Board, Mesa e Série de salas
Disclaimer:
O ZTP (Zero-Touch Provisioning) está atualmente disponível a partir da imagem de software 26.5. Entretanto, essa disponibilidade é limitada e o recurso ainda não é considerado totalmente Disponibilidade Geral (GA). A disponibilidade total no Control Hub ocorrerá somente depois que a imagem 26.5 tiver sido distribuída por todos os canais necessários, incluindo o canal de atualização pré-a bordo, o arquivo COP versão no local e como uma imagem de fábrica em novos dispositivos. Esta abordagem de implementação em fases garante uma validação completa e integração antes de um amplo acesso ao cliente. A implantação completa e a disponibilidade total no Control Hub são esperados no período de junho a julho. Os clientes devem considerar essa versão controlada e planejar implantações de acordo.
Principais benefícios
- Registro automático do dispositivo: Os dispositivos são registrados em Webex continuamente com base no endereço MAC quando atribuídos a uma área de trabalho no Hub de controle, eliminando a entrada do código de ativação manual.
- Configuração simplificada: aproveitando as configurações e pré-configurações padrão do Control Hub, a experiência de Assistente de primeira vez (FTW) é simplificada, reduzindo significativamente as etapas manuais durante a instalação de dispositivos físicos.
- Operações em massa eficientes: os dispositivos podem ser adicionados em massa importando os arquivos CSV que contêm MAC endereços, permitindo implantações de larga escala com o mínimo esforço.
- Capacidade de pré-ativação: os dispositivos podem ser ativados antecipadamente, mesmo antes de se conectarem à rede ou serem atribuídos a uma área de trabalho específica, permitindo fluxos de trabalho de implantação flexíveis.
- Complexidade reduzida ao embarcar: ao automatizar o provisionamento da rede e do dispositivo, o ZTP reduz o tempo, o custo e a complexidade tradicionalmente associados à configuração do dispositivo.
Termos-chave para o dispositivo a bordo no hub de controle
- Não reivindicado: o endereço MAC do dispositivo não está registrado em sua organização.
- Alegado: o endereço MAC do dispositivo foi adicionado à sua organização.
- Não designado: Um dispositivo reivindicado que ainda não foi vinculado a nenhuma área de trabalho.
- Atribuído: Um dispositivo reivindicado que está vinculado a uma área de trabalho específica e está pronto para onboarding.
- Pendente: O status mostrado no Hub de controle de um dispositivo que foi reivindicado e/ou atribuído, mas ainda não ficou online.
- Pré-configuração: O processo de aplicar as configurações de configuração do dispositivo a um dispositivo pendente antes de se conectar à rede ou entrar online.
Requisitos
Verifique se o ambiente atende a estes requisitos antes da implantação:
- Versão do software: os dispositivos devem executar o RoomOS 26.5.0 ou posterior. RoomOS 11 não é suportado.
- Conectividade de rede: os dispositivos requerem acesso de rede confiável com conectividade aos serviços de Webex.
- Padrões de configuração: Definir organização e local são padronizados no Hub de controle para formato de hora, fuso horário e Idioma para minimizar os avisos de onboarding durante o FTW (First Time Wizard, assistente de primeira vez).
Pré-requisitos: Atualização para a versão mínima para ativação do toque zero
Para atualizar para a versão 26.5, você precisará executar manualmente a atualização por enquanto. Nos próximos meses, um recurso de atualização pré-a bordo automatizará esse processo, e as imagens de fábrica serão atualizadas de acordo. Até lá, os clientes deverão atualizar utilizando os links de pacotes ou a interface xcomunicador para instalar a atualização, seguidos pela execução de uma redefinição de fábrica para concluir o processo.
Mapeamento e comandos de pacotes
Selecione o pacote apropriado com base em seu hardware. Use o xCommand fornecido para iniciar a atualização.
| Categoria do dispositivo | Nome do pacote |
|---|---|
| Cisco Room Navigator | bifrost.pkg |
| Produtos mais novos(Codec Pro G2, Desk Pro G2) | luna.pkg |
| Terminais RoomOS Padrão(Room Bar, Room Kit EQ, Board Pro, Mesa, Codec Pro) | zenith.pkg |
Para Cisco Room Navigator:
URL de software systemUnit xCommand: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True
Para Codec Pro G2 e Desk Pro G2:
URL do software SystemUnit SystemUnit xCommand: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/luna.pkg" Forced: True
Para Room Bar, Room Kit EQ, Board Pro, Desk e Codec Pro:
URL do software SystemUnit SystemUnit: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True
Iniciando a Ativação do Toque Zero por meio da CLI
Você pode acionar manualmente o processo de Ativação do Zero Touch usando a Interface de Linha de Comando (CLI) ou API. Use o seguinte comando para iniciar o fluxo de trabalho:
xCommand Webex Registration ZeroTouchProvisioning Start SecurityAction: <Harden, NoAction> Parameters: Harden: Aplica as configurações de segurança aprimoradas ao dispositivo durante o processo de ativação. NoAction: continua com a ativação usando a configuração de segurança do dispositivo atual.
Etapas de configuração no hub de controle
- Configurar padrões
A definição de padrões ajuda o dispositivo a pular etapas de configuração manual durante o onboarding. Navegue até o hub de controle e configure o seguinte:
- Hora -> TimeFormat (por exemplo, 12h/24h)
- Fuso horário > fuso horário (por exemplo, América/New_York)
- UserInterface -> Language (por exemplo, Inglês)
Opcionalmente, atribua a área de trabalho ao local onde esses padrões estão configurados ou aplique os padrões em toda a organização.

- Adicionar o dispositivo por endereço MAC
- Vá para Hub de controle ->Revimentos -> Adicionar dispositivo (ou Criar espaço de trabalho).
- Selecione Cisco Sala ou Dispositivo de mesa.
- Defina suas configurações do espaço de trabalho (agendamento, chamada, etc.).
- Quando solicitado, selecione MAC Address e insira a ethernet com fio MAC endereço, tipo de produto e plataforma (RoomOS ou Microsoft Teams).
- Se você selecionar Microsoft Equipes, a plataforma será instalada automaticamente após a conclusão do assistente.

Consulte a seção para localizar o rótulo de endereço MAC físico do seu dispositivo para saber como encontrar o endereço MAC do dispositivo.
Os dispositivos que ainda não estão conectados à rede aparecerão com o status de "Pendente". Você pode filtrar todos os dispositivos que foram reivindicados — quer estejam atualmente online ou offline — usando o filtro "Propriedade" na página Dispositivos e selecionando "Reivindicado".

- Aplicar Pré-configurações a dispositivos pendentes (opcional, recomendado)
Você pode aplicar as pré-configurações de nível de dispositivo antes de o dispositivo entrar online para qualquer configuração suportada seguindo estas etapas:
- Abra a página de dispositivo pendente no Hub de controle.
- Clique em "Todas as configurações".
- Aplique as configurações necessárias.
Durante o embarque, o dispositivo consome as configurações de configuração destas fontes em ordem hierárquica:
- Padrões no nível da organização
- Padrões no nível de localização
- Pré-configurações no nível do dispositivo no dispositivo pendente
As configurações definidas em qualquer um desses níveis são aplicadas automaticamente durante o fluxo de entrada do Assistente de primeira vez.

Para que o assistente de bordo automático seja concluído com êxito, as seguintes configurações devem ser definidas:
Todos os dispositivos:
- Tempo > TimeFormat (por exemplo, 12h/24h)
- Fuso > horário (por exemplo, América/New_York)
- Idioma do > do Usuário (por exemplo, Inglês)
Board Apenas série:
- Colocação do > de áudio (Wallmount, Independente)
Resultado:
- O dispositivo é reivindicado e atribuído.
- Ele é pré-configurado com configurações de localização e nível de dispositivo.
- Quando o dispositivo de redefinição de fábrica se conecta à rede, ele será registrado e a bordo automaticamente.
Localizar o rótulo de endereço MAC físico do seu dispositivo
Se não for possível localizar o endereço MAC, ele será normalmente impresso no rótulo do produto encontrado na parte de trás ou na parte inferior do dispositivo. Esse rótulo geralmente inclui outros identificadores importantes, como o número de série e o ID do produto. Para muitos produtos Cisco, o rótulo do endereço MAC está claramente marcado e pode ser encontrado no chassi ou na bandeja de um rótulo. Se você não conseguir localizá-lo fisicamente, alguns dispositivos também permitirão que você visualize o endereço MAC por meio da interface de usuário ou da página da Web em configurações de produto ou informações do sistema.
Processo a Bordo
Depois que o dispositivo é reivindicado e atribuído no Hub de controle:
- Certifique-se de que o dispositivo seja redefinido de fábrica.
- Conecte o dispositivo à rede.
- Na tela de Boas-vindas, selecione a opção de onboarding automático.

Ativação de dispositivos em andamento - Siga os avisos restantes para os itens não configurados no Hub de Controle.
- Se você não concluiu certas configurações durante a pré-configuração, o assistente de configuração solicitará que você configure esses itens durante o dispositivo a bordo.
- Além disso, conclua a configuração de hardware necessária, como posicionar a câmera corretamente, para garantir o desempenho ideal do dispositivo.
Se a opção automática de onboarding não for mostrada, verifique o seguinte:
- O endereço MAC é digitado e atribuído corretamente à área de trabalho pretendida.
- O dispositivo foi redefinido de fábrica.
- O dispositivo verificou o acesso à Internet aos serviços Webex.
- O dispositivo está executando a versão mínima necessária do software (RoomOS 26.5.0+).
Dispositivo em massa a bordo (CSV)
Use o processo de carregamento em massa para reivindicar e atribuir vários dispositivos em uma única importação.
- No Hub de controle, navegue até Dispositivos e clique em Adicionar dispositivo.
- Selecione Dispositivos de adição em massa.

Dispositivos de adição em massa - No menu suspenso do modelo, escolha o modelo de onboarding com zero toque e faça o download do arquivo CSV.

Seleção de modelo de toque zero - Preencha o arquivo CSV com o dispositivo e as informações de atribuição, garantindo que todos os campos necessários sejam concluídos.
- Carregue o arquivo CSV concluído e envie a importação.
- Abra a página Tarefas para monitorar o progresso da importação e fazer o download de um erro CSV arquivo se alguma linha falhar.

Status da tarefa de importação em massa - Verifique os dispositivos importados na lista Dispositivos , onde eles podem aparecer inicialmente como Reivindicados e Pendentes antes de sua primeira conexão.

Dispositivos importados em estado pendente
Página da Web do dispositivo a bordo (Remota)
Use a página da Web do dispositivo para internação remota quando não tiver acesso físico à interface do dispositivo. Esse método é especialmente útil para implantações sem um Room Navigator anexado, como Room Bar BYOD e Room Bar dispositivos Pro BYOD.
- Abra um navegador da Web e insira o endereço IP do dispositivo na barra de endereços.
- Inicie a sessão usando o admin de nome de usuário sem senha.

Página da Web do dispositivo Home - Na página do sistema, clique no botão Registrar para Webex .

Registrar-se para Webex - Na caixa de diálogo de registro, clique em Iniciar onboarding automático para iniciar o processo.

Início automático do onboard - Aguarde o início do trabalho a bordo. Em seguida, verifique o estado do dispositivo e o status do registro no Hub de controle para garantir o início de sessão com êxito.
Informações adicionais
- Este método de onboarding permite configurar e gerenciar dispositivos remotamente sem precisar de uma interação física por Room Navigator ou de dispositivo direto.
- Após o registro, o dispositivo pode ser gerenciado e monitorado através de Cisco Webex Control Hub.
- Para os dispositivos Room Bar BYOD, esse processo permite ativar o registro de hub de conectividade de rede e de controle, que desbloqueia recursos avançados, como geranciamento de software, visibilidade de periférico e Remote Access.
- Assegure-se de que o dispositivo esteja conectado à rede e acessível por meio do seu endereço IP antes de iniciar o processo de onboarding.
Este processo remoto simplificado de bordo ajuda a simplificar a implantação e o geranciamento de Cisco dispositivos de colaboração em ambientes onde o acesso físico é limitado ou não disponível.
Comportamento do Assistente de Primeira Vez (FTW)
O FTW (First Time Wizard, Assistente de primeira vez) guia o processo inicial de onboarding para Cisco dispositivos de colaboração. Seu comportamento inclui as seguintes ações-chave:
- Início automático do onboard: O FTW começa a bordo assim que o usuário seleciona a opção de onboarding automática na tela Bem-vindo.
- Uso de Padrões configurados: quando disponível, o assistente aplica os padrões configurados como Idioma e Fuso horário.
- Aplicação de pré-configurações: Aplica configurações da Organização, Localização e todas as preconfigurações de dispositivos pendentes definidas no Hub de Controle.
- Solicitando ausência de configurações: O assistente solicita ao usuário que insira quaisquer configurações ainda não configuradas no Hub de controle.
- Instalação de Microsoft equipes: Se a plataforma Microsoft Teams tiver sido selecionada durante o processo Adicionar dispositivo, o assistente instalará Microsoft Equipes no final do onboarding.
- Verificações de hardware manuais: certas tarefas de configuração de hardware, como o posicionamento da câmera, exigem a conclusão manual do usuário.
Limitações e tarefas manuais
- A instalação de hardware físico, como posicionamento da câmera e montagem, ainda deve ser executada manualmente.
- Talvez você precise concluir manualmente certas etapas do Assistente de primeira vez se as configurações padrão correspondentes não estiverem configuradas no Hub de Controle.
- Zero Touch Pairing não está disponível na versão inicial. O suporte para esse recurso está planejado para uma atualização futura.
- A versão atual da Ativação do Zero Touch não é compatível com Webex Edge. Essa funcionalidade será introduzida em uma versão subsequente.
- Não há suporte para o modo pessoal no momento. O suporte para o modo pessoal está planejado para uma atualização futura.
- Procuradores interceptadores de TLS não são suportados atualmente. Para que a Ativação do Toque Zero funcione, o dispositivo deve estabelecer uma conexão direta e confiável com os serviços Webex. Um processo simplificado de inicialização de confiança para esses ambientes está atualmente em desenvolvimento.
- Para implantações que exigem 802.1X ou SCEP, o registro de certificado continua sendo um processo manual e é tratado independentemente da Ativação do Zero Touch. Enquanto uma ferramenta de carregamento de certificado automatizado estiver em desenvolvimento, o fluxo de trabalho atual do Zero Touch supõe que o dispositivo já estabeleceu conectividade de rede com os serviços do Webex.