API-machtigingen voor de Microsoft Information Protection SDK

De MIP SDK maakt gebruik van twee back-end Azure-services voor labeling en beveiliging. In de Microsoft Entra-app-machtigingen blade zijn de volgende services:

  • Azure Rights Management-dienst
  • Microsoft Purview Informatiebeveiliging-synchronisatieservice

Toepassingsmachtigingen verlenen aan een of meer API's wanneer u de MIP SDK gebruikt voor labelen en beveiliging. Voor verschillende scenario's voor toepassingsverificatie zijn mogelijk verschillende toepassingsmachtigingen vereist. Zie Verificatiescenario's voor toepassingsverificatie.

Verlenen tenantbrede beheerderstoestemming voor toepassingsmachtigingen wanneer deze machtigingen beheerderstoestemming vereisen. Zie de Microsoft Entra-documentatie voor meer informatie.

Toepassingstoestemming

Met toepassingsmachtigingen kan een toepassing in Microsoft Entra ID fungeren als een eigen entiteit in plaats van namens een specifieke gebruiker.

Dienst Machtigingsnaam Beschrijving Beheerderstoestemming vereist
Azure Rights Management-dienst Inhoud.Supergebruiker Alle beveiligde inhoud voor deze tenant lezen Ja
Azure Rights Management-dienst Content.DelegatedReader Beveiligde inhoud lezen namens een gebruiker Ja
Azure Rights Management-dienst Content.DelegatedWriter Beveiligde inhoud maken namens een gebruiker Ja
Azure Rights Management-dienst Contentauteur Beveiligde inhoud maken Ja
Azure Rights Management-dienst Application.Read.All De machtiging is niet vereist voor MIP SDK-gebruik Niet van toepassing
MIP-synchronisatieservice UnifiedPolicy.Tenant.Read Alle geünificeerde beleidsregels van de tenant lezen Ja

Inhoud.Supergebruiker

Gebruik deze machtiging wanneer een toepassing alle inhoud moet ontsleutelen die voor de specifieke tenant zijn beveiligd. Voorbeelden van services waarvoor rechten zijn vereist Content.SuperUser , zijn preventie van gegevensverlies of beveiligingsbrokerservices voor cloudtoegang die alle inhoud in tekst zonder opmaak moeten bekijken om beleidsbeslissingen te nemen over waar die gegevens kunnen stromen of worden opgeslagen.

Content.DelegatedWriter

Gebruik deze machtiging wanneer een toepassing inhoud moet versleutelen die wordt beveiligd door een specifieke gebruiker. Voorbeelden van services waarvoor rechten zijn vereist Content.DelegatedWriter , zijn Line-Of-Business-toepassingen die inhoud moeten versleutelen op basis van het labelbeleid van een gebruiker, labels toepassen of inhoud systeemeigen versleutelen. Met deze machtiging kan de toepassing inhoud versleutelen in de context van de gebruiker.

Content.DelegatedReader

Gebruik deze machtiging wanneer een toepassing alle inhoud moet ontsleutelen die voor een specifieke gebruiker is beveiligd. Voorbeelden van services die Content.DelegatedReader-rechten vereisen, zijn line-of-business-toepassingen die inhoud moeten ontsleutelen volgens het labelbeleid van een gebruiker en de inhoud systeemeigen weergeven. Met deze machtiging kan de toepassing inhoud ontsleutelen en lezen in de context van de gebruiker.

Contentauteur

Gebruik deze machtiging wanneer een toepassing sjablonen moet vermelden en inhoud moet versleutelen. Een service die zonder deze machtiging probeert een lijst met sjablonen op te vragen, ontvangt van de service een bericht dat het token is geweigerd. Voorbeelden van services die Content.Writer vereisen, zijn bedrijfstoepassingen die classificatielabels toepassen op bestanden bij het exporteren. Content.Writer versleutelt de inhoud als de identiteit van de service-principal, dus de eigenaar van de beveiligde bestanden is de identiteit van de service-principal.

UnifiedPolicy.Tenant.Read

Gebruik deze machtiging wanneer een toepassing geïntegreerd labelbeleid voor de tenant moet downloaden. Voorbeelden van services die UnifiedPolicy.Tenant.Read vereisen, zijn toepassingen die met labels moeten werken als een service-principal-id.

Gedelegeerde machtigingen

Met gedelegeerde machtigingen kan een toepassing in Microsoft Entra ID acties uitvoeren namens een bepaalde gebruiker.

Dienst Machtigingsnaam Beschrijving Beheerderstoestemming vereist
Azure Rights Management-dienst user_impersonation Beveiligde inhoud voor de gebruiker maken en openen No
MIP-synchronisatieservice UnifiedPolicy.User.Read Lees alle geïntegreerde beleidsregels waartoe een gebruiker toegang heeft No

user_impersonation

Gebruik deze machtiging wanneer een toepassing namens de gebruiker Azure Rights Management Services moet gebruiken. Voorbeelden van services waarvoor rechten zijn vereist user_impersonation , zijn toepassingen die inhoud moeten versleutelen of openen op basis van het labelbeleid van een gebruiker om labels toe te passen of inhoud systeemeigen te versleutelen.

UnifiedPolicy.User.Read

Gebruik deze machtiging wanneer een toepassing geïntegreerd labelbeleid met betrekking tot een gebruiker moet lezen. Voorbeelden van services waarvoor machtigingen zijn vereist UnifiedPolicy.User.Read , zijn toepassingen die inhoud moeten versleutelen en ontsleutelen op basis van het labelbeleid van een gebruiker.