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

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

Neste guia, você aprenderá a:

  • Instalar
  • Verificar a implantação
  • Desinstalar o agente
  • Solucionar problemas

Pré-requisitos

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

  1. Para implantar o agente de segurança, os direitos de administrador local são necessários no computador no qual você deseja instalar.

  2. Crie um micro-agente do Defender IoT para o dispositivo.

Instalação

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

  1. Baixe a versão mais recente em seu computador do GitHub.

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

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

  4. Em seguida, execute o seguinte comando com privilégios 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.

O script executa as ações a seguir:

  • Instala os pré-requisitos.

  • Adiciona um usuário de serviço (com entrada interativa desabilitada).

  • Instala o agente como um Daemon - pressupõe que o dispositivo usa systemd como modelo de implantação legado.

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

  • 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.

Observação

A desinstalação não remove os pré-requisitos ausentes que foram instalados durante a instalação.

Resolução de problemas

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

    systemctl status ASCIoTAgent.service

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

    Ative o registro de log:

    1. Abra o arquivo de configuração para edição em qualquer editor do 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.

      Observação

      É recomendável desativar o registro em log após a conclusão da solução de problemas. Deixar o log ativado 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óximas etapas

  • Last updated on