Chia sẻ qua


Thu thập nhật ký kiểm tra bằng cách sử dụng API quản lý Office 365

Luồng đồng bộ nhật ký kiểm tra kết nối với Office 365 tham chiếu API Hoạt động quản lý để thu thập dữ liệu đo từ xa, chẳng hạn như người dùng duy nhất và lượt ra mắt cho ứng dụng. Các luồng sử dụng hành động HTTP để truy cập API. Trong bài viết này, bạn sẽ thiết lập đăng ký ứng dụng cho hành động HTTP và các biến môi trường cần thiết để chạy luồng.

Lưu ý

Bộ khởi động Trung tâm xuất sắc (CoE) hoạt động mà không cần các luồng này. Tuy nhiên, nếu bạn không sử dụng các luồng, thông tin sử dụng như số lần khởi chạy ứng dụng và số người dùng duy nhất sẽ trống trong bảng điều khiển. Power BI

Điều kiện tiên quyết

  1. Hoàn thành các bước trong Thiết lập Bộ khởi động CoEThiết lập các thành phần kiểm kê.
  2. Tạo môi trường của bạn.
  3. đăng nhập bằng tên người dùng chính xác.

Tiền bo

Chỉ thiết lập luồng nhật ký kiểm tra nếu bạn chọn luồng đám mây làm cơ chế cho hoạt động kiểm kê và đo từ xa.

Trước khi bạn thiết lập luồng nhật ký kiểm tra

Trước khi bắt đầu, hãy đảm bảo đáp ứng các điều kiện tiên quyết bổ sung sau:

Lưu ý

Để cấp quyền cho ứng dụng của bạn truy cập vào Office 365 API Quản lý, bạn có thể sử dụng các dịch vụ xác thực mà API cung cấp thông qua Microsoft Entra ID.

Tạo đăng ký ứng dụng để truy cập API quản lý Microsoft Entra Office 365

Thực hiện theo các bước sau để thiết lập đăng ký ứng dụng cho cuộc gọi HTTP trong luồng để kết nối với nhật ký kiểm tra. Microsoft Entra Power Automate Tìm hiểu thêm trong Bắt đầu với Office 365 API quản lý.

  1. Đăng nhập vào Cổng thông tin Azure.

  2. Đi tới Microsoft Entra ID>Đăng ký ứng dụng.

    Ảnh chụp màn hình hiển thị vị trí của dịch vụ Azure đăng ký ứng dụng.

  3. Chọn + Đăng ký mới.

  4. Nhập tên, chẳng hạn như Microsoft 365 Quản lý, nhưng không thay đổi bất kỳ cài đặt nào khác. Sau đó chọn Đăng ký.

  5. Chọn Quyền API>+ Thêm quyền.

    Ảnh chụp màn hình hiển thị vị trí của nút Thêm quyền trong menu quyền API.

  6. Chọn API quản lý Office 365 và định cấu hình các quyền như sau:

    1. Chọn Quyền ứng dụng, sau đó chọn ActivityFeed.Read.

      Ảnh chụp màn hình hiển thị cài đặt ActivityFeed.Read trên trang Yêu cầu quyền API của menu quyền API.

    2. Chọn Thêm quyền.

  7. Chọn Cấp quyền quản trị cho <tổ chức của bạn>. Tìm hiểu thêm về điều kiện tiên quyết để thiết lập nội dung quản trị.

    Quyền API hiện phản ánh các quyền ActivityFeed.Read được ủy quyền với trạng thái Được cấp cho <tổ chức của bạn>.

  8. Chọn Chứng chỉ và mã bí mật.

  9. Lựa chọn + Mã bí mật máy khách mới.

  10. Thêm mô tả và ngày hết hạn phù hợp với chính sách của tổ chức bạn. Sau đó chọn Thêm.

  11. Sao chép và dán ID ứng dụng (máy khách) vào một tài liệu văn bản như tệp Notepad.

  12. Chọn Tổng quan, rồi sao chép và dán giá trị ID ứng dụng (máy khách) và ID thư mục (người thuê) vào cùng một tài liệu văn bản.

    Quan trọng

    Hãy đảm bảo rằng bạn ghi chú mã định danh duy nhất toàn cầu (GUID) nào tương ứng với từng giá trị. Bạn cần những giá trị này khi cấu hình trình kết nối tùy chỉnh.

Cập nhật các biến môi trường

Sử dụng biến môi trường để chọn API quản lý cũ hoặc API đồ thị. Office 365 Lưu trữ ID và bí mật của máy khách để đăng ký ứng dụng trong các biến môi trường. Tùy thuộc vào loại đám mây của bạn cho hành động HTTP, hãy đặt điểm cuối dịch vụ đối tượng và quyền hạn bằng các biến môi trường. Loại đám mây của bạn có thể là đám mây thương mại, Đám mây cộng đồng của Chính phủ Hoa Kỳ (GCC), Hoa Kỳ GCC High hoặc Bộ Quốc phòng Hoa Kỳ (DoD). Cập nhật các biến môi trường mới trước khi bạn bật luồng.

Bạn có thể lưu trữ bí mật của khách hàng dưới dạng văn bản thuần túy trong biến môi trường Nhật ký kiểm toán - Bí mật của khách hàng . Tuy nhiên, chúng tôi không khuyến khích cách tiếp cận này. Thay vào đó, hãy tạo và lưu trữ bí mật của khách hàng trong Azure Key Vault và tham chiếu bí mật đó trong biến môi trường Nhật ký kiểm toán - Bí mật Azure của khách hàng .

Lưu ý

Luồng sử dụng biến môi trường này được cấu hình với điều kiện mong đợi biến môi trường Nhật ký kiểm toán - Bí mật của khách hàng hoặc Nhật ký kiểm toán - Bí mật Azure của khách hàng . Tuy nhiên, bạn không cần phải chỉnh sửa luồng để làm việc với Azure Key Vault.

Tên Description Giá_trị
Nhật ký kiểm tra - Sử dụng API đồ thị Một tham số kiểm soát xem có nên sử dụng Graph API để truy vấn sự kiện hay không.

Không (mặc định)

Luồng đồng bộ sử dụng API quản lý cũ. Office 365

Nhật ký kiểm tra - Đối tượng Tham số đối tượng cho các cuộc gọi HTTP.
  • Thương mại (mặc định): https://manage.office.com
  • GCC: https://manage-gcc.office.com
  • GCC cao: https://manage.office365.us
  • Bộ Quốc phòng: https://manage.protection.apps.mil
Nhật ký kiểm toán - Cơ quan Trường quyền hạn trong các cuộc gọi HTTP.
  • Thương mại (mặc định): https://login.windows.net
  • GCC: https://login.windows.net
  • GCC cao: https://login.microsoftonline.us
  • Bộ Quốc phòng: https://login.microsoftonline.us
Nhật ký kiểm tra - ClientID ID khách hàng đăng ký ứng dụng. ID ứng dụng khách từ bước Tạo đăng ký ứng dụng để truy cập Microsoft Entra API quản lý Office 365 .
Nhật ký kiểm tra - Bí mật của khách hàng Bí mật của ứng dụng đăng ký (không phải ID bí mật mà là giá trị thực) ở dạng văn bản thuần túy.

Bí mật của ứng dụng khách từ bước Tạo đăng ký ứng dụng cho bước Microsoft Entra truy cập API quản lý Office 365 .

Nếu bạn đang sử dụng Azure Key Vault để lưu trữ ID và bí mật của khách hàng, hãy để trống biến này.

Nhật ký kiểm tra - Bí mật Azure của khách hàng Tham chiếu Azure Key Vault của bí mật máy khách đăng ký ứng dụng.

Tham chiếu Azure Key Vault cho bí mật ứng dụng khách từ bước Tạo đăng ký ứng dụng cho bước Microsoft Entra Truy cập API quản lý Office 365 .

Nếu bạn đang lưu trữ ID khách hàng của mình ở dạng văn bản thuần túy trong biến môi trường Nhật ký kiểm toán - Bí mật khách hàng , hãy để biến này trống. Biến này mong đợi tham chiếu Azure Key Vault chứ không phải bí mật. Tìm hiểu thêm trong Sử dụng biến môi trường cho bí mật Azure Key Vault.

Bắt đầu đăng ký để kiểm tra nội dung nhật ký

  1. Truy cập vào make.powerapps.com.

  2. Chọn Giải pháp.

  3. Mở giải pháp Trung tâm xuất sắc – Thành phần cốt lõi .

  4. Bật luồng Quản trị | Nhật ký kiểm tra | Office 365 Đăng ký API quản lý . Chạy luồng bằng cách nhập bắt đầu làm thao tác cần chạy.

    Ảnh chụp màn hình hiển thị vị trí của nút Chạy trên thanh điều hướng và nút Bắt đầu hoạt động trong ngăn luồng Chạy.

  5. Mở luồng và xác minh rằng hành động để bắt đầu đăng ký đã được thông qua.

Quan trọng

Nếu trước đó bạn đã bật đăng ký, bạn sẽ thấy thông báo (400) Đăng ký đã được bật . Thông báo này có nghĩa là đăng ký đã được bật. Bạn có thể bỏ qua thông báo này và tiếp tục thiết lập.

Nếu bạn không thấy thông báo trước đó hoặc phản hồi (200), thì có khả năng yêu cầu đã không thành công. Có thể có lỗi trong quá trình thiết lập khiến luồng không hoạt động. Các vấn đề phổ biến cần kiểm tra là:

  • Nhật ký kiểm tra đã được bật chưa và bạn có quyền xem nhật ký kiểm tra không? Kiểm tra xem nhật ký có được bật hay không bằng cách tìm kiếm trong Microsoft Purview Compliance Manager.
  • Gần đây bạn có bật nhật ký kiểm tra không? Nếu đã bật, hãy thử lại sau vài phút để nhật ký kiểm tra kích hoạt.
  • Xác thực rằng bạn đã thực hiện đúng các bước trong Tạo đăng ký ứng dụng để truy cập Microsoft Entra API quản lý Office 365 .
  • Xác thực rằng bạn đã cập nhật đúng các biến môi trường cho các luồng này.

Bật dòng

  1. Truy cập vào make.powerapps.com.

  2. Chọn Giải pháp.

  3. Mở giải pháp Trung tâm xuất sắc – Thành phần cốt lõi .

  4. Bật luồng Quản trị | Nhật ký kiểm tra | Cập nhật dữ liệu (V2) . Luồng này cập nhật bảng với thông tin về lần khởi chạy cuối cùng. Power Apps Nó cũng thêm siêu dữ liệu vào bản ghi nhật ký kiểm tra.

  5. Bật luồng Quản trị | Nhật ký kiểm tra | Đồng bộ hóa Nhật ký kiểm tra (V2) . Luồng này chạy theo lịch trình hàng giờ và thu thập các sự kiện nhật ký kiểm tra vào bảng nhật ký kiểm tra.

Đưa ra phản hồi

Nếu bạn gặp sự cố với Bộ khởi động CoE, hãy gửi báo cáo lỗi về giải pháp tại aka.ms/coe-starter-kit-issues.