Partilhar via

Implantar o agente de segurança baseado em C# do Defender for IoT para Linux

  • Artigo

Este guia explica como instalar e implantar o agente de segurança baseado em C# do Defender for IoT no Linux.

Neste guia, ficará a saber como:

  • Instalar
  • Verificar a implementação
  • Desinstalar o agente
  • Resolver problemas

Pré-requisitos

Para outras plataformas e tipos de agente, consulte Escolha o agente de segurança certo.

  1. Para implantar o agente de segurança, são necessários direitos de administrador local na máquina em que você deseja instalar.

  2. Crie um microagente Defender-IoT para o dispositivo.

Instalação

Para implantar o agente de segurança, use as seguintes etapas:

  1. Transfira a versão mais recente para a sua máquina a partir do GitHub.

  2. Extraia o conteúdo do pacote e navegue até a pasta /Install .

  3. Adicione permissões de execução ao script InstallSecurityAgent executando chmod +x InstallSecurityAgent.sh

  4. Em seguida, execute o seguinte comando com privilégios de raiz:

    ./InstallSecurityAgent.sh -i -aui <authentication identity>  -aum <authentication method> -f <file path> -hn <host name>  -di <device id> -cl <certificate location kind>

    Para obter mais informações sobre parâmetros de autenticação, consulte Como configurar a autenticação.

Este script executa as seguintes ações:

  • Instala pré-requisitos.

  • Adiciona um usuário de serviço (com o login interativo desabilitado).

  • Instala o agente como um Daemon - assume que o dispositivo usa systemd para modelo de implantação herdado.

  • Configura sudoers para permitir que o agente execute determinadas tarefas como root.

  • Configura o agente com os parâmetros de autenticação fornecidos.

Para obter ajuda adicional, execute o script com o parâmetro –help: ./InstallSecurityAgent.sh --help

Desinstalar o agente

Para desinstalar o agente, execute o script com o parâmetro –u: ./InstallSecurityAgent.sh -u.

Nota

A desinstalação não remove nenhum pré-requisito ausente que foi instalado durante a instalação.

Resolução de Problemas

  1. Verifique o status da implantação executando:

    systemctl status ASCIoTAgent.service

  2. Habilite o registro em log. Se o agente falhar ao iniciar, ative o registro em log para obter mais informações.

    Ative o registo por:

    1. Abra o arquivo de configuração para edição em qualquer editor Linux:

      vi /var/ASCIoTAgent/General.config

    2. Edite os seguintes valores:

      <add key="logLevel" value="Debug"/>
<add key="fileLogLevel" value="Debug"/>
<add key="diagnosticVerbosityLevel" value="Some" />
<add key="logFilePath" value="IotAgentLog.log"/>

      O valor logFilePath é configurável.

      Nota

      Recomendamos desativar o logoff após a conclusão da solução de problemas. Deixar o registro em log aumenta o tamanho do arquivo de log e o uso de dados.

    3. Reinicie o agente executando:

      systemctl restart ASCIoTAgent.service

    4. Exiba o arquivo de log para obter mais informações sobre a falha.

      O local do arquivo de log é: /var/ASCIoTAgent/IotAgentLog.log

      Altere o caminho do local do arquivo de acordo com o nome escolhido para o logFilePath na etapa 2.

Próximos passos