Registro de atividades de rede

Este documento explica como um controlador de política de dispositivo (DPC, na sigla em inglês) registra a atividade da rede. Continue lendo para saber como adicionar o registro de rede ao seu DPC.

Visão geral

O registro da atividade da rede pode ajudar as empresas a detectar e rastrear a disseminação de malware nos dispositivos. O DPC pode chamar APIs de registro de rede para informar conexões TCP e buscas DNS de chamadas de rede do sistema.

Normalmente, o DPC envia registros para um servidor para apresentação a um administrador de TI. Talvez você queira processar os registros no servidor ou localmente no dispositivo. Por exemplo, é possível configurar listas de negação de DNS para detectar e alertar os admins de TI sobre comportamentos suspeitos.

Disponibilidade

O registro de rede está disponível no Android 8 e versões mais recentes para proprietários de dispositivos. Se ativado, ele coleta dados sobre a atividade da rede do dispositivo. Ele também é compatível com o Android 12 e versões mais recentes para o proprietário de um perfil gerenciado e um app delegado com DELEGATION_NETWORK_LOGGING. Quando o registro de rede é ativado pelo proprietário do perfil, os registros de rede incluem apenas a atividade de rede do perfil de trabalho e não coletam dados do perfil pessoal.

Recomendamos que você afilie novos usuários assim que o DPC ou o usuário do dispositivo os criar. O proprietário do dispositivo pode detectar transmissões ou callbacks, como onUserAdded() (que é entregue ao proprietário do dispositivo, e não a um app de registro delegado), para que o proprietário do perfil do novo usuário possa fazer a afiliação. Para saber mais, leia Usuários afiliados.

Logs de eventos

Quando o registro de rede está ativo, o Android registra cada evento de apps que usam as bibliotecas de rede do sistema. O registro de rede registra dois tipos de eventos:

  • Buscas DNS
  • Conexões de rede

Buscas DNS

O registro de rede registra um evento para buscas DNS que fazem parte das solicitações de rede do sistema. Os registros capturam cada solicitação de DNS que resolve um nome de host para um endereço IP. Outras consultas DNS de suporte, como descoberta de servidor de nomes, não são registradas.

As APIs de registro de atividade da rede apresentam cada busca DNS como uma instância de DnsEvent. A Tabela 1 descreve os campos e os valores típicos registrados em um DnsEvent.

Tabela 1. Campos de evento de DNS

Dados Exemplo Descrição
Nome do host host.example.com O nome do host enviado na consulta DNS.
Endereços Inet 203.0.113.9, 198.51.100.25 Uma lista de endereços IPv4 ou IPv6 que a consulta DNS resolveu para o nome do host. Para manter o tamanho do registro gerenciável, os resultados podem não incluir todos os endereços IP. Consulte a contagem de endereços na linha a seguir.
Contagem de endereços 4 O número de endereços IP retornados da resolução da consulta DNS. Use isso para descobrir se os endereços IP registrados são um subconjunto dos resultados. Um valor de 0 (zero) significa que o nome do host não foi resolvido para um endereço IP.
Nome do pacote com.android.chrome O nome do pacote do app que fez a consulta DNS.
Carimbo de data/hora 1506297600000 Um carimbo de data/hora que registra quando a busca DNS aconteceu. O valor é o intervalo em milissegundos entre a busca DNS e a meia-noite de 1º de janeiro de 1970 UTC.
ID 25 Um ID numérico que aumenta de forma constante. Disponível no Android 9.0 (nível 28 da API) ou versões mais recentes.

Embora as buscas DNS possam ajudar os admins de TI a rastrear conexões de rede, o registro de rede não é uma solução de registro DNS de uso geral. Veja algumas tarefas de DNS que um app pode realizar e que não são registradas:

  • Comunicar-se diretamente com um servidor de nomes DNS.
  • Chamar uma biblioteca DNS Java para fazer consultas DNS.
  • Evitar uma consulta DNS conectando-se a um endereço IP fixo.

Conexões de rede

O registro de rede registra um evento para cada tentativa de conexão que faz parte de uma solicitação de rede do sistema. Os registros capturam conexões TCP bem-sucedidas e com falha. As transferências UDP não são registradas.

As APIs de registro de atividade da rede apresentam cada conexão como uma instância de ConnectEvent. A Tabela 2 descreve os campos e os valores típicos registrados em um ConnectEvent.

Tabela 2. Conectar campos de evento

Dados Exemplo Descrição
Endereços Inet 2001:db8::2f:abc:0 O endereço IP ao qual o dispositivo se conectou. Pode ser um endereço IPv4 ou IPv6.
Porta 80 O número da porta TCP à qual o dispositivo se conectou.
Nome do pacote com.android.chrome O nome do pacote do app que se conectou.
Carimbo de data/hora 1506297600000 Um carimbo de data/hora que registra quando a conexão de rede aconteceu. O valor é o intervalo de milissegundos entre a conexão e a meia-noite de 1º de janeiro de 1970 UTC.
ID 26 Um ID numérico que aumenta de forma constante. Disponível no Android 9.0 (nível 28 da API) ou versões mais recentes.

O registro de rede registra um evento quando um app chama bibliotecas de rede padrão, como as APIs integradas do Android ou bibliotecas de terceiros conhecidas, para se conectar a um host. Os apps que emitem chamadas do sistema diretamente para se comunicar não são registrados. Lembre-se de que a rede UDP não é registrada, então alguns apps de streaming de mídia, mensagens e apps de jogo podem não aparecer nos registros.

Informar os usuários

O sistema alerta os usuários do dispositivo que o registro de atividades da rede está ativo. Os usuários vão ver os seguintes avisos na interface:

  • Uma seção na caixa de diálogo Gerenciamento de dispositivos explicando que o DPC está monitorando o tráfego de rede. Os usuários veem a caixa de diálogo tocando no rótulo de informações do dispositivo gerenciado nas Configurações rápidas.
  • Uma notificação dispensável do sistema mostrada quando o usuário é novo no registro de rede. Ao tocar na notificação, a caixa de diálogo Monitoramento do dispositivo é mostrada com mais explicações em uma seção de monitoramento de rede. A notificação desaparece quando o DPC desativa o registro de rede.

Adicionar o registro de rede ao DPC

Para ajudar os administradores de TI a analisar os registros de rede, o DPC precisa ser capaz de concluir as seguintes tarefas:

  • Ativar e desativar o registro de rede.
  • Recuperar os registros gravados quando um novo lote estiver pronto.
  • Enviar os dados úteis nos registros para um servidor.

Requisitos

O registro de rede está disponível no Android 8.0 (nível 26 da API) ou mais recente para um proprietário do dispositivo e no Android 12 (nível 31 da API) ou mais recente para um proprietário de um perfil gerenciado. Antes de registrar a atividade da rede, o DPC precisa verificar se é um proprietário do dispositivo ou de um perfil gerenciado. Os registros de rede em um proprietário do dispositivo com um perfil de trabalho não incluem a atividade de rede no perfil pessoal se ela estiver ativada pelo proprietário do perfil.

Ativar a geração de registros de rede

Para começar a registrar a atividade da rede, chame o método DevicePolicyManager setNetworkLoggingEnabled() e transmita true como o argumento enabled. O DPC pode chamar isNetworkLoggingEnabled() para verificar se a atividade da rede está registrada.

Depois que o DPC ativar o registro de rede, pode levar algum tempo até que o primeiro lote de registros esteja pronto. É recomendável definir expectativas de entrega para os admins de TI na interface do usuário.

Para interromper o registro de atividades da rede, chame setNetworkLoggingEnabled() e transmita false. Quando um admin de TI desativa o registro de rede, o sistema exclui todos os registros coletados e não informados.

Recuperar registros

O DPC pode recuperar registros em lotes. As APIs de registro de rede não fornecem acesso aleatório a entradas individuais anteriores. Quando um novo lote de registros estiver disponível, a subclasse DeviceAdminReceiver do DPC vai receber o callback onNetworkLogsAvailable(). O callback inclui um token de lote que o DPC pode usar para recuperar os registros. O DPC chama o método DevicePolicyManager retrieveNetworkLogs() para receber uma lista de eventos de rede.

O exemplo a seguir mostra como recuperar os registros na subclasse DeviceAdminReceiver:

Kotlin

fun onNetworkLogsAvailable(
        context: Context, intent: Intent, batchToken: Long, networkLogsCount: Int) {

    val dpm = getManager(context)
    var logs: List<NetworkEvent>? = null

    // Fetch the batch of logs with the batch token from the callback's arguments.
    try {
        logs = dpm.retrieveNetworkLogs(getWho(context), batchToken)
    } catch (e: SecurityException) {
        // Perhaps an unaffiliated user - handle the exception ...
    }

    // Process any logs ...
}

Java

public void onNetworkLogsAvailable(
    Context context, Intent intent, long batchToken, int networkLogsCount) {

  DevicePolicyManager dpm = getManager(context);
  List<NetworkEvent> logs = null;

  // Fetch the next batch of logs using the callback's batch token argument.
  try {
    logs = dpm.retrieveNetworkLogs(getWho(context), batchToken);
  } catch (SecurityException e) {
    // Perhaps an unaffiliated user - handle the exception ...
  }

  // Process any logs ...
}

O DPC precisa recuperar os registros imediatamente, porque o sistema os exclui para liberar espaço para novos lotes. É recomendável manter a cópia local dos registros até ter certeza de que o DPC processou todos eles sem problemas.

Processar registros

Um lote de registros geralmente contém uma combinação de instâncias DnsEvent e ConnectEvent. Para saber mais sobre os campos de dados de buscas DNS e conexões de rede, consulte log de eventos. Os eventos estão em ordem cronológica, e cada lote contém no máximo 1.200 eventos.

Depois de chamar a recuperação dos registros, verifique se o valor de retorno não é null. O valor pode ser null se uma das seguintes situações ocorrer:

  • O lote representado pelo token não está mais disponível. O DPC não pode recuperar o lote e precisa aguardar o próximo.
  • O admin de TI desativou o registro de rede.

O exemplo simplificado a seguir mostra como o DPC pode extrair os nomes de host DNS resolvidos. Seu DPC precisa de processamento e relatórios mais sofisticados.

Kotlin

// Here, logs might be null. We can't fix because either the token doesn't match
// the current batch or network logging was deactivated.
// Confirm with isNetworkLoggingEnabled().

logs?.forEach {
    // For this example, report the DNS hosts and discard all other data.
    // Because we use the event ID, this example requires API level 28.
    if (it is DnsEvent) {
        reportDnsHostToServer(it.hostname, it.getTimestamp(), it.getId())
    }
}

Java

if (logs == null) {
  // Abandon processing because either the token doesn't match the current batch
  // or network logging was deactivated - confirm with isNetworkLoggingEnabled().
  return;
}

for (NetworkEvent event : logs) {
  // For this example, report the DNS hosts and discard all other data.
  // This example requires API level 28 because we use the event ID.
  if (event instanceof DnsEvent) {
    reportDnsHostToServer(
        ((DnsEvent) event).getHostname(), event.getTimestamp(), event.getId());
  }
}

O exemplo anterior também mostra como conseguir o ID numérico de eventos incluídos no Android 9.0 (nível 28 da API) ou versões mais recentes. Como o ID aumenta monotonicamente para cada evento, você pode ajudar os admins de TI a identificar lacunas nos registros. O sistema redefine o ID sempre que um DPC ativa a geração de registros ou quando o dispositivo é reiniciado.

O DPC pode enviar toda a coleção para um servidor ou você pode decidir filtrar os eventos no dispositivo. Por exemplo, você pode informar somente relatórios de eventos adicionados a uma lista de permissões para admins de TI.

Desenvolvimento e teste

Durante o desenvolvimento e os testes, talvez você queira receber callbacks de onNetworkLogsAvailable() sem precisar navegar por centenas de páginas da Web. No Android 9.0 (nível 28 da API) ou versões mais recentes, é possível fazer algumas solicitações de rede de amostra e forçar o sistema a enviar um callback de registros disponíveis. Execute o seguinte comando do Android Debug Bridge (adb) no terminal:

adb shell dpm force-network-logs

O sistema limita a frequência com que você pode usar a ferramenta e informa qualquer lentidão intencional na saída do terminal. Se não houver registros para recuperar, o DPC não vai receber um callback.