Ghi nhật ký hoạt động mạng

Tài liệu này giải thích cách trình kiểm soát chính sách thiết bị (DPC) ghi nhật ký hoạt động mạng. Hãy tiếp tục đọc để tìm hiểu cách thêm tính năng ghi nhật ký mạng vào DPC.

Tổng quan

Việc ghi nhật ký hoạt động mạng có thể giúp doanh nghiệp phát hiện và theo dõi sự lây lan của phần mềm độc hại trên thiết bị của họ. DPC có thể gọi API ghi nhật ký mạng để báo cáo các kết nối TCP và tra cứu DNS từ các lệnh gọi mạng hệ thống.

Thông thường, DPC sẽ gửi nhật ký đến một máy chủ để trình bày cho quản trị viên CNTT. Bạn có thể muốn xử lý thêm nhật ký trên máy chủ hoặc trên thiết bị. Ví dụ: bạn có thể thiết lập danh sách từ chối DNS để phát hiện và cảnh báo cho quản trị viên CNTT về hành vi đáng ngờ.

Phạm vi cung cấp

Tính năng ghi nhật ký mạng được hỗ trợ trên Android 8 trở lên cho chủ sở hữu thiết bị. Nếu bạn bật chính sách này, thì chính sách này sẽ thu thập dữ liệu về hoạt động mạng của thiết bị. Tính năng này cũng được hỗ trợ trong Android 12 trở lên cho chủ sở hữu hồ sơ của một hồ sơ được quản lý và một ứng dụng được uỷ quyền có DELEGATION_NETWORK_LOGGING. Khi chủ sở hữu hồ sơ bật tính năng ghi nhật ký mạng, nhật ký mạng chỉ bao gồm hoạt động mạng của hồ sơ công việc và không thu thập dữ liệu từ hồ sơ cá nhân.

Bạn nên liên kết người dùng mới ngay khi DPC hoặc người dùng thiết bị tạo người dùng mới. Chủ sở hữu thiết bị có thể theo dõi các thông báo hoặc lệnh gọi lại, chẳng hạn như onUserAdded() (được gửi đến chủ sở hữu thiết bị thay vì gửi đến một ứng dụng ghi nhật ký được uỷ quyền), để chủ sở hữu hồ sơ của người dùng mới có thể liên kết người dùng. Để tìm hiểu thêm, hãy đọc bài viết Người dùng liên kết.

Nhật ký sự kiện

Khi tính năng ghi nhật ký mạng đang hoạt động, Android sẽ ghi lại từng sự kiện từ các ứng dụng sử dụng thư viện mạng của hệ thống. Tính năng ghi nhật ký mạng ghi lại hai loại sự kiện:

  • Tra cứu DNS
  • Kết nối mạng

Tra cứu DNS

Tính năng ghi nhật ký mạng ghi lại một sự kiện cho các lượt tra cứu DNS thuộc yêu cầu mạng hệ thống. Nhật ký ghi lại từng yêu cầu DNS phân giải tên máy chủ thành địa chỉ IP. Các truy vấn DNS hỗ trợ khác, chẳng hạn như khám phá máy chủ định danh, không được ghi lại.

Các API ghi nhật ký hoạt động mạng trình bày mỗi lượt tra cứu DNS dưới dạng một thực thể DnsEvent. Bảng 1 mô tả các trường và giá trị thông thường được ghi vào DnsEvent.

Bảng 1. Trường về sự kiện DNS

Dữ liệu Ví dụ Mô tả
Tên máy chủ host.example.com Tên máy chủ được gửi trong truy vấn DNS.
Địa chỉ Inet 203.0.113.9, 198.51.100.25 Danh sách địa chỉ IPv4 hoặc IPv6 mà truy vấn DNS đã phân giải cho tên máy chủ. Để giữ cho kích thước nhật ký ở mức có thể quản lý, kết quả có thể không bao gồm tất cả địa chỉ IP. Hãy xem số lượng địa chỉ trong hàng sau.
Số lượng địa chỉ 4 Số lượng địa chỉ IP được trả về từ quá trình phân giải truy vấn DNS. Hãy sử dụng cách này để tìm hiểu xem các địa chỉ IP được ghi lại có phải là một tập hợp con của kết quả hay không. Giá trị 0 (không) có nghĩa là tên máy chủ không phân giải thành địa chỉ IP.
Tên gói com.android.chrome Tên gói của ứng dụng đã thực hiện truy vấn DNS.
Dấu thời gian 1506297600000 Dấu thời gian ghi lại thời điểm diễn ra quá trình tra cứu DNS. Giá trị này là khoảng thời gian tính bằng mili giây giữa thời điểm tra cứu DNS và nửa đêm ngày 1 tháng 1 năm 1970 theo giờ UTC.
ID 25 Mã nhận dạng dạng số tăng dần đơn điệu. Có trong Android 9.0 (cấp độ API 28) trở lên.

Mặc dù việc tra cứu DNS có thể giúp quản trị viên CNTT theo dõi các kết nối mạng, nhưng tính năng ghi nhật ký mạng không phải là một giải pháp ghi bản ghi DNS cho mục đích chung. Sau đây là một số tác vụ DNS mà ứng dụng có thể thực hiện nhưng không được ghi lại:

  • Giao tiếp trực tiếp với máy chủ định danh DNS.
  • Gọi thư viện DNS Java để tạo truy vấn DNS.
  • Tránh truy vấn DNS bằng cách kết nối với một địa chỉ IP cố định.

Kết nối mạng

Tính năng ghi nhật ký mạng ghi lại một sự kiện cho mỗi lần kết nối thử thuộc một yêu cầu mạng hệ thống. Nhật ký ghi lại các kết nối TCP thành công và không thành công, còn các lượt chuyển UDP thì không được ghi lại.

API ghi nhật ký hoạt động mạng trình bày mỗi kết nối dưới dạng một thực thể ConnectEvent. Bảng 2 mô tả các trường và giá trị thông thường được ghi vào ConnectEvent.

Bảng 2. Trường sự kiện kết nối

Dữ liệu Ví dụ Mô tả
Địa chỉ Inet 2001:db8::2f:abc:0 Địa chỉ IP mà thiết bị đã kết nối. Đây có thể là địa chỉ IPv4 hoặc IPv6.
Cổng 80 Số cổng TCP mà thiết bị đã kết nối.
Tên gói com.android.chrome Tên gói của ứng dụng đã kết nối.
Dấu thời gian 1506297600000 Dấu thời gian ghi lại thời điểm kết nối mạng. Giá trị này là khoảng thời gian tính bằng mili giây giữa thời điểm kết nối và nửa đêm ngày 1 tháng 1 năm 1970 theo giờ UTC.
ID 26 Mã nhận dạng dạng số tăng dần đơn điệu. Có trong Android 9.0 (cấp độ API 28) trở lên.

Tính năng ghi nhật ký mạng sẽ ghi lại một sự kiện khi ứng dụng gọi các thư viện mạng chuẩn (chẳng hạn như API tích hợp sẵn của Android hoặc thư viện phổ biến của bên thứ ba) để kết nối với máy chủ lưu trữ. Các ứng dụng trực tiếp đưa ra lệnh gọi hệ thống để giao tiếp sẽ không được ghi lại. Xin lưu ý rằng hoạt động kết nối mạng UDP không được ghi lại, nên một số ứng dụng truyền trực tuyến nội dung nghe nhìn, nhắn tin và ứng dụng trò chơi có thể không xuất hiện trong nhật ký.

Thông báo cho người dùng

Hệ thống sẽ cảnh báo người dùng thiết bị rằng tính năng ghi nhật ký hoạt động mạng đang hoạt động. Người dùng sẽ thấy các cảnh báo sau trong giao diện:

  • Một phần trong hộp thoại Trình quản lý thiết bị giải thích rằng trình kiểm soát chính sách thiết bị (DPC) của bạn đang giám sát lưu lượng truy cập mạng. Người dùng sẽ thấy hộp thoại này khi nhấn vào nhãn thông tin về thiết bị được quản lý trong phần Cài đặt nhanh.
  • Thông báo hệ thống có thể đóng, xuất hiện khi người dùng mới sử dụng tính năng ghi nhật ký mạng. Khi nhấn vào thông báo, bạn sẽ thấy hộp thoại Giám sát thiết bị kèm theo nội dung giải thích thêm trong phần giám sát mạng. Thông báo sẽ biến mất khi DPC tắt tính năng ghi nhật ký mạng.

Thêm tính năng ghi nhật ký mạng vào DPC

Để giúp quản trị viên CNTT xem xét nhật ký mạng, DPC của bạn cần có khả năng hoàn thành các nhiệm vụ sau:

  • Bật và tắt tính năng ghi nhật ký mạng.
  • Truy xuất mọi nhật ký đã ghi khi có một lô mới.
  • Gửi dữ liệu hữu ích trong nhật ký đến máy chủ.

Yêu cầu

Tính năng ghi nhật ký mạng có trong Android 8.0 (cấp độ API 26) trở lên cho chủ sở hữu thiết bị và Android 12 (cấp độ API 31) trở lên cho chủ sở hữu hồ sơ của một hồ sơ được quản lý. Trước khi ghi nhật ký hoạt động mạng, DPC của bạn nên kiểm tra xem đó có phải là chủ sở hữu thiết bị hay chủ sở hữu hồ sơ của một hồ sơ được quản lý hay không. Nhật ký mạng trong chủ sở hữu thiết bị có hồ sơ công việc không bao gồm hoạt động mạng trên hồ sơ cá nhân nếu chủ sở hữu hồ sơ bật tính năng này.

Bật tính năng ghi nhật ký mạng

Để bắt đầu ghi nhật ký hoạt động mạng, hãy gọi phương thức DevicePolicyManager setNetworkLoggingEnabled() và truyền true làm đối số enabled. DPC có thể gọi isNetworkLoggingEnabled() để kiểm tra xem hoạt động mạng có được ghi lại hay không.

Sau khi DPC bật tính năng ghi nhật ký mạng, có thể mất một khoảng thời gian trước khi lô nhật ký đầu tiên sẵn sàng. Bạn nên đặt ra kỳ vọng về việc phân phối cho quản trị viên CNTT trong giao diện người dùng.

Để dừng ghi nhật ký hoạt động mạng, hãy gọi setNetworkLoggingEnabled() và truyền false. Khi quản trị viên CNTT tắt tính năng ghi nhật ký mạng, hệ thống sẽ xoá mọi nhật ký đã thu thập và chưa báo cáo.

Truy xuất nhật ký

DPC có thể truy xuất nhật ký theo lô – API ghi nhật ký mạng không cung cấp quyền truy cập ngẫu nhiên vào từng mục nhập trước đây. Khi có một loạt nhật ký mới, lớp con DeviceAdminReceiver của DPC sẽ nhận được lệnh gọi lại onNetworkLogsAvailable(). Lệnh gọi lại bao gồm một mã thông báo theo lô mà DPC có thể sử dụng để truy xuất nhật ký. DPC của bạn gọi phương thức DevicePolicyManager retrieveNetworkLogs() để lấy danh sách các sự kiện mạng.

Ví dụ sau đây cho thấy bạn có thể truy xuất nhật ký trong lớp con 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 của bạn nên truy xuất nhật ký ngay lập tức vì hệ thống sẽ xoá nhật ký để nhường chỗ cho các lô mới. Bạn nên giữ bản sao cục bộ của nhật ký cho đến khi chắc chắn rằng DPC đã xử lý tất cả nhật ký mà không gặp vấn đề gì.

Xử lý mọi nhật ký

Một lô nhật ký thường chứa cả thực thể DnsEvent và ConnectEvent. Để tìm hiểu thêm về các trường dữ liệu của hoạt động tra cứu DNS và kết nối mạng, hãy xem phần Nhật ký sự kiện. Các sự kiện được sắp xếp theo thứ tự thời gian và mỗi lô chứa không quá 1.200 sự kiện.

Sau khi gọi để truy xuất nhật ký, hãy kiểm tra để đảm bảo giá trị trả về không phải là null. Giá trị có thể là null nếu một trong những trường hợp sau xảy ra:

  • Lô được đại diện bằng mã thông báo lô không còn nữa. DPC của bạn không thể truy xuất lô này và nên đợi lô tiếp theo.
  • Quản trị viên CNTT đã tắt tính năng ghi nhật ký mạng.

Ví dụ đơn giản sau đây cho thấy cách DPC có thể trích xuất tên máy chủ DNS đã phân giải. DPC của bạn cần có quy trình xử lý và báo cáo tinh vi hơn.

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

Ví dụ trước cũng cho thấy cách bạn có thể lấy mã nhận dạng dạng số cho các sự kiện có trong Android 9.0 (cấp độ API 28) trở lên. Vì mã nhận dạng tăng dần cho mỗi sự kiện, nên bạn có thể giúp quản trị viên CNTT phát hiện các khoảng trống trong nhật ký của họ. Hệ thống sẽ đặt lại mã nhận dạng bất cứ khi nào DPC bật tính năng ghi nhật ký hoặc khi thiết bị khởi động lại.

DPC có thể gửi toàn bộ tập hợp đến một máy chủ hoặc bạn có thể quyết định lọc các sự kiện trên thiết bị. Ví dụ: bạn có thể chỉ báo cáo những sự kiện được thêm vào danh sách cho phép dành cho quản trị viên CNTT.

Phát triển và kiểm thử

Trong khi phát triển và thử nghiệm, bạn có thể muốn nhận lệnh gọi lại onNetworkLogsAvailable() mà không cần phải duyệt qua hàng trăm trang web. Trong Android 9.0 (cấp độ API 28) trở lên, bạn có thể gửi một vài yêu cầu mạng mẫu và buộc hệ thống gửi một lệnh gọi lại cho biết nhật ký có sẵn. Chạy lệnh Cầu gỡ lỗi Android (adb) sau đây trong dòng lệnh:

adb shell dpm force-network-logs

Hệ thống giới hạn tần suất bạn có thể sử dụng công cụ này và báo cáo mọi trường hợp cố ý làm chậm trong kết quả của thiết bị đầu cuối. Nếu không có nhật ký nào để truy xuất, thì DPC sẽ không nhận được lệnh gọi lại.