Tutorial: Instalar o microagente do Defender para IoT

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

Neste tutorial, irá aprender a:

Pré-requisitos

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

• Um hub de 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.

• Você precisa ter criado um módulo gêmeo do microagente do Defender para IoT.

Transferir e instalar o micro agente

Consoante a 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 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 de Linux baseadas no 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 de protocolo AMQP através de 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 utilizará este protocolo e comunicará com o Hub IoT na porta 443. A configuração do Proxy HTTP é suportada para este protocolo. No caso de o proxy também estar configurado, a porta de comunicação com o proxy será definida na configuração do proxy.

Autenticar o microagente

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

• Autenticar usando uma string de conexão de identidade de módulo.

• Autenticar com um certificado.

Autenticar-se usando uma cadeia de conexão de identidade do módulo

Você precisará copiar a cadeia de conexão de identidade do módulo dos detalhes de identidade do módulo DefenderIoTMicroAgent.

Para copiar a string de conexão da identidade do módulo:

1. Navegue até Hub IoT>Your hub>Gerenciamento de dispositivos>Dispositivos.

   

2. Selecione um dispositivo na lista de ID do dispositivo.

3. Selecione a guia Identidades do Módulo.

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

   

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

   

6. Crie um arquivo chamado connection_string.txt contendo a string de conexão copiada e codificada em utf-8 no caminho do diretório /etc/defender_iot_micro_agent do agente do Defender para IoT digitando o seguinte comando:

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

   O connection_string.txt agora estará localizado no seguinte caminho /etc/defender_iot_micro_agent/connection_string.txt.

   Observação

   O cadeia de conexã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 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. Para obter um certificado, siga estas instruções.

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

3. Coloque a string de conexão adequada no arquivo connection_string.txt. A string de conexão deve ser semelhante a esta:

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

   Esta cadeia de caracteres alerta o agente do Defender para IoT de que um certificado deverá ser fornecido 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. Verifique se o serviço está estável confirmando se ele está como active e se o tempo de atividade do processo é apropriado.

   

Testar o sistema

Pode testar o sistema ao criar um ficheiro de acionador no dispositivo. O arquivo de gatilho fará com que a verificação de linha de base no agente detecte o arquivo como uma violação de 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 referência chamada "IoT_CISBenchmarks_DIoTTest". Pode consultar esta recomendação no 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 microagente do Defender para IoT:

1. Abrir um terminal.

2. Execute o seguinte comando:

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

Limpe os recursos

Não há recursos para limpar.

Próximas etapas