Registro de la actividad de red

En este documento, se explica cómo un controlador de política de dispositivo (DPC) registra la actividad de red. Sigue leyendo para aprender a agregar el registro de red a tu DPC.

Descripción general

Registrar la actividad de red puede ayudar a las empresas a detectar y hacer un seguimiento de la propagación de malware en sus dispositivos. Tu DPC puede llamar a las APIs de registro de red para informar las conexiones TCP y las búsquedas de DNS desde las llamadas de red del sistema.

Por lo general, el DPC entrega los registros a un servidor para que se presenten a un administrador de TI. Es posible que quieras procesar los registros más adelante en tu servidor o de forma local en el dispositivo. Por ejemplo, podrías configurar listas de denegación de DNS para detectar el comportamiento sospechoso y alertar a los administradores de TI al respecto.

Disponibilidad

El registro de red es compatible con Android 8 y versiones posteriores para un propietario del dispositivo. Si está habilitada, recopila datos sobre la actividad de red del dispositivo. También es compatible con Android 12 y versiones posteriores para el propietario de un perfil administrado y una app delegada con DELEGATION_NETWORK_LOGGING. Cuando el propietario del perfil habilita el registro de red, los registros de red solo incluyen la actividad de red del perfil de trabajo y no recopilan datos del perfil personal.

Te recomendamos que asocies a los usuarios nuevos en cuanto los cree tu DPC o el usuario del dispositivo. Un propietario del dispositivo puede escuchar transmisiones o devoluciones de llamada, como onUserAdded() (que se entrega al propietario del dispositivo en lugar de a una app de registro delegada), para que el propietario del perfil del usuario nuevo pueda afiliar al usuario. Para obtener más información, consulta Usuarios afiliados.

Registros de eventos

Cuando el registro de red está activo, Android registra cada evento de las apps que usan las bibliotecas de red del sistema. El registro de red registra dos tipos de eventos:

  • Búsquedas de DNS
  • Conexiones de red

Búsquedas de DNS

El registro de red registra un evento para las búsquedas de DNS que forman parte de las solicitudes de red del sistema. Los registros capturan cada solicitud de DNS que resuelve un nombre de host en una dirección IP. No se registran otras consultas de DNS de respaldo, como el descubrimiento de servidores de nombres.

Las APIs de registro de actividad de red presentan cada búsqueda de DNS como una instancia de DnsEvent. En la tabla 1, se describen los campos y los valores típicos que se registran en un DnsEvent.

Tabla 1: Campos de eventos de DNS

Datos Ejemplo Descripción
Nombre de host host.example.com Es el nombre de host que se envió en la consulta de DNS.
Direcciones de Inet 203.0.113.9, 198.51.100.25 Es una lista de direcciones IPv4 o IPv6 que la consulta de DNS resolvió para el nombre de host. Para que el tamaño del registro sea manejable, es posible que los resultados no incluyan todas las direcciones IP. Consulta el recuento de direcciones en la siguiente fila.
Recuento de direcciones 4 Es la cantidad de direcciones IP que se devuelven de la resolución de la consulta de DNS. Usa esta opción para averiguar si las direcciones IP registradas son un subconjunto de los resultados. Un valor de 0 (cero) significa que el nombre de host no se resolvió en una dirección IP.
Nombre del paquete com.android.chrome Es el nombre del paquete de la app que realizó la consulta de DNS.
Marca de tiempo 1506297600000 Es una marca de tiempo que registra cuándo se produjo la búsqueda de DNS. El valor es el intervalo en milisegundos entre la búsqueda de DNS y la medianoche del 1 de enero de 1970 (UTC).
ID 25 Es un ID numérico que aumenta de forma monótona. Disponible en Android 9.0 (nivel de API 28) o versiones posteriores.

Si bien las búsquedas de DNS pueden ayudar a los administradores de TI a hacer un seguimiento de las conexiones de red, el registro de red no es una solución de registro DNS de uso general. Estas son algunas tareas de DNS que una app podría realizar y que no se registran:

  • Comunicarse directamente con un servidor de nombres DNS
  • Llamar a una biblioteca de DNS de Java para realizar consultas de DNS
  • Evitar una consulta de DNS conectándose a una dirección IP fija

Conexiones de red

El registro de red registra un evento para cada intento de conexión que forma parte de una solicitud de red del sistema. Los registros capturan las conexiones TCP exitosas y fallidas, pero no se registran las transferencias UDP.

Las APIs de registro de actividad de red presentan cada conexión como una instancia de ConnectEvent. En la tabla 2, se describen los campos y los valores típicos registrados en un ConnectEvent.

Tabla 2: Conecta campos de eventos

Datos Ejemplo Descripción
Direcciones de Inet 2001:db8::2f:abc:0 Es la dirección IP a la que se conectó el dispositivo. Puede ser una dirección IPv4 o IPv6.
Puerto 80 Es el número de puerto TCP al que se conectó el dispositivo.
Nombre del paquete com.android.chrome Es el nombre del paquete de la app que se conectó.
Marca de tiempo 1506297600000 Es una marca de tiempo que registra cuándo se produjo la conexión de red. El valor es el intervalo en milisegundos entre la conexión y la medianoche del 1 de enero de 1970 (UTC).
ID 26 Es un ID numérico que aumenta de forma monótona. Disponible en Android 9.0 (nivel de API 28) o versiones posteriores.

El registro de red registra un evento cuando una app llama a bibliotecas de red estándar, como las APIs integradas de Android o las bibliotecas populares de terceros, para conectarse a un host. No se registran las apps que emiten llamadas al sistema directamente para comunicarse. Recuerda que las redes UDP no se registran, por lo que es posible que algunas apps de transmisión de contenido multimedia, mensajería y juegos no aparezcan en los registros.

Informa a los usuarios

El sistema alerta a los usuarios del dispositivo que el registro de actividad de red está activo. Los usuarios ven las siguientes advertencias en la interfaz:

  • Una sección en el diálogo Administración de dispositivos en la que se explica que tu DPC supervisa el tráfico de red Los usuarios ven el diálogo cuando presionan la etiqueta de información del dispositivo administrado en Configuración rápida.
  • Es una notificación del sistema que se puede descartar y que se muestra mientras el usuario es nuevo en el registro de red. Si presionas la notificación, se mostrará el diálogo Supervisión del dispositivo con más explicaciones en una sección de supervisión de red. La notificación desaparece cuando el DPC inhabilita el registro de red.

Agrega el registro de red a tu DPC

Para ayudar a los administradores de TI a revisar los registros de red, tu DPC debe poder completar las siguientes tareas:

  • Activar y desactivar el registro de red
  • Recupera los registros grabados cuando un lote nuevo esté listo.
  • Envía los datos útiles de los registros a un servidor.

Requisitos

El registro de red está disponible en Android 8.0 (nivel de API 26) o versiones posteriores para un propietario del dispositivo y en Android 12 (nivel de API 31) o versiones posteriores para un propietario de un perfil administrado. Antes de registrar la actividad de red, tu DPC debe verificar si es un propietario del dispositivo o un propietario del perfil de un perfil administrado. Los registros de red en un propietario del dispositivo con un perfil de trabajo no incluyen la actividad de red en el perfil personal si el propietario del perfil la habilita.

Habilita el registro de red

Para comenzar a registrar la actividad de red, llama al método DevicePolicyManager setNetworkLoggingEnabled() y pasa true como el argumento enabled. Tu DPC puede llamar a isNetworkLoggingEnabled() para verificar si se registra la actividad de red.

Después de que el DPC habilite el registro de red, es posible que transcurra un tiempo antes de que el primer lote de registros esté listo. Te recomendamos que establezcas expectativas de entrega para los administradores de TI en tu interfaz de usuario.

Para dejar de registrar la actividad de red, llama a setNetworkLoggingEnabled() y pasa false. Cuando un administrador de TI desactiva el registro de red, el sistema borra todos los registros recopilados y no informados.

Registros de recuperación

Tu DPC puede recuperar registros en lotes; las APIs de registro de red no proporcionan acceso aleatorio a entradas individuales anteriores. Cuando hay un nuevo lote de registros disponible, la subclase DeviceAdminReceiver de tu DPC recibe la devolución de llamada onNetworkLogsAvailable(). La devolución de llamada incluye un token de lote que tu DPC puede usar para recuperar los registros. Tu DPC llama al método DevicePolicyManager retrieveNetworkLogs() para obtener una lista de eventos de red.

En el siguiente ejemplo, se muestra cómo puedes recuperar los registros en tu subclase 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 ...
}

Tu DPC debe recuperar los registros de inmediato, ya que el sistema los borra para dejar espacio a los lotes nuevos. Te recomendamos que conserves la copia local de los registros hasta que te asegures de que el DPC los haya procesado todos sin problemas.

Procesar cualquier registro

Por lo general, un lote de registros contiene una combinación de instancias de DnsEvent y ConnectEvent. Para obtener más información sobre los campos de datos de las búsquedas de DNS y las conexiones de red, consulta Registros de eventos. Los eventos están en orden cronológico y cada lote no contiene más de 1,200 eventos.

Después de llamar para recuperar los registros, verifica que el valor que se muestra no sea null. El valor puede ser null si ocurre una de las siguientes situaciones:

  • El lote representado por el token de lote ya no está disponible. Tu DPC no puede recuperar el lote y debe esperar al siguiente.
  • El administrador de TI inhabilitó el registro de red.

En el siguiente ejemplo simplificado, se muestra cómo el DPC podría extraer los nombres de host de DNS resueltos. Tu DPC necesita un procesamiento y generación de informes más 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());
  }
}

En el ejemplo anterior, también se muestra cómo puedes obtener el ID numérico de los eventos que se incluyen en Android 9.0 (nivel de API 28) o versiones posteriores. Debido a que el ID aumenta de forma monótona para cada evento, puedes ayudar a los administradores de TI a detectar brechas en sus registros. El sistema restablece el ID cada vez que un DPC habilita el registro o cuando se reinicia el dispositivo.

Tu DPC puede enviar toda la colección a un servidor, o bien puedes decidir filtrar los eventos en el dispositivo. Por ejemplo, puedes informar solo los eventos que se agregaron a una lista de entidades permitidas para los administradores de TI.

Desarrollo y pruebas

Mientras desarrollas y realizas pruebas, es posible que quieras recibir devoluciones de llamada de onNetworkLogsAvailable() sin tener que explorar cientos de páginas web. En Android 9.0 (nivel de API 28) o versiones posteriores, puedes realizar algunas solicitudes de red de muestra y forzar al sistema a enviar una devolución de llamada de registros disponibles. Ejecuta el siguiente comando de Android Debug Bridge (adb) en tu terminal:

adb shell dpm force-network-logs

El sistema limita la frecuencia con la que puedes usar la herramienta y, además, informa cualquier ralentización intencional en el resultado de la terminal. Si no hay registros para recuperar, tu DPC no recibe una devolución de llamada.