Integração de Agentes Híbridos

A Integração Híbrida aplica-se à situação em que uma empresa que utiliza Altium 365 deseja integrar seu Workspace a um sistema PLM hospedado localmente, dentro da rede da empresa, que não possui um endereço IP público — ou seja, não está exposto à internet.

Para isso, um pequeno programa chamado Hybrid Agent é executado dentro da rede da empresa. Esse programa se comunica com o Altium 365, retransmitindo informações entre o Workspace do Altium 365 e o sistema PLM dentro da rede fechada. A comunicação com o Hybrid Agent é feita por HTTPS e não há necessidade de abrir portas de rede para tráfego de entrada vindo da internet. A porta HTTPS padrão 443 é necessária apenas para tráfego de saída.

Configurar a Integração Híbrida

Baixe o arquivo do Agent () e descompacte seu conteúdo em um local conhecido. Ele contém um aplicativo Java (hybrid-agent.jar) que precisa ser executado em uma máquina dentro da rede da empresa, a partir da qual o sistema PLM local e o Altium 365 possam ser acessados.

Essa máquina not não precisa estar acessível publicamente pela internet, mas precisa ser capaz de se conectar ao ambiente do Altium 365 que sua empresa utiliza.

Depois que o aplicativo Hybrid Agent estiver no lugar:

1. Gere a chave de API na página Hybrid Agent do Workspace do Altium 365 ().
2. Crie uma variável de ambiente HYBRID_AGENT_API_KEY com a chave de API como valor.

3. Execute agent.bat usando o seguinte contexto de comando, no qual o argumento do parâmetro de URL deve ser o do seu Workspace do Altium 365:
   agent.bat https://acme.365.altium.com

Quando estiver ativo, o Hybrid Agent gerará um arquivo de log na pasta hybrid-agent\logs do aplicativo.

É altamente recomendável executar o Hybrid Agent como um serviço do Windows no ambiente de produção, em vez de diretamente no terminal, embora este último possa ser usado para testes.

Um exemplo de abordagem para executar o Hybrid Agent como um serviço do Windows usando o gerenciador de serviços NSSM:

1. Execute o comando: nssm install HybridAgent.
2. Na janela de diálogo do NSSM (na guia Application), insira o caminho do arquivo agent.bat no campo Path e a URL do seu Workspace no campo Arguments, e clique em Install service.
   1. Você pode definir o comportamento de inicialização do serviço com a opção Startup type na guia Details da janela de diálogo do NSSM. Se necessário, execute nssm edit HybridAgent para fazer essas alterações.
   2. Como alternativa à criação das variáveis de ambiente padrão PATH e JAVA_HOME para Java, elas podem ser adicionadas na guia Environment do NSSM. Com essa abordagem, as variáveis estarão ativas somente quando o serviço HybridAgent estiver em execução.

   3. Da mesma forma que acima, a variável HYBRID_AGENT_API_KEY também pode ser movida para a configuração de ambiente do NSSM, de modo que fique ativa quando o serviço estiver em execução.

3. Inicie o serviço HybridAgent com a ferramenta de gerenciamento Services do Windows, ou com o comando do NSSM: nssm start HybridAgent. Isso não é necessário (após reiniciar o PC) se o serviço estiver configurado para inicialização automática.
4. Certifique-se de que o serviço HybridAgent esteja em execução na ferramenta de gerenciamento Services do Windows, ou com o comando do NSSM: nssm status HybridAgent.

Depois que o Hybrid Agent estiver conectado ao seu Workspace do Altium 365 (atualize a janela do navegador para verificar o status), você poderá prosseguir com a configuração da Integração PLM no Workspace do Altium 365. Na página Add Configuration, habilite a opção de conexão Hybrid Agent e insira a URL do seu PLM local, conforme vista dentro da sua rede fechada, no campo URL.