O processo de onboarding integra uma instância Niagara ao Niagara Cloud Suite, permitindo que um JACE ou Supervisor seja registrado, autenticado e associado à organização correta no Niagara Cloud Portal.
Neste tutorial serão apresentados os principais requisitos de licenciamento, instalação dos módulos necessários, configuração do serviço de conexão e fluxo de registro do dispositivo no Niagara Cloud.
Antes de integrar os dispositivos, organize clientes, projetos e permissões no Niagara Cloud Portal. Essa estrutura facilita a associação correta do JACE ou Supervisor durante o onboarding.
1. Antes de iniciar
Confirme que o JACE ou Supervisor utiliza uma versão suportada pelos serviços do Niagara Cloud Suite contratados.
A instância Niagara deve atender aos requisitos de manutenção e licenciamento exigidos para utilização do Niagara Cloud Suite.
O dispositivo deve possuir a assinatura correspondente ao serviço que será utilizado, como Niagara Remote, Recover ou outro recurso aplicável.
O JACE ou Supervisor precisa conseguir estabelecer comunicação de saída com os serviços do Niagara Cloud.
Utilize uma conta autorizada para a organização e conclua a autenticação multifator quando solicitada.
2. Como funciona o onboarding
O onboarding estabelece uma relação segura entre a station Niagara e o Niagara Cloud Suite. A própria instância inicia a comunicação com o serviço Cloud e fornece as informações necessárias para concluir o registro pelo portal.
JACE ou Supervisor → conexão segura com o Niagara Cloud → Registration URL e User Code → autenticação do integrador → seleção da organização → confirmação da assinatura → emissão do certificado de cliente → dispositivo integrado.
O fluxo do Niagara Cloud Suite utiliza comunicação segura iniciada pelo próprio JACE ou Supervisor. Em condições normais, o dispositivo não precisa ser exposto diretamente à internet por meio de uma conexão de entrada.
3. Verificar conectividade com o Niagara Cloud
Antes de instalar e configurar os serviços Cloud, confirme com o setor de TI que o dispositivo possui acesso à internet e consegue estabelecer as conexões exigidas pelo Niagara Cloud Suite.
| Item | Verificação |
|---|---|
| Internet | O JACE ou Supervisor deve possuir acesso de saída à internet. |
| DNS | A resolução de nomes utilizada pela station deve funcionar corretamente. |
| HTTPS | A comunicação com os serviços Cloud utiliza conexões seguras, normalmente pela porta TCP 443. |
| Firewall / Proxy | Regras corporativas não devem bloquear os endpoints necessários ao Niagara Cloud Suite. |
4. Instalar os módulos do Niagara Cloud Suite
Instale na plataforma os módulos Niagara Cloud Suite compatíveis com a versão do PowerB utilizada. O conjunto de módulos pode variar conforme a release e os serviços contratados.
Nas versões em que o serviço é fornecido pela família cloudLink, a integração utiliza componentes disponibilizados pelos módulos Cloud correspondentes, incluindo o serviço responsável pela conexão com o Niagara Cloud.
Não instale módulos Cloud de outra release sem validar a compatibilidade. Utilize os pacotes correspondentes à versão instalada no JACE ou Supervisor.
5. Adicionar o CloudConnectionService à station
O CloudConnectionService é responsável por estabelecer e manter a comunicação entre a station e os serviços do Niagara Cloud Suite.
Abra a palette Cloud correspondente
Após instalar os módulos, localize a palette relacionada ao Niagara Cloud Suite, como cloudLinkNcs nas versões que utilizam essa estrutura.
Adicione o serviço à station
Arraste o CloudConnectionService para Config → Services.
O conceito do serviço de conexão permanece o mesmo, mas nomes de módulos, componentes ou opções podem mudar entre releases do Niagara Framework.
6. Iniciar o onboarding do dispositivo
Com o serviço instalado e a conectividade disponível, inicie o processo de onboarding no CloudConnectionService.
A station estabelece a comunicação inicial com o Niagara Cloud e gera as informações utilizadas para registrar aquela instância no portal.
7. Obter a Registration URL e o User Code
Durante o processo de onboarding, são apresentados uma Registration URL e um User Code. Essas informações vinculam temporariamente a station à sessão de registro realizada pelo integrador.
Conclua o processo de registro dentro do período de validade apresentado. Se o código expirar antes da conclusão, reinicie o processo de onboarding para obter um novo código.
8. Autenticar no Niagara Cloud Portal
Acesse a Registration URL
Abra no navegador o endereço fornecido pelo CloudConnectionService.
Informe o User Code
Quando solicitado, informe o código apresentado pela station.
Autentique sua conta
Entre com a conta autorizada no Niagara Cloud Portal e conclua a autenticação multifator quando solicitada.
9. Selecionar a organização e concluir o registro
Durante o registro, associe o dispositivo ao cliente e ao ambiente corretos. Confirme também a subscription disponível para aquela instância Niagara.
Selecione o cliente correto
Confirme a organização antes de autorizar o onboarding.
Associe ao projeto correspondente
Quando o portal disponibilizar a organização por projetos, mantenha o dispositivo no projeto relacionado à instalação correspondente.
Confirme a subscription
Selecione ou confirme a assinatura do Niagara Cloud Suite que será utilizada por aquela instância.
O licenciamento e o registro dos serviços Cloud estão associados à instância Niagara. Verifique o Host ID para evitar associar a subscription ao dispositivo incorreto.
10. Certificado utilizado pelo Niagara Cloud
Ao concluir o onboarding, o Niagara Cloud estabelece uma identidade segura para a station e utiliza um Client Certificate nas conexões subsequentes. Esse certificado faz parte do funcionamento do serviço Cloud e permite que o Niagara Cloud reconheça a instância registrada.
O certificado utilizado pela conexão com o Niagara Cloud possui finalidade diferente do certificado configurado no WebService para acesso HTTPS e também é diferente de certificados de usuário utilizados em autenticação SSO.
11. Validar o dispositivo no Niagara Cloud Portal
Após a conclusão do onboarding, retorne ao Niagara Cloud Portal e confirme se a instância aparece na organização correspondente.
O onboarding está concluído quando o JACE ou Supervisor aparece no cliente e projeto corretos, o Host ID corresponde à instância registrada, a conexão Cloud está ativa e os serviços contratados aparecem disponíveis conforme a subscription.
12. Onboarding e ativação dos serviços
Registrar o dispositivo é a etapa que cria a relação entre a station e o Niagara Cloud Suite. Depois disso, cada serviço contratado pode exigir sua própria configuração operacional.
| Etapa | Resultado |
|---|---|
| Onboarding | Registra e autentica o JACE ou Supervisor no Niagara Cloud. |
| Niagara Remote | Disponibiliza acesso remoto seguro à instância quando contratado e configurado. |
| Niagara Recover | Disponibiliza recursos de recuperação e backup quando contratados e configurados. |
| Niagara Data Service | Disponibiliza os recursos de dados Cloud correspondentes à assinatura. |
13. Se o onboarding não for concluído
| Comportamento | O que verificar |
|---|---|
| CloudConnectionService não está disponível. | Confirme a instalação dos módulos Niagara Cloud Suite compatíveis com a versão utilizada. |
| A station não consegue iniciar o onboarding. | Revise internet, DNS, firewall, proxy e acesso HTTPS de saída. |
| O User Code expirou. | Reinicie o onboarding e utilize o novo código dentro do período de validade. |
| A organização desejada não aparece. | Revise as permissões da conta utilizada no Niagara Cloud Portal. |
| A subscription não aparece. | Confirme contratação, Host ID, compatibilidade da instância e disponibilidade da assinatura para o cliente. |
| O onboarding conclui, mas o dispositivo não aparece no projeto esperado. | Revise a organização e o projeto selecionados durante o registro. |
| O dispositivo aparece, mas o serviço Cloud não funciona. | Confirme se o onboarding está ativo e depois valide a configuração específica do serviço contratado. |
| A instância não atende aos requisitos do Cloud Suite. | Revise versão do Niagara, SMA e licenciamento da plataforma. |
14. Vídeo — Niagara Cloud Suite Parte 2
Assista ao vídeo em português utilizado como referência para esta parte da série, com a demonstração do processo de integração de um dispositivo ao Niagara Cloud.
Depois do onboarding, os próximos procedimentos podem detalhar a configuração e o uso de cada serviço do Niagara Cloud Suite, como Niagara Remote, Recover e Data Service.
Artigos relacionados
Ainda precisa de ajuda?
Entre em contato com o suporte técnico da Mercato. Para agilizar o atendimento, informe o equipamento, produto ou sistema relacionado e descreva brevemente a dúvida ou o problema encontrado.
Falar com o suporte no WhatsApp →