नेटवर्क पर की गई गतिविधियों को लॉग करना

इस दस्तावेज़ में बताया गया है कि डिवाइस नीति नियंत्रक (DPC), नेटवर्क पर की जाने वाली गतिविधि को कैसे लॉग करता है. अपने डीपीसी में नेटवर्क लॉगिंग जोड़ने का तरीका जानने के लिए, पढ़ना जारी रखें.

खास जानकारी

नेटवर्क पर की जाने वाली गतिविधि को लॉग करने से, एंटरप्राइज़ को अपने डिवाइसों पर मैलवेयर का पता लगाने और उसे फैलने से रोकने में मदद मिल सकती है. आपका डीपीसी, नेटवर्क लॉगिंग एपीआई को कॉल कर सकता है, ताकि सिस्टम नेटवर्किंग कॉल से टीसीपी कनेक्शन और डीएनएस लुकअप की रिपोर्ट की जा सके.

आम तौर पर, आपका डीपीसी किसी सर्वर पर लॉग डिलीवर करता है, ताकि आईटी एडमिन को दिखाया जा सके. ऐसा हो सकता है कि आपको लॉग को अपने सर्वर पर या डिवाइस पर स्थानीय तौर पर प्रोसेस करना हो. उदाहरण के लिए, डीएनएस की अस्वीकार की गई सूची सेट अप की जा सकती है, ताकि संदिग्ध गतिविधि का पता लगाया जा सके और आईटी एडमिन को इसकी सूचना दी जा सके.

उपलब्धता

डिवाइस के मालिक के लिए, नेटवर्क लॉगिंग की सुविधा Android 8 और इसके बाद के वर्शन पर काम करती है. अगर इसे चालू किया जाता है, तो यह डिवाइस के नेटवर्क पर की जाने वाली गतिविधि का डेटा इकट्ठा करता है. यह सुविधा, Android 12 और इसके बाद के वर्शन पर भी काम करती है. इसके लिए, मैनेज की जा रही प्रोफ़ाइल के मालिक और DELEGATION_NETWORK_LOGGING वाले ऐप्लिकेशन के पास डेलिगेटेड ऐक्सेस होना चाहिए. जब प्रोफ़ाइल का मालिक नेटवर्क लॉगिंग की सुविधा चालू करता है, तो नेटवर्क लॉग में सिर्फ़ वर्क प्रोफ़ाइल की नेटवर्क पर की जाने वाली गतिविधि शामिल होती है. इसमें निजी प्रोफ़ाइल का डेटा इकट्ठा नहीं किया जाता.

हमारा सुझाव है कि जैसे ही आपका DPC या डिवाइस का उपयोगकर्ता नए उपयोगकर्ता बनाता है, आप उन्हें संबद्ध करें. डिवाइस का मालिक, ब्रॉडकास्ट या कॉलबैक सुन सकता है. जैसे, onUserAdded() (यह डेलिगेट किए गए लॉगिंग ऐप्लिकेशन के बजाय, डिवाइस के मालिक को डिलीवर किया जाता है), ताकि नए उपयोगकर्ता की प्रोफ़ाइल का मालिक, उपयोगकर्ता को जोड़ सके. ज़्यादा जानने के लिए, अफ़िलिएट किए गए उपयोगकर्ता लेख पढ़ें.

गतिविधियों का ब्यौरा

नेटवर्क लॉगिंग की सुविधा चालू होने पर, Android सिस्टम नेटवर्किंग लाइब्रेरी का इस्तेमाल करने वाले ऐप्लिकेशन के हर इवेंट को रिकॉर्ड करता है. नेटवर्क लॉगिंग में दो तरह के इवेंट रिकॉर्ड किए जाते हैं:

  • डीएनएस लुकअप
  • इंटरनेट कनेक्शन

डीएनएस लुकअप

नेटवर्क लॉगिंग, डीएनएस लुकअप के लिए एक इवेंट रिकॉर्ड करती है. ये लुकअप, सिस्टम नेटवर्क के अनुरोधों का हिस्सा होते हैं. लॉग में हर उस डीएनएस अनुरोध को कैप्चर किया जाता है जो होस्टनेम को आईपी पते में बदलता है. डीएनएस की अन्य क्वेरी रिकॉर्ड नहीं की जाती हैं. जैसे, नेम सर्वर की खोज.

नेटवर्क पर की जाने वाली गतिविधि को लॉग करने वाले एपीआई, हर डीएनएस लुकअप को DnsEvent इंस्टेंस के तौर पर दिखाते हैं. टेबल 1 में, DnsEvent में रिकॉर्ड किए गए फ़ील्ड और सामान्य वैल्यू के बारे में बताया गया है.

टेबल 1. डीएनएस इवेंट की जानकारी देने वाले फ़ील्ड

डेटा उदाहरण ब्यौरा
होस्टनाम host.example.com डीएनएस क्वेरी में भेजा गया होस्टनेम.
Inet पते 203.0.113.9, 198.51.100.25 IPv4 या IPv6 पतों की सूची, जिन्हें डीएनएस क्वेरी ने होस्टनेम के लिए रिज़ॉल्व किया है. लॉग का साइज़ मैनेज करने के लिए, हो सकता है कि नतीजों में सभी आईपी पते शामिल न हों. अगली लाइन में पतों की संख्या देखें.
पतों की संख्या 4 डीएनएस क्वेरी रिज़ॉल्यूशन से मिले आईपी पतों की संख्या. इसका इस्तेमाल करके यह पता लगाएं कि लॉग किए गए आईपी पते, नतीजों का सबसेट हैं या नहीं. 0 (शून्य) वैल्यू का मतलब है कि होस्टनेम को किसी आईपी पते से नहीं जोड़ा गया.
पैकेज का नाम com.android.chrome डीएनएस क्वेरी करने वाले ऐप्लिकेशन के पैकेज का नाम.
टाइमस्टैंप 1506297600000 डीएनएस लुकअप होने का टाइमस्टैंप. यह वैल्यू, डीएनएस लुकअप और 1 जनवरी, 1970 यूटीसी की आधी रात के बीच का मिलीसेकंड इंटरवल है.
आईडी 25 लगातार बढ़ने वाला न्यूमेरिक आईडी. यह सुविधा, Android 9.0 (एपीआई लेवल 28) या इसके बाद के वर्शन पर उपलब्ध है.

डीएनएस लुकअप से, आईटी एडमिन को इंटरनेट कनेक्शन ट्रैक करने में मदद मिल सकती है. हालांकि, नेटवर्क लॉगिंग, डीएनएस रिकॉर्ड करने का सामान्य समाधान नहीं है. यहां डीएनएस से जुड़े कुछ ऐसे टास्क दिए गए हैं जिन्हें कोई ऐप्लिकेशन कर सकता है, लेकिन उन्हें लॉग नहीं किया जाता:

  • डीएनएस नेम सर्वर से सीधे तौर पर कम्यूनिकेट करना.
  • डीएनएस क्वेरी करने के लिए, Java डीएनएस लाइब्रेरी को कॉल करना.
  • किसी तय आईपी पते से कनेक्ट करके, डीएनएस क्वेरी से बचना.

इंटरनेट कनेक्शन

नेटवर्क लॉगिंग, सिस्टम नेटवर्क के अनुरोध के तहत किए गए हर कनेक्शन के लिए एक इवेंट रिकॉर्ड करती है. लॉग में, सफल और असफल टीसीपी कनेक्शन कैप्चर किए जाते हैं. यूडीपी ट्रांसफ़र रिकॉर्ड नहीं किए जाते.

नेटवर्क पर की जाने वाली गतिविधि को लॉग करने वाले एपीआई, हर कनेक्शन को ConnectEvent इंस्टेंस के तौर पर दिखाते हैं. टेबल 2 में, ConnectEvent में रिकॉर्ड किए गए फ़ील्ड और सामान्य वैल्यू के बारे में बताया गया है.

टेबल 2. इवेंट फ़ील्ड कनेक्ट करना

डेटा उदाहरण ब्यौरा
Inet पते 2001:db8::2f:abc:0 डिवाइस से कनेक्ट किया गया आईपी पता. यह IPv4 या IPv6 पता हो सकता है.
पोर्ट 80 टीसीपी पोर्ट नंबर, जिससे डिवाइस कनेक्ट किया गया है.
पैकेज का नाम com.android.chrome कनेक्ट किए गए ऐप्लिकेशन के पैकेज का नाम.
टाइमस्टैंप 1506297600000 इंटरनेट कनेक्शन होने पर, टाइमस्टैंप रिकॉर्ड किया जाता है. यह वैल्यू, कनेक्शन और 1 जनवरी, 1970 यूटीसी की आधी रात के बीच का मिलीसेकंड इंटरवल है.
आईडी 26 लगातार बढ़ने वाला न्यूमेरिक आईडी. यह सुविधा, Android 9.0 (एपीआई लेवल 28) या इसके बाद के वर्शन पर उपलब्ध है.

नेटवर्क लॉगिंग की सुविधा, किसी इवेंट को तब रिकॉर्ड करती है, जब कोई ऐप्लिकेशन किसी होस्ट से कनेक्ट करने के लिए, स्टैंडर्ड नेटवर्क लाइब्रेरी को कॉल करता है. जैसे, Android के पहले से मौजूद एपीआई या लोकप्रिय तीसरे पक्ष की लाइब्रेरी. कम्यूनिकेट करने के लिए, सीधे सिस्टम कॉल करने वाले ऐप्लिकेशन लॉग नहीं किए जाते. याद रखें कि यूडीपी नेटवर्किंग को लॉग नहीं किया जाता. इसलिए, हो सकता है कि कुछ मीडिया स्ट्रीमिंग, मैसेजिंग, और गेमिंग ऐप्लिकेशन, लॉग में न दिखें.

उपयोगकर्ताओं को जानकारी देना

सिस्टम, डिवाइस के उपयोगकर्ताओं को सूचना देता है कि नेटवर्क पर की जाने वाली गतिविधि को लॉग करने की सुविधा चालू है. उपयोगकर्ताओं को इंटरफ़ेस में ये चेतावनियां दिखती हैं:

  • डिवाइस मैनेजमेंट डायलॉग बॉक्स में एक सेक्शन होता है. इसमें बताया जाता है कि आपका DPC, नेटवर्क ट्रैफ़िक पर नज़र रख रहा है. उपयोगकर्ताओं को यह डायलॉग बॉक्स, क्विक सेटिंग में मैनेज किए जा रहे डिवाइस की जानकारी वाले लेबल पर टैप करने पर दिखता है.
  • सिस्टम की ओर से भेजी गई एक सूचना, जिसे खारिज किया जा सकता है. यह सूचना तब दिखती है, जब उपयोगकर्ता नेटवर्क लॉगिंग का इस्तेमाल पहली बार करता है. सूचना पर टैप करने से, डिवाइस की निगरानी वाला डायलॉग बॉक्स दिखता है. इसमें नेटवर्क की निगरानी वाले सेक्शन में ज़्यादा जानकारी दी जाती है. जब आपका DPC, नेटवर्क लॉगिंग की सुविधा बंद कर देता है, तो सूचना दिखनी बंद हो जाती है.

अपने DPC में नेटवर्क लॉगिंग की सुविधा जोड़ना

आईटी एडमिन को नेटवर्क लॉग की समीक्षा करने में मदद करने के लिए, आपके DPC को ये टास्क पूरे करने होंगे:

  • नेटवर्क लॉगिंग की सुविधा को चालू या बंद करना.
  • नया बैच तैयार होने पर, रिकॉर्ड किए गए लॉग वापस पाना.
  • लॉग में मौजूद काम के डेटा को किसी सर्वर पर भेजना.

ज़रूरी शर्तें

नेटवर्क लॉगिंग की सुविधा, डिवाइस के मालिक के लिए Android 8.0 (एपीआई लेवल 26) या इसके बाद के वर्शन पर उपलब्ध है. साथ ही, मैनेज की जा रही प्रोफ़ाइल के मालिक के लिए, यह सुविधा Android 12 (एपीआई लेवल 31) या इसके बाद के वर्शन पर उपलब्ध है. नेटवर्क पर की जाने वाली गतिविधि को लॉग करने से पहले, आपके डीपीसी को यह देखना चाहिए कि वह डिवाइस का मालिक है या मैनेज की जा रही प्रोफ़ाइल का मालिक है. अगर प्रोफ़ाइल के मालिक ने निजी प्रोफ़ाइल को चालू किया है, तो वर्क प्रोफ़ाइल वाले डिवाइस के मालिक के नेटवर्क लॉग में, निजी प्रोफ़ाइल पर की गई नेटवर्क गतिविधि शामिल नहीं होती.

नेटवर्क लॉगिंग की सुविधा चालू करना

नेटवर्क पर की जाने वाली गतिविधि को लॉग करना शुरू करने के लिए, DevicePolicyManager मेथड setNetworkLoggingEnabled() को कॉल करें और true को enabled आर्ग्युमेंट के तौर पर पास करें. आपका DPC, isNetworkLoggingEnabled() को कॉल करके यह पता कर सकता है कि नेटवर्क पर की जाने वाली गतिविधि को लॉग किया गया है या नहीं.

डीपीसी के नेटवर्क लॉगिंग की सुविधा चालू करने के बाद, लॉग का पहला बैच तैयार होने में कुछ समय लग सकता है. ऐसा हो सकता है कि आपको अपने यूज़र इंटरफ़ेस में, आईटी एडमिन के लिए डिलीवरी से जुड़ी उम्मीदें सेट करनी हों.

नेटवर्क पर की जाने वाली गतिविधि को लॉग करना बंद करने के लिए, setNetworkLoggingEnabled() को कॉल करें और false को पास करें. जब कोई आईटी एडमिन नेटवर्क लॉगिंग की सुविधा बंद करता है, तो सिस्टम इकट्ठा किए गए और रिपोर्ट नहीं किए गए सभी लॉग मिटा देता है.

सेव किए गए लॉग वापस पाएं

आपका DPC, बैच में लॉग वापस पा सकता है. नेटवर्क लॉगिंग API, पिछली एंट्री को रैंडम तरीके से ऐक्सेस करने की सुविधा नहीं देते. जब लॉग का नया बैच उपलब्ध होता है, तो आपके डीपीसी के DeviceAdminReceiver सबक्लास को onNetworkLogsAvailable() कॉलबैक मिलता है. कॉलबैक में एक बैच टोकन शामिल होता है. इसका इस्तेमाल करके, आपका डीपीसी लॉग वापस पा सकता है. नेटवर्क इवेंट की सूची पाने के लिए, आपका DPC DevicePolicyManager तरीके retrieveNetworkLogs() को कॉल करता है.

यहां दिए गए उदाहरण में, 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 ...
}

आपके डीपीसी को लॉग तुरंत वापस लाने चाहिए, क्योंकि सिस्टम लॉग मिटा देता है, ताकि नए बैच के लिए जगह बनाई जा सके. जब तक आपको यह पक्का न हो जाए कि आपके DPC ने सभी लॉग को बिना किसी समस्या के प्रोसेस कर लिया है, तब तक लॉग की लोकल कॉपी को सेव करके रखें.

किसी भी लॉग को प्रोसेस करना

आम तौर पर, लॉग के बैच में DnsEvent और ConnectEvent इंस्टेंस का मिक्स होता है. डीएनएस लुकअप और इंटरनेट कनेक्शन के डेटा फ़ील्ड के बारे में ज़्यादा जानने के लिए, गतिविधियों का ब्यौरा देखें. इवेंट, समय के हिसाब से क्रम में लगे होते हैं. साथ ही, हर बैच में 1,200 से ज़्यादा इवेंट नहीं होते.

लॉग वापस पाने के लिए कॉल करने के बाद, देखें कि रिटर्न वैल्यू null न हो. अगर इनमें से कोई एक स्थिति होती है, तो वैल्यू null हो सकती है:

  • बैच टोकन से दिखाया गया बैच अब उपलब्ध नहीं है. आपका डीपीसी, बैच को वापस नहीं पा सकता. इसलिए, उसे अगले बैच का इंतज़ार करना चाहिए.
  • आईटी एडमिन ने नेटवर्क लॉगिंग की सुविधा बंद कर दी है.

यहां दिए गए आसान उदाहरण में बताया गया है कि डीपीसी, रिज़ॉल्व किए गए डीएनएस होस्टनेम को कैसे निकाल सकता है. आपके DPC को ज़्यादा बेहतर प्रोसेसिंग और रिपोर्टिंग की ज़रूरत है.

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

पिछले उदाहरण में यह भी बताया गया है कि Android 9.0 (एपीआई लेवल 28) या इसके बाद के वर्शन में शामिल इवेंट के लिए, अंकों वाला आईडी कैसे पाया जा सकता है. हर इवेंट के लिए आईडी लगातार बढ़ता है. इसलिए, आईटी एडमिन को उनके लॉग में मौजूद गैप का पता लगाने में मदद की जा सकती है. जब भी कोई DPC, लॉगिंग की सुविधा चालू करता है या डिवाइस रीस्टार्ट होता है, तब सिस्टम आईडी को रीसेट कर देता है.

आपका DPC, पूरे कलेक्शन को किसी सर्वर पर भेज सकता है या आपके पास डिवाइस पर इवेंट को फ़िल्टर करने का विकल्प होता है. उदाहरण के लिए, सिर्फ़ उन इवेंट की रिपोर्ट की जा सकती है जिन्हें आईटी एडमिन के लिए, अनुमति वाली सूची में जोड़ा गया है.

डेवलपमेंट और टेस्टिंग

ऐप्लिकेशन को डेवलप और टेस्ट करते समय, हो सकता है कि आपको सैकड़ों वेब पेजों को ब्राउज़ किए बिना, onNetworkLogsAvailable() कॉलबैक पाने हों. Android 9.0 (एपीआई लेवल 28) या इसके बाद के वर्शन में, नेटवर्क के कुछ सैंपल अनुरोध किए जा सकते हैं. साथ ही, सिस्टम को लॉग-उपलब्ध होने का कॉलबैक भेजने के लिए मजबूर किया जा सकता है. अपने टर्मिनल में, यह Android डीबग ब्रिज (adb) कमांड चलाएं:

adb shell dpm force-network-logs

सिस्टम यह तय करता है कि इस टूल का इस्तेमाल कितनी बार किया जा सकता है. साथ ही, टर्मिनल आउटपुट में जान-बूझकर की गई किसी भी देरी की रिपोर्ट करता है. अगर वापस पाने के लिए कोई लॉग नहीं है, तो आपके डीपीसी को कॉलबैक नहीं मिलता.