Revision i MIP SDK

Microsoft Purview-portal ger åtkomst till granskningsrapporter via Aktivitetsutforskaren. Dessa rapporter ger insyn i de etiketter som användarna tillämpar manuellt eller automatiskt i alla program som integrerar MIP SDK. Utvecklingspartner som använder SDK:n kan aktivera den här funktionen, vilket gör att information från deras program kan visas i kundrapporter.

Händelsetyper

SDK:et kan skicka tre typer av granskningshändelser: pulsslagshändelser, identifieringshändelser och ändringshändelser.

Hjärtslagshändelser

SDK:t genererar automatiskt heartbeat-händelser för alla applikationer som integrerar Policy SDK. Hjärtslagshändelser inkluderar:

  • Hyresgivares-id
  • Tid genererad
  • Användarens huvudnamn
  • Namnet på den dator som genererade granskningen
  • Processnamn
  • Plattform
  • Applikations-ID – motsvarar Microsoft Entra-applikations-ID

Dessa händelser är användbara för att identifiera program i hela företaget som använder Microsoft Information Protection SDK.

Upptäcktshändelser

Upptäcktshändelser ger information om etiketterat innehåll som Policy SDK:t läser eller förbrukar. Dessa händelser är användbara när de visar de enheter, platser och användare som har åtkomst till information i en organisation.

För att generera upptäcktshändelser i Policy SDK anger du en flagga när du skapar mip::PolicyHandler-objektet. I följande exempel är värdet för isAuditDiscoveryEnabled inställt på true. När du skickar mip::ExecutionState till ComputeActions() eller GetSensitivityLabel() (med befintlig metadatainformation och innehållsidentifierare) skickar SDK identifieringsinformation till Microsoft Purview Aktivitetsutforskaren.

SDK:t genererar identifieringsgranskningen efter programanropen ComputeActions() eller GetSensitivityLabel() och tillhandahåller mip::ExecutionState. SDK:et genererar den här händelsen bara en gång per hanterare.

För mer information om exekveringstillstånd, se konceptdokumentationen mip::ExecutionState.

// Create PolicyHandler, passing in true for isAuditDiscoveryEnabled
auto handler = mEngine->CreatePolicyHandler(true);

// Returns vector of mip::Action and generates discovery event.
auto actions = handler->ComputeActions(*state);

//Or, get the label for a given state
auto label = handler->GetSensitivityLabel(*state);

I praktiken anger du isAuditDiscoveryEnabled till true under mip::PolicyHandler konstruktionen så att filåtkomstinformation kan flöda till Aktivitetsutforskaren.

Ändra händelse

Ändringshändelser ger information om filen, etiketten som tillämpades eller ändrades samt eventuella motiveringar som användaren har angett. Om du vill generera ändringshändelser anropar du NotifyCommittedActions()mip::PolicyHandler. Gör anropet efter att applikationen har genomfört en ändring i en fil och skicka med mip::ExecutionState, som beräknade åtgärderna.

Note

Om programmet inte anropar den här funktionen skickas inga granskningshändelser.

handler->NotifyCommittedActions(*state);

Granskningsinstrumentpanel

Granskningshändelser som skickas av SDK är tillgängliga i Microsoft Purview Aktivitetsutforskaren.

Nästa steg

  • Uppdaterades senast