Pular para o conteúdo

Por vezes, é necessário e desejável aceder a dados ou executar processos a partir de um sistema remoto que não permite acesso externo. Isto é comum em ambientes empresariais protegidos por firewalls. O PlaidCloud permite fazê-lo através do PlaidLink, que possibilita o acesso a sistemas remotos atrás de uma firewall ou nos casos em que o acesso direto a partir do PlaidCloud não é desejado.

O PlaidLink utiliza um sistema baseado em agentes. Isto significa que um agente, o utilizador remoto, é instalado num sistema no interior da firewall ou de outra área restrita. O agente pode então ligar-se ao PlaidCloud através de um processo de iniciação de saída, numa ligação websocket HTTPS segura. É tão seguro como qualquer outra ligação web cifrada e, normalmente, não exige a abertura de portas não convencionais. Antes de obter acesso, o agente tem de se identificar enviando o seu identificador de agente. A partir daí, se o agente concluir com êxito o processo de autenticação, é-lhe concedido acesso às operações aprovadas.

O PlaidLink pode ser instalado em sistemas Windows, Unix e Linux e pode ser executado com utilizadores de privilégios reduzidos. Em sistemas Windows, o PlaidLink pode funcionar como um serviço do Windows, com controlo total a partir do painel de Serviços. Em sistemas Linux ou Unix, pode ser executado como um processo daemon.

O PlaidLink também pode ser executado como um contentor Docker autónomo ou como um pod do Kubernetes.

Para gerir agentes:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”

Isto leva-o à tabela de Agentes PlaidLink, onde pode ver e modificar a lista de agentes disponíveis e obter as respetivas credenciais.

Para criar um agente:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”
  4. Clique em “Add PlaidLink Agent”
  5. Preencha os campos obrigatórios
  6. Clique em “Create”
  7. Atribua o agente aos grupos de segurança necessários para aceder aos recursos de que precisa para desempenhar a sua função
  8. Atribua o agente às contas de documentos necessárias para aceder aos documentos de que precisa para desempenhar a sua função

Para configurar os agentes PlaidLink no sistema remoto, tem primeiro de obter as informações de identificação do agente, de forma a manter a segurança. Estas informações incluem uma chave pública e uma chave privada.

Para obter estas chaves:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”
  4. Clique no ícone de edição

Isto abre um formulário onde pode ver os valores das chaves pública e privada.

A chave privada e o botão Ver configuração RPC só aparecem aos membros que podem editar agentes; os outros membros veem apenas a chave pública.

É boa prática regenerar periodicamente as chaves pública e privada e atualizar a configuração dos sistemas remotos, de forma a manter a segurança.

Para regenerar as credenciais:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”
  4. Clique no ícone de regeneração

Depois de as credenciais serem regeneradas, podem ser obtidas da mesma forma que as credenciais de um novo agente (descrita acima).

Para desativar um agente:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”
  4. Desmarque a caixa de verificação “Active”

Uma ligação pode ter uma configuração diferente por ambiente, pelo que mudar o ambiente de um projeto reaponta de uma só vez todas as ligações que este utiliza. Os agentes podem acompanhar a mesma mudança.

Cada agente tem duas definições:

  • Agent Group — um nome partilhado pelos agentes que se substituem uns aos outros. Os agentes de um grupo são alternativas para o mesmo trabalho, um por ambiente.
  • Ambiente servido por este agente — o ambiente de ligação que este agente serve. Tem de corresponder ao ambiente na configuração PlaidLink do agente.

Um passo continua a indicar um agente específico. Quando o fluxo de trabalho é executado, o PlaidCloud consulta o grupo a que esse agente pertence e escolhe o membro que serve o ambiente atual do projeto. Assim, um projeto passado do ambiente predefinido para o QA executa os seus passos remotos na máquina de QA, sem editar nenhum passo.

Para um grupo com o nome Finance, com um agente a servir o ambiente Default e outro a servir o QA, um passo que indique qualquer um deles é executado no que corresponder ao projeto — e um projeto que volte a Default é executado no agente Default, mesmo que o passo indique o de QA.

Para atribuir um agente a um ambiente:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “PlaidLink Agents”
  4. Abra o agente
  5. Defina “Agent Group” com um nome partilhado com as alternativas do agente e defina “Ambiente servido por este agente” como o ambiente cujo trabalho executa, por exemplo QA
  6. Na máquina que executa esse agente, defina o nome de ambiente correspondente no ficheiro de configuração do PlaidLink — consulte Fazer corresponder a máquina do agente abaixo

Retirar um agente de um grupo reduz o que o grupo abrange, pelo que tem tanto impacto como adicionar um. Limpar o Group no agente que servia o seu ambiente predefinido deixa os projetos que são executados aí sem destino para onde resolver, e estes falham na execução seguinte. Mova o ambiente para outro membro do grupo antes de remover um. Cada gravação que altera o que um grupo abrange comunica-lhe a nova cobertura.

Os ambientes são partilhados com as ligações, pelo que os nomes de ambiente aqui oferecidos são os mesmos sob os quais configura uma ligação. Consulte Criar e gerir uma ligação.

O ambiente que aqui define tem de corresponder ao ambiente para o qual o serviço PlaidLink dessa máquina está configurado. O PlaidLink subscreve exatamente uma fila para o ambiente indicado no seu ficheiro de configuração, pelo que um agente cujo registo indica QA, mas cuja máquina continua configurada para o ambiente predefinido, está a escutar numa fila diferente daquela para onde o trabalho é enviado. O passo aguarda e depois falha, indicando que o agente não está a receber a tarefa.

Defina-o no bloco environments do ficheiro de configuração do PlaidLink, na entrada desse agente:

environments:
- name: QA
agent_id: <agent identifier>

O name é o nome do ambiente tal como aparece no PlaidCloud. Quando é omitido, o agente serve o ambiente predefinido. Reinicie o serviço PlaidLink depois de o alterar.

O PlaidLink foi concebido para permitir o funcionamento de vários agentes com uma única instalação do serviço. Este sistema de instalação simplificado permite que uma só instalação trate agentes de várias áreas de trabalho e/ou agentes com diferentes níveis de permissões para a execução de tarefas.

Para ativar vários agentes, basta adicionar as credenciais dos agentes ao ficheiro de configuração do PlaidLink.

À semelhança da execução de vários agentes num só serviço PlaidLink, também é possível executar vários serviços PlaidLink.

Por vezes, isto é necessário, consoante a utilização de segurança baseada no sistema ou de restrições de acesso à rede que impedem a comunicação entre fronteiras de rede.

O serviço PlaidLink é extremamente leve e só precisa de um mínimo de computação e memória para funcionar. Ao processar volumes de dados significativos, pode ser necessário aumentar os recursos de computação e, sobretudo, a memória.

Normalmente, o agente funciona sem problemas com 5% de CPU e 200 MB de memória. Para operações de dados intensivas, recomenda-se atribuir um CPU completo e, pelo menos, 4 GB de RAM. Em sistemas de alocação dinâmica de recursos, como o Kubernetes, não há problema se o agente tiver acesso a recursos com capacidade de picos em vez de recursos reservados.

O espaço em disco do agente também é mínimo. As operações do agente utilizam espaço em disco como memória intermédia de dados na transferência de grandes quantidades de dados. Normalmente, 8 GB de espaço são suficientes para operações normais. Para operações de dados intensivas, recomenda-se aumentar o disco de acordo com os volumes de dados esperados. Não há um valor fixo, porque depende de vários fatores, incluindo a velocidade do CPU, a velocidade da rede, a quantidade de dados, etc. No entanto, um bom ponto de partida são 20 GB, ajustando a partir daí.

O agente PlaidLink foi concebido para funcionar com o mínimo de configuração. Não exige nenhuma VPN nem configuração de rede especial, além de permitir o tráfego de rede HTTPS padrão. Os agentes comunicam através do mesmo protocolo do tráfego normal baseado em navegadores web.

O serviço do agente inicia sempre a comunicação com o PlaidCloud, pelo que não é necessário configurar o acesso de entrada nas firewalls.