Consignation de l'activité réseau

Ce document explique comment un outil de contrôle des règles relatives aux appareils (DPC, Device Policy Controller) consigne l'activité réseau. Poursuivez votre lecture pour découvrir comment ajouter la journalisation réseau à votre DPC.

Présentation

La journalisation de l'activité réseau peut aider les entreprises à détecter et à suivre la propagation de logiciels malveillants sur leurs appareils. Votre DPC peut appeler des API de journalisation réseau pour signaler les connexions TCP et les résolutions DNS à partir des appels réseau du système.

En règle générale, votre DPC envoie les journaux à un serveur pour les présenter à un administrateur informatique. Vous pouvez traiter les journaux plus en détail sur votre serveur ou localement sur l'appareil. Par exemple, vous pouvez configurer des listes de blocage DNS pour détecter les comportements suspects et en informer les administrateurs informatiques.

Disponibilité

La journalisation réseau est compatible avec Android 8 et versions ultérieures pour un propriétaire d'appareil. Si elle est activée, elle collecte des données sur l'activité réseau de l'appareil. Elle est également compatible avec Android 12 et versions ultérieures pour le propriétaire d'un profil géré et une application déléguée avec DELEGATION_NETWORK_LOGGING. Lorsque la journalisation réseau est activée par le propriétaire du profil, les journaux réseau n'incluent que l'activité réseau du profil professionnel et ne collectent pas de données du profil personnel.

Nous vous recommandons d'affilier les nouveaux utilisateurs dès que votre DPC ou l'utilisateur de l'appareil les crée. Un propriétaire d'appareil peut écouter les diffusions ou les rappels, tels que onUserAdded() (qui est envoyé au propriétaire de l'appareil plutôt qu'à une application de journalisation déléguée), afin que le propriétaire du profil du nouvel utilisateur puisse affilier l'utilisateur. Pour en savoir plus, consultez Utilisateurs affiliés.

Journaux des événements

Lorsque la journalisation réseau est active, Android enregistre chaque événement des applications à l'aide des bibliothèques réseau du système. La journalisation réseau enregistre deux types d'événements :

  • Résolutions DNS
  • Connexions réseau

Résolutions DNS

La journalisation réseau enregistre un événement pour les résolutions DNS qui font partie des requêtes réseau du système. Les journaux capturent chaque requête DNS qui résout un nom d'hôte en adresse IP. Les autres requêtes DNS compatibles, telles que la découverte de serveurs de noms, ne sont pas enregistrées.

Les API de journalisation de l'activité réseau présentent chaque résolution DNS en tant qu'instance DnsEvent. Le tableau 1 décrit les champs et les valeurs types enregistrés dans un DnsEvent.

Tableau 1. Champs d'événement DNS

Données Exemple Description
Nom d'hôte host.example.com Nom d'hôte envoyé dans la requête DNS.
Adresses Inet 203.0.113.9, 198.51.100.25 Liste des adresses IPv4 ou IPv6 que la requête DNS a résolues pour le nom d'hôte. Pour que la taille du journal reste gérable, il est possible que les résultats n'incluent pas toutes les adresses IP. Consultez le nombre d'adresses à la ligne suivante.
Nombre d'adresses 4 Nombre d'adresses IP renvoyées par la résolution de la requête DNS. Utilisez cette option pour savoir si les adresses IP enregistrées sont un sous-ensemble des résultats. La valeur 0 (zéro) signifie que le nom d'hôte n'a pas été résolu en adresse IP.
Nom du package com.android.chrome Nom du package de l'application qui a effectué la requête DNS.
Code temporel 1506297600000 Code temporel de la résolution DNS. La valeur correspond à l'intervalle en millisecondes entre la résolution DNS et minuit, le 1er janvier 1970 UTC.
ID 25 Un ID numérique qui augmente de façon monotone. Disponible sur Android 9.0 (niveau d'API 28) ou version ultérieure.

Bien que les résolutions DNS puissent aider les administrateurs informatiques à suivre les connexions réseau, la journalisation réseau n'est pas une solution d'enregistrement DNS à usage général. Voici quelques tâches DNS qu'une application peut effectuer et qui ne sont pas enregistrées :

  • Communiquer directement avec un serveur de noms DNS.
  • Appeler une bibliothèque DNS Java pour effectuer des requêtes DNS.
  • Éviter une requête DNS en se connectant à une adresse IP fixe.

Connexions réseau

La journalisation réseau enregistre un événement pour chaque tentative de connexion faisant partie d'une requête réseau système. Les journaux capturent les connexions TCP réussies et échouées. Les transferts UDP ne sont pas enregistrés.

Les API de journalisation de l'activité réseau présentent chaque connexion sous la forme d'une instance ConnectEvent. Le tableau 2 décrit les champs et les valeurs types enregistrés dans un ConnectEvent.

Tableau 2. Connecter les champs d'événement

Données Exemple Description
Adresses Inet 2001:db8::2f:abc:0 L'adresse IP à laquelle l'appareil s'est connecté. Il peut s'agir d'une adresse IPv4 ou IPv6.
Port 80 Numéro de port TCP auquel l'appareil s'est connecté.
Nom du package com.android.chrome Nom du package de l'application qui s'est connectée.
Code temporel 1506297600000 Horodatage indiquant le moment où la connexion réseau a eu lieu. La valeur correspond à l'intervalle en millisecondes entre la connexion et minuit, le 1er janvier 1970 UTC.
ID 26 Un ID numérique qui augmente de façon monotone. Disponible sur Android 9.0 (niveau d'API 28) ou version ultérieure.

La journalisation réseau enregistre un événement lorsqu'une application appelle des bibliothèques réseau standards, telles que les API intégrées d'Android ou des bibliothèques tierces populaires, pour se connecter à un hôte. Les applications qui émettent des appels système directement pour communiquer ne sont pas enregistrées. N'oubliez pas que les réseaux UDP ne sont pas enregistrés. Par conséquent, certaines applications de streaming multimédia, de messagerie et de jeu peuvent ne pas apparaître dans les journaux.

Informer les utilisateurs

Le système avertit les utilisateurs de l'appareil que la journalisation de l'activité réseau est active. Les utilisateurs voient les avertissements suivants dans l'interface :

  • Une section de la boîte de dialogue Gestion des appareils expliquant que votre DPC surveille le trafic réseau. Les utilisateurs voient la boîte de dialogue en appuyant sur le libellé d'informations de l'appareil géré dans les Réglages rapides.
  • Notification système pouvant être ignorée, qui s'affiche lorsque l'utilisateur découvre la journalisation réseau. Appuyer sur la notification affiche la boîte de dialogue Surveillance de l'appareil avec des explications supplémentaires dans une section de surveillance du réseau. La notification disparaît lorsque votre DPC désactive la journalisation réseau.

Ajouter la journalisation réseau à votre DPC

Pour aider les administrateurs informatiques à examiner les journaux réseau, votre DPC doit pouvoir effectuer les tâches suivantes :

  • Activez ou désactivez la journalisation réseau.
  • Récupérez les journaux enregistrés lorsqu'un nouveau lot est prêt.
  • Envoyer les données utiles des journaux à un serveur.

Conditions requises

La journalisation réseau est disponible sur Android 8.0 (niveau d'API 26) ou version ultérieure pour un propriétaire d'appareil, et sur Android 12 (niveau d'API 31) ou version ultérieure pour un propriétaire de profil d'un profil géré. Avant de consigner l'activité réseau, votre DPC doit vérifier s'il s'agit d'un propriétaire d'appareil ou d'un propriétaire de profil d'un profil géré. Les journaux réseau d'un propriétaire d'appareil avec un profil professionnel n'incluent pas l'activité réseau sur le profil personnel si elle est activée par le propriétaire du profil.

Activer la journalisation réseau

Pour commencer à consigner l'activité réseau, appelez la méthode setNetworkLoggingEnabled() de DevicePolicyManager et transmettez true comme argument enabled. Votre DPC peut appeler isNetworkLoggingEnabled() pour vérifier si l'activité réseau est enregistrée.

Une fois que votre DPC a activé la journalisation réseau, il peut s'écouler un certain temps avant que le premier lot de journaux ne soit prêt. Vous pouvez définir des attentes de livraison pour les administrateurs informatiques dans votre interface utilisateur.

Pour arrêter la journalisation de l'activité réseau, appelez setNetworkLoggingEnabled() et transmettez false. Lorsqu'un administrateur informatique désactive la journalisation réseau, le système supprime tous les journaux collectés et non signalés.

Récupérer les journaux

Votre DPC peut récupérer les journaux par lots. Les API de journalisation réseau ne fournissent pas d'accès aléatoire aux entrées individuelles passées. Lorsqu'un nouveau lot de journaux est disponible, la sous-classe DeviceAdminReceiver de votre DPC reçoit le rappel onNetworkLogsAvailable(). Le rappel inclut un jeton de lot que votre DPC peut utiliser pour récupérer les journaux. Votre DPC appelle la méthode DevicePolicyManager retrieveNetworkLogs() pour obtenir la liste des événements réseau.

L'exemple suivant montre comment récupérer les journaux dans votre sous-classe 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 ...
}

Votre DPC doit récupérer les journaux immédiatement, car le système les supprime pour faire de la place aux nouveaux lots. Vous pouvez conserver votre copie locale des journaux jusqu'à ce que vous soyez sûr que votre DPC les a tous traités sans problème.

Traiter tous les journaux

Un lot de journaux contient généralement un mélange d'instances DnsEvent et ConnectEvent. Pour en savoir plus sur les champs de données des résolutions DNS et des connexions réseau, consultez Journaux d'événements. Les événements sont classés par ordre chronologique et chaque lot ne contient pas plus de 1 200 événements.

Après avoir appelé la méthode pour récupérer les journaux, vérifiez que la valeur renvoyée n'est pas null. La valeur peut être null si l'un des événements suivants se produit :

  • Le lot représenté par le jeton de lot n'est plus disponible. Votre DPC ne peut pas récupérer le lot et doit attendre le lot suivant.
  • L'administrateur informatique a désactivé la journalisation réseau.

L'exemple simplifié suivant montre comment le DPC peut extraire les noms d'hôte DNS résolus. Votre CPD nécessite un traitement et des rapports plus sophistiqués.

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());
  }
}

L'exemple précédent montre également comment obtenir l'ID numérique des événements inclus dans Android 9.0 (niveau d'API 28) ou version ultérieure. Étant donné que l'ID augmente de manière monotone pour chaque événement, vous pouvez aider les administrateurs informatiques à repérer les lacunes dans leurs journaux. Le système réinitialise l'ID chaque fois qu'un DPC active la journalisation ou que l'appareil redémarre.

Votre DPC peut envoyer l'intégralité de la collection à un serveur, ou vous pouvez décider de filtrer les événements sur l'appareil. Par exemple, vous pouvez ne signaler que les événements ajoutés à une liste d'autorisation pour les administrateurs informatiques.

Développement et tests

Pendant le développement et les tests, vous souhaiterez peut-être recevoir des rappels onNetworkLogsAvailable() sans avoir à parcourir des centaines de pages Web. Sous Android 9.0 (niveau d'API 28) ou version ultérieure, vous pouvez effectuer quelques exemples de requêtes réseau et forcer le système à envoyer un rappel de disponibilité des journaux. Exécutez la commande Android Debug Bridge (adb) suivante dans votre terminal :

adb shell dpm force-network-logs

Le système limite la fréquence à laquelle vous pouvez utiliser l'outil et signale tout ralentissement intentionnel dans la sortie du terminal. Si aucun journal n'est disponible, votre DPC ne reçoit pas de rappel.