Tutorial: Instalar o micro agente do Defender para IoT

Este tutorial irá ajudá-lo a aprender a instalar e autenticar o micro agente do Defender para IoT.

Neste tutorial, ficará a saber como:

• Transferir e instalar o micro agente
• Autenticar o micro agente
• Validar a instalação
• Testar o sistema
• Instalar uma versão específica do micro agente

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

• Um hub IoT.

• Verifique se está a executar um dos seguintes sistemas operativos.

• Tem de ter ativado Microsoft Defender para IoT no seu Hub IoT do Azure.

• Tem de ter adicionado um grupo de recursos à sua solução de IoT.

• Tem de ter criado um módulo duplo do micro agente do Defender para IoT.

Transferir e instalar o micro agente

Dependendo da configuração, o pacote Microsoft adequado terá de ser instalado.

Para adicionar o repositório de pacotes da Microsoft adequado:

1. Transfira a configuração do repositório que corresponde ao sistema operativo do seu dispositivo.

   • Para ubuntu 18.04:

     curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
     

   • Para ubuntu 20.04:

         curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list > ./microsoft-prod.list
     

   • Para Debian 9 (AMD64 e ARM64):

     curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list
     

2. Utilize o seguinte comando para copiar a configuração do repositório para o sources.list.d diretório:

   sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
   

3. Instale a chave pública do Microsoft GPG com o seguinte comando:

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
   

4. Certifique-se de que atualizou o apt com o seguinte comando:

   sudo apt-get update
   

5. Utilize o seguinte comando para instalar o pacote de micro agente do Defender para IoT no Debian ou distribuições do Linux baseadas em Ubuntu:

   sudo apt-get install defender-iot-micro-agent 
   

Ligar através de um proxy

Este procedimento descreve como pode ligar o micro agente do Defender para IoT ao Hub IoT através de um proxy.

Para configurar ligações através de um proxy:

1. No seu computador micro agente, crie um /etc/defender_iot_micro_agent/conf.json ficheiro com o seguinte conteúdo:

   {
       "IothubModule_ProxyConfig": "<proxy_ipv4>,<port>,<username>,<password>",
       "IothubModule_TransportProtocol": "MQTT_WebSocket_Protocol"
   }
   

   Os campos utilizador e palavra-passe são opcionais. Se não precisar deles, utilize a seguinte sintaxe:

   {
       "IothubModule_ProxyConfig": "<proxy_ipv4>,<port>",
       "IothubModule_TransportProtocol": "MQTT_WebSocket_Protocol"
   }
   
   

2. Elimine qualquer ficheiro em cache em /var/lib/defender_iot_micro_agent/cache.json.

3. Reinicie o micro agente. Executar:

   sudo systemctl restart defender-iot-micro-agent.service
   

Adicionar suporte de protocolo AMQP

Este procedimento descreve os passos adicionais necessários para suportar o protocolo AMQP.

Para adicionar suporte de protocolo AMQP:

1. No seu computador micro agente, abra o /etc/defender_iot_micro_agent/conf.json ficheiro e adicione o seguinte conteúdo:

   {
   "IothubModule_TransportProtocol": "AMQP_Protocol"
   }
   

2. Elimine qualquer ficheiro em cache em /var/lib/defender_iot_micro_agent/cache.json.

3. Reinicie o micro agente. Executar:

   sudo systemctl restart defender-iot-micro-agent.service
   

Para adicionar suporte do protocolo AMQP através do socket Web:

1. No seu computador micro agente, abra o /etc/defender_iot_micro_agent/conf.json ficheiro e adicione o seguinte conteúdo:

   {
   "IothubModule_TransportProtocol": "AMQP_WebSocket_Protocol"
   }
   

2. Elimine qualquer ficheiro em cache em /var/lib/defender_iot_micro_agent/cache.json.

3. Reinicie o micro agente. Executar:

   sudo systemctl restart defender-iot-micro-agent.service
   

O agente irá utilizar este protocolo e comunicar com o Hub IoT na porta 443. A configuração do Proxy http é suportada para este protocolo, caso o proxy também esteja configurado, a porta de comunicação com o proxy será definida na configuração do proxy.

Autenticar o micro agente

Existem duas opções que podem ser utilizadas para autenticar o micro agente do Defender para IoT:

• Autenticar com uma cadeia de ligação de identidade de módulo.

• Autenticar com um certificado.

Autenticar com uma cadeia de ligação de identidade de módulo

Terá de copiar a cadeia de ligação de identidade do módulo a partir dos detalhes de identidade do módulo DefenderIoTMicroAgent.

Para copiar a cadeia de ligação da identidade do módulo:

1. Navegue para o Hub IoT>Your hub>Dispositivos de gestão> dedispositivos.

   

2. Selecione um dispositivo na lista ID do Dispositivo.

3. Selecione o separador Identidades do Módulo .

4. Selecione o módulo DefenderIotMicroAgent na lista de identidades do módulo associadas ao dispositivo.

   

5. Copie a cadeia de ligação (chave primária) ao selecionar o botão copiar .

   

6. Crie um ficheiro com o nome connection_string.txt que contém a cadeia de ligação copiada codificada em utf-8 no caminho do diretório /etc/defender_iot_micro_agent do agente do Defender para IoT ao introduzir o seguinte comando:

   sudo bash -c 'echo "<connection string>" > /etc/defender_iot_micro_agent/connection_string.txt'
   

   O connection_string.txt estará agora localizado na seguinte localização /etc/defender_iot_micro_agent/connection_string.txtdo caminho .

   Nota

   A cadeia de ligação inclui uma chave que permite o acesso direto ao próprio módulo, pelo que inclui informações confidenciais que só devem ser utilizadas e legíveis pelos utilizadores de raiz.

7. Reinicie o serviço com este comando:

   sudo systemctl restart defender-iot-micro-agent.service 
   

Autenticar com um certificado

Para autenticar com um certificado:

1. Procure um certificado ao seguir estas instruções.

2. Coloque a parte pública codificada por PEM do certificado e a chave privada, em , em /etc/defender_iot_micro_agentficheiros chamados certificate_public.pem, e certificate_private.pem.

3. Coloque a cadeia de ligação adequada no connection_string.txt ficheiro. A cadeia de ligação deve ter o seguinte aspeto:

   HostName=<the host name of the iot hub>;DeviceId=<the id of the device>;ModuleId=<the id of the module>;x509=true

   Esta cadeia alerta o agente do Defender para IoT para esperar que seja fornecido um certificado para autenticação.

4. Reinicie o serviço com o seguinte comando:

   sudo systemctl restart defender-iot-micro-agent.service
   

Validar a instalação

Para validar a instalação:

1. Utilize o seguinte comando para garantir que o micro agente está a ser executado corretamente:

   systemctl status defender-iot-micro-agent.service
   

2. Certifique-se de que o serviço está estável ao certificar-se de activeque é e que o tempo de atividade do processo é adequado.

   

Testar o sistema

Pode testar o sistema ao criar um ficheiro de acionador no dispositivo. O ficheiro de acionador fará com que a análise da linha de base no agente detete o ficheiro como uma violação da linha de base.

1. Crie um ficheiro no sistema de ficheiros com o seguinte comando:

   sudo touch /tmp/DefenderForIoTOSBaselineTrigger.txt
   

2. Certifique-se de que a área de trabalho do Log Analytics está anexada ao hub IoT. Para obter mais informações, veja Criar uma área de trabalho do Log Analytics.

3. Reinicie o agente com o comando:

   sudo systemctl restart defender-iot-micro-agent.service
   

Aguarde até uma hora para que a recomendação seja apresentada no hub.

É criada uma recomendação de linha de base denominada "IoT_CISBenchmarks_DIoTTest". Pode consultar esta recomendação a partir do Log Analytics da seguinte forma:

SecurityRecommendation

| where RecommendationName contains "IoT_CISBenchmarks_DIoTTest"

| where DeviceId contains "<device-id>"

| top 1 by TimeGenerated desc

Por exemplo:

Instalar uma versão específica do micro agente

Pode instalar uma versão específica do micro agente com um comando específico.

Para instalar uma versão específica do micro agente do Defender para IoT:

1. Abra um terminal.

2. Execute o seguinte comando:

   sudo apt-get install defender-iot-micro-agent=<version>
   

Limpar os recursos

Não existem recursos para limpar.

Passos seguintes

Configurar Microsoft Defender para a solução baseada no agente IoT