Pengauditan dalam SDK MIP File

Log audit terpadu menyediakan akses ke peristiwa audit. Peristiwa ini menunjukkan label mana yang diterapkan pengguna, secara manual atau otomatis, di seluruh aplikasi atau layanan apa pun yang terintegrasi dengan Microsoft Information Protection (MIP) SDK. Mitra pengembangan yang menggunakan SDK dapat mengaktifkan fungsionalitas ini untuk menampilkan informasi dari aplikasi mereka dalam laporan pelanggan.

Mengaktifkan Audit

Secara default, MIP SDK tidak mengirim peristiwa audit. Audit harus diaktifkan dalam satu atau beberapa kebijakan label agar peristiwa audit dapat dipicu dari aplikasi yang diaktifkan dengan MIP SDK.

Untuk mengirim data audit, aktifkan pengaturan tingkat lanjut berikut.

• Tambahkan kebijakan berikut pengaturan tingkat lanjut menggunakan Security & Compliance Center PowerShell:

  • Kunci: EnableAudit
  • Nilai: Benar

  Misalnya, jika kebijakan label Anda diberi nama "Global":

  Set-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="True"}
  

  Nota

  Secara default, pengaturan tingkat lanjut ini tidak ada dalam kebijakan, dan log audit tidak dikirim.

Jenis Peristiwa

Ada tiga jenis peristiwa yang dapat dikirimkan melalui SDK ke Microsoft Purview. Kejadian heartbeat, kejadian penemuan, dan kejadian perubahan

Peristiwa Detak Jantung

Peristiwa heartbeat dihasilkan secara otomatis untuk aplikasi apa pun yang terintegrasi dengan File SDK. Peristiwa Heartbeat tercatat sebagai peristiwa AipHeartBeat di log audit terpadu. Peristiwa detak jantung meliputi:

• ID Penyewa
• Waktu Pembuatan
• Nama Utama Pengguna
• Nama komputer tempat audit dihasilkan
• Nama Proses
• Plattform
• ID Aplikasi - Sesuai dengan ID Aplikasi Microsoft Entra.

Peristiwa ini berguna dalam mendeteksi aplikasi di seluruh perusahaan Anda yang menggunakan Microsoft Information Protection SDK.

Peristiwa Penemuan

Peristiwa penemuan memberikan informasi tentang informasi berlabel yang dibaca atau digunakan dengan File SDK. Acara ini bermanfaat karena mereka mengungkapkan perangkat, lokasi, dan pengguna yang mengakses informasi di seluruh organisasi. Peristiwa penemuan muncul di log audit terpadu sebagai peristiwa AipDiscover.

Dengan mengatur parameter AuditDiscoveryEnabled ke true saat membuat mip::FileHandler baru, peristiwa ini dikirim ke audit. Selain itu, disediakan pengidentifikasi konten yang mengenali file dalam format yang mudah dibaca manusia. Lokasi file umumnya sebaiknya digunakan untuk pengenal ini.

Contoh berikut membuat mip::FileHandler baru dengan penemuan audit yang diaktifkan. Metode CreateFileHandler() ini dipanggil pada mip::FileEngine dan AuditDiscoveryEnabled diatur ke true. FileHandler Setelah membaca label, audit penemuan dihasilkan.

// Create FileHandler with discovery enabled
auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
auto handlerFuture = handlerPromise->get_future();
fileEngine->CreateFileHandlerAsync(inputFilePath, actualFilePath, true /*AuditDiscoveryEnabled*/, make_shared<FileHandlerObserver>(), createFileHandlerPromise);
auto handler = handlerFuture.get();

// Read label. This generates the discovery audit.
auto label = handler->GetLabel();

Ubah Peristiwa

Peristiwa perubahan menyediakan informasi tentang file, label yang diterapkan atau diubah, dan pembenaran apa pun yang disediakan oleh pengguna. Peristiwa perubahan dihasilkan dengan memanggil NotifyCommitSuccessful() pada mip::FileHandler, setelah perubahan berhasil diterapkan ke file. Peristiwa perubahan dapat muncul di audit terpadu sebagai AipSensitivityLabelAction, AipProtectionAction, atau AipFileDeleted.

// Create labeling options, set label
string contentId = "C:\\users\\myuser\\Documents\\MyPlan.docx";
mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);
handler->SetLabel(labelId, labelingOptions, mip::ProtectionSettings());
auto commitPromise = std::make_shared<std::promise<bool>>();
auto commitFuture = commitPromise->get_future();

// CommitAsync() returns a bool. If the change was successful, call NotifyCommitSuccessful().
fileHandler->CommitAsync(outputFile, commitPromise);
if(commitFuture.get()) {

    // Submit audit event.
    handler->NotifyCommitSuccessful(contentId);
}