Zero Touch Provisioning (ZTP) para dispositivos das séries Board, Desk e Room
list-menuComentários?
O Zero Touch Provisioning (ZTP) simplifica a integração de dispositivos usando o endereço MAC do dispositivo em vez de exigir a entrada manual do código de ativação. Os administradores podem pré-configurar dispositivos para espaços de trabalho compartilhados ou atribuí-los diretamente a contas de usuário pessoais. As implantações Webex Edge suportadas também podem usar ZTP com chamadas locais enquanto o dispositivo permanece registrado na infraestrutura de chamadas locais.

Disponibilidade:

O provisionamento Zero-Touch (ZTP) está geralmente disponível (GA) para dispositivos compatíveis que executam o RoomOS 26.5.0 ou posterior.

Principais benefícios

  • Registro automático de dispositivos: os dispositivos podem ser integrados usando seu endereço MAC quando atribuídos a um espaço de trabalho compartilhado ou a uma conta de usuário pessoal, reduzindo a necessidade de entrada manual do código de ativação quando a integração do endereço MAC é usada. Webex Edge As implantações suportadas podem usar o mesmo processo com o Premises Calling.
  • Configuração simplificada: aproveitando as configurações e pré-configurações padrão do Control Hub, a experiência do First Time Wizard (FTW) é simplificada, reduzindo significativamente as etapas manuais durante a configuração do dispositivo físico.
  • Operações em massa eficientes: os dispositivos podem ser adicionados em massa importando arquivos CSV contendo endereços MAC, permitindo implantações em grande escala com o mínimo esforço.
  • Capacidade de pré-ativação: os dispositivos podem ser ativados com antecedência, mesmo antes de se conectarem à rede. Os dispositivos podem ser pré-configurados para um espaço de trabalho ou uma conta de usuário pessoal.
  • Complexidade reduzida de integração: ao automatizar a integração de rede e o provisionamento de dispositivos, o ZTP reduz o tempo, o custo e a complexidade tradicionalmente associados à configuração do dispositivo.

Termos-chave para integração de dispositivos no Control Hub

  • Não reivindicado: o endereço MAC do dispositivo não está registrado em sua organização.
  • Reivindicado: o endereço MAC do dispositivo foi adicionado à sua organização.
  • Não atribuído: um dispositivo reivindicado que ainda não foi vinculado a um espaço de trabalho ou conta de usuário pessoal.
  • Atribuído: um dispositivo reivindicado vinculado a um espaço de trabalho ou a uma conta de usuário pessoal.
  • Pendente: o status exibido no Control Hub para um dispositivo que foi reivindicado e/ou atribuído, mas ainda não está on-line.
  • Pré-configuração: o processo de aplicar as configurações do dispositivo a um dispositivo pendente antes que ele se conecte à rede ou fique on-line.
  • Ativado: o dispositivo concluiu o Webex aplicável ou o processo de Webex Edge ativação.
  • Dispositivo pessoal: um dispositivo atribuído a uma conta de usuário em vez de a um espaço de trabalho.
  • Webex Edge: um modelo de implantação no qual o dispositivo permanece registrado na infraestrutura local enquanto recebe recursos e gerenciamento de nuvem compatíveis. Veja Webex Edgea documentação.

Requisitos

Certifique-se de que seu ambiente atenda a esses requisitos antes da implantação:

  • Versão do software: Os dispositivos devem executar o RoomOS 26.5.0 ou posterior. O RoomOS 11 não é suportado.
  • Conectividade de rede: os dispositivos exigem acesso confiável à rede com conectividade aos serviços Webex.
  • Padrões de configuração: defina padrões de organização e localização no Control Hub para formato de horário, fuso horário e idioma para minimizar as solicitações de integração durante o First Time Wizard (FTW).

Para o modo pessoal, o usuário já deve existir no Control Hub antes que o dispositivo seja atribuído.

Para Webex Edge ZTP, a descoberta CUCM/TFTP deve estar disponível quando exigida pela implantação, incluindo a opção 150 de DHCP quando usada. Valide o comportamento do AllowDataLogging e resolva quaisquer conflitos entre as configurações controladas pelo CUCM e controladas pelo Control Hub antes da integração.

Pré-requisitos: Atualizar para a versão mínima para ativação Zero Touch

Para atualizar para a versão 26.5, você precisará realizar a atualização manualmente por enquanto. Nos próximos meses, um recurso de atualização pré-integrado automatizará esse processo e as imagens de fábrica serão atualizadas adequadamente. Até lá, os clientes devem fazer o upgrade usando os links do pacote ou a interface xcommand para instalar a atualização e, em seguida, realizar uma redefinição de fábrica para concluir o processo.

Versão do software durante a integração: Se um dispositivo estiver abaixo da versão de integração FTW, a ZTP poderá atualizá-lo antes do registro. Essa atualização ocorre independentemente do canal do software do espaço de trabalho, incluindo um canal definido por meio da configuração de dispositivo pendente. Após a conclusão do ZTP, as regras normais de software do espaço de trabalho são aplicadas e o dispositivo pode ser atualizado ou rebaixado para a versão exigida por esse canal. Esse comportamento é esperado. Dispositivos Microsoft Teams Rooms: Se o ZTP atualizar um dispositivo MTR para uma versão posterior à versão atribuída ao seu canal aprovado pela Microsoft, o dispositivo não fará o downgrade automaticamente enquanto estiver operando no modo MTR.

Mapeamento e comandos de pacotes

Selecione o pacote apropriado com base no seu hardware. Use o xCommand fornecido para iniciar a atualização.

Categoria de dispositivoNome do pacote
Cisco Room Navigator bifrost.pkg
Produtos mais recentes (Codec Pro G2, Desk Pro G2) luna.pkg
Endpoints RoomOS padrão (Room Bar, Room Kit EQ, Board Pro, Desk, Codec Pro) zenith.pkg

Para a CiscoRoom Navigator:


xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True

Para o Codec Pro G2 e o 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, Desk e Codec Pro:


xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True

Atualmente, as instalações do Microsoft Teams não são suportadas por meio de instaladores de pacotes. Estamos aguardando o lançamento do arquivo COP (Cisco Option Package) necessário, que está programado para estar disponível até o final deste mês.

Iniciando a ativação Zero Touch por meio da CLI

Você pode acionar manualmente o processo de ativação Zero Touch usando a interface de linha de comando (CLI) ou a API. Use o comando a seguir para iniciar o fluxo de trabalho:


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. 

Etapas de configuração no Control Hub

  1. Configurar padrões

    A configuração de padrões ajuda o dispositivo a ignorar as etapas de configuração manual durante a integração. Navegue até o Control Hub e configure o seguinte:

    • Hora -> Formato de hora (por exemplo, 12h/24h)
    • Horário -> Fuso (por exemplo, America/New_York)
    • Interface de usuário -> Idioma (por exemplo, inglês)

    Opcionalmente, atribua o espaço de trabalho ao local em que esses padrões estão configurados ou aplique os padrões em toda a organização.

    Antes de usar o Zero Touch Activation, confirme se o dispositivo não requer chamadas híbridas. Os dispositivos que exigem chamadas híbridas devem ser integrados usando o código de ativação ou o fluxo de trabalho de integração manual.

    Location configuration defaults
  2. Adicione o dispositivo pelo endereço MAC
    1. Vá para Control Hub -> Dispositivos -> Adicionar dispositivo (ou Criar espaço de trabalho). Você também pode começar em Usuários, selecionar um usuário, abrir a guia Dispositivos e selecionar Adicionar dispositivo.
    2. Selecione Dispositivo de sala ou mesa Cisco, escolha Uso compartilhado ou Uso pessoal e selecione Endereço MAC. Insira o endereço MAC Ethernet com fio, o tipo de produto e a plataforma (RoomOS ou Microsoft Teams). Se você selecionar Microsoft Teams, a plataforma será instalada automaticamente após a conclusão do assistente.
    3. Para um dispositivo pessoal, selecione a conta de usuário à qual atribuí-lo. Para uma Webex Edge implantação compatível, selecione Chamada no local quando disponível e siga o caminho de provisionamento CUCM/local configurado.
    4. Se o dispositivo já estiver reivindicado, mas não atribuído, abra o dispositivo no Control Hub, selecione Atribuir e escolha Atribuir um dispositivo a um usuário. Os dispositivos reivindicados que ainda não se conectaram aparecem como pendentes.

    Add device by MAC address

    Consulte a seção Localizar a etiqueta física do endereço MAC do seu dispositivo e saiba como encontrar o endereço MAC do dispositivo.

    Você pode filtrar todos os dispositivos que foram reivindicados, estejam eles atualmente online ou offline, usando o filtro de propriedade na página de dispositivos e selecionando Reivindicado.

    Claimed devices list
  3. Aplique pré-configurações a dispositivos pendentes (opcional, recomendado)

    Você pode aplicar pré-configurações no nível do dispositivo antes que o dispositivo fique on-line para qualquer configuração compatível, seguindo estas etapas:

    • Abra a página do dispositivo pendente no Control Hub.
    • Clique em “Todas as configurações”.
    • Aplique as configurações necessárias.

    Durante a integração, o dispositivo consome as configurações dessas fontes em ordem hierárquica:

    • Padrões no nível da organização
    • Padrões em nível de localização
    • Pré-configurações em nível de dispositivo no dispositivo pendente

    As configurações definidas em qualquer um desses níveis são aplicadas automaticamente durante o fluxo de integração do First Time Wizard.

    Pending device page has configuration settings available

    Para que o assistente de integração automática seja concluído com êxito, as seguintes configurações devem ser definidas:

    Todos os dispositivos:

    • Hora > Formato de hora (por exemplo, 12h/24h)
    • Horário > Fuso (por exemplo, America/New_York)
    • Interface de usuário > Idioma (por exemplo, inglês)

    Somente a série Board:

    • Áudio > Posicionamento (montagem na parede, independente)

    Resultado:

    • Dependendo do método de integração, o dispositivo aparece como Reivindicado, Atribuído ou Pendente. Quando o dispositivo se conecta, ele completa a integração automática.
    • Ele é pré-configurado com configurações de localização e nível de dispositivo.
    • Quando o dispositivo de redefinição de fábrica se conectar à rede, ele será registrado e integrado automaticamente.

Localize a etiqueta física do endereço MAC do seu dispositivo

Se você não conseguir localizar seu endereço MAC, ele normalmente é impresso na etiqueta do produto encontrada na parte traseira ou inferior do seu dispositivo. Essa etiqueta geralmente inclui outros identificadores importantes, como o número de série e o ID do produto. Para muitos produtos Cisco, a etiqueta de endereço MAC está claramente marcada e pode ser encontrada no chassi ou em uma bandeja de etiquetas. Se você não conseguir localizá-lo fisicamente, alguns dispositivos também permitem que você visualize o endereço MAC por meio da interface do usuário ou da página da Web nas configurações de informações do produto ou do sistema.

Locate MAC address

Processo de integração

Webex Edgesuporta sequências de integração que priorizam o dispositivo e a nuvem. Dependendo da implantação, o dispositivo pode descobrir primeiro as configurações do CUCM/TFTP e depois concluir a Webex Edge ativação, ou usar sua atribuição do Control Hub antes de se conectar ao ambiente de provisionamento local.

Depois que o dispositivo for reivindicado e atribuído no Control Hub:

  1. Verifique se o dispositivo foi redefinido para as configurações de fábrica.
  2. Conecte o dispositivo à rede.
  3. Na tela de boas-vindas, selecione a opção de integração automática.
    Device activation in progress
    Ativação do dispositivo em andamento
  4. Siga todas as instruções restantes para itens não configurados no Control Hub.
    • Se você não tiver concluído determinadas configurações durante a pré-configuração, o assistente de configuração solicitará que você configure esses itens durante a integração do dispositivo.
    • 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 de integração automática não for exibida, verifique o seguinte:

  • O endereço MAC foi inserido corretamente e atribuído ao espaço de trabalho pretendido ou à conta de usuário pessoal
  • O dispositivo foi redefinido para as configurações de fábrica.
  • O dispositivo verificou o acesso à Internet aos serviços Webex.
  • O dispositivo está executando a versão mínima de software necessária (RoomOS 26.5.0+).

Integração de dispositivos em massa (CSV)

Use o processo de integração em massa para solicitar e atribuir vários dispositivos em uma única importação.

  1. No Control Hub, navegue até Dispositivos e clique em Adicionar dispositivo.
  2. Selecione Adicionar dispositivos em massa.
    Bulk add devices page
    Adicionar dispositivos em massa
  3. No menu suspenso do modelo, escolha o modelo de integração sem toque e baixe o arquivo CSV.
    Zero touch template selection
    Seleção de modelo Zero Touch
  4. Preencha o arquivo CSV com as informações do dispositivo e da tarefa, garantindo que todos os campos obrigatórios sejam preenchidos. Para dispositivos do Modo Pessoal, insira o endereço de e-mail do usuário na coluna Conta. O comportamento existente do CSV compartilhado e do espaço de trabalho permanece inalterado.
  5. Faça o upload do arquivo CSV completo e envie a importação.
  6. Abra a página Tarefas para monitorar o andamento da importação e baixar um arquivo CSV com erro se alguma linha falhar.
    Bulk import task status
    Status da tarefa de importação em massa
  7. Verifique os dispositivos importados na lista de dispositivos, onde eles podem aparecer inicialmente como Reivindicados e Pendentes antes da primeira conexão.
    Imported devices in pending state
    Dispositivos importados em estado pendente

Integração de páginas da Web do dispositivo (remota)

Use a página da web do dispositivo para integração remota quando você não tiver acesso físico à interface do dispositivo. Esse método é especialmente útil para implantações sem um dispositivo Room Navigator conectado, como os dispositivos Room Bar BYOD e Room Bar Pro BYOD.

  1. Abra um navegador da Web e insira o endereço IP do dispositivo na barra de endereço.
  2. Faça login usando o nome de usuário admin sem senha.
    Device web page home
    Página inicial da página web do dispositivo
  3. Na página da web do dispositivo, abra a página do sistema e clique em Registrar no Webex.
    Register to Webex dialog
    Registre-se no Webex
  4. Na caixa de diálogo de registro, clique em Iniciar integração automática para iniciar o processo. A integração automática também oferece suporte a dispositivos que foram atribuídos a uma conta de usuário pessoal. Para Webex Edge implantações suportadas, o dispositivo continua pelo caminho de provisionamento CUCM/local configurado.
    Automatic onboarding started
    A integração automática foi iniciada
  5. Aguarde o início da integração. Em seguida, verifique o estado do dispositivo e o status do registro no Control Hub para garantir uma integração bem-sucedida.

Informações adicionais

  • Esse método de integração permite que você configure e gerencie dispositivos remotamente sem precisar de uma interação física Room Navigator ou direta com o dispositivo.
  • Após o registro, o dispositivo pode ser gerenciado e monitoradoCisco Webex Control Hub.
  • Para dispositivos BYOD do Room Bar, esse processo permite a conectividade de rede e o registro do Control Hub, que desbloqueia recursos avançados, como gerenciamento de software, visibilidade periférica e acesso remoto.
  • Certifique-se de que o dispositivo esteja conectado à rede e acessível por meio de seu endereço IP antes de iniciar o processo de integração.

Esse processo simplificado de integração remota ajuda a simplificar a implantação e o gerenciamento dos dispositivos de colaboração da Cisco em ambientes onde o acesso físico é limitado ou indisponível.

Comportamento do First Time Wizard (FTW)

O First Time Wizard (FTW) orienta o processo inicial de integração dos dispositivos de colaboração da Cisco. Seu comportamento inclui as seguintes ações-chave:

  • Início automático da integração: O FTW começa a integração quando o usuário seleciona a opção de integração automática na tela de boas-vindas. O FTW reconhece se o dispositivo é compartilhado ou pessoal. Os dispositivos pessoais usam a conta de usuário atribuída e não exigem a entrada manual do código de ativação quando a integração baseada em Mac é selecionada. Observe que os dispositivos do modo pessoal não concluirão o assistente até serem desbloqueados pelo usuário pretendido. Se um PIN for definido na conta do usuário, ele precisará desbloqueá-lo primeiro ou acessar https://user.webex.com/ para redefinir o PIN. Se eles não usarem um pino, precisarão primeiro emparelhar com o dispositivo (código QR, ultrassom ou usb-c) antes de desbloqueá-lo.
  • Webex EdgeProvisionamento: Para implantações suportadas, o FTW preserva o caminho de provisionamento CUCM/TFTP antes de concluir a ativação. Webex Edge
  • Uso de padrões configurados: quando disponível, o assistente aplica padrões configurados, como idioma e fuso horário.
  • Aplicação de pré-configurações: aplica configurações da organização, localização e quaisquer pré-configurações de dispositivos pendentes definidas no Control Hub.
  • Solicitando configurações ausentes: O assistente solicita que o usuário insira qualquer configuração que ainda não esteja definida no Control Hub.
  • Instalação do Microsoft Teams: Se a plataforma Microsoft Teams foi selecionada durante o processo Adicionar dispositivo, o assistente instalará o Microsoft Teams no final da integração.
  • Verificações manuais de hardware: Certas tarefas de configuração de hardware, como posicionamento da câmera, exigem a conclusão manual pelo usuário.

Limitações e tarefas manuais

  • A instalação física do hardware, como posicionamento e montagem da câmera, ainda deve ser executada manualmente.
  • A atribuição de um endereço MAC por autoatendimento do User Hub não é suportada.
  • Não há suporte para alterar um dispositivo entre os principais modos de chamada após o registro.
  • Talvez seja necessário concluir manualmente algumas etapas do First Time Wizard se as configurações padrão correspondentes não estiverem definidas no Control Hub.
  • Chamada híbrida: a chamada híbrida não é suportada pelo Zero Touch Provisioning. Não provisione dispositivos que exijam chamadas híbridas usando o fluxo de trabalho ZTP. Em vez disso, use o código de ativação existente ou o fluxo de trabalho de integração manual. A opção Hybrid Calling não aparece no fluxo de configuração do ZTP; isso é esperado.
  • O Zero Touch Pairing não está disponível na versão inicial. O suporte para esse recurso está planejado para uma atualização futura.
  • No momento, não há suporte para proxies de interceptação de TLS. Para que a ativação Zero Touch funcione, o dispositivo deve estabelecer uma conexão direta e confiável com os serviços Webex. Um processo simplificado de bootstrap de confiança para esses ambientes está atualmente em desenvolvimento.
  • Para implantações que exigem 802.1X ou SCEP, o registro do certificado continua sendo um processo manual e é feito independentemente da ativação Zero Touch. Embora uma ferramenta automatizada de carregamento de certificados esteja atualmente em desenvolvimento, o fluxo de trabalho atual do Zero Touch pressupõe que o dispositivo já tenha estabelecido a conectividade de rede com os serviços Webex.

Este artigo foi útil?
Este artigo foi útil?