Permissões da API para o Microsoft Information Protection SDK

O SDK MIP utiliza dois serviços backend Azure para rotulagem e proteção. Na lâmina de permissões da aplicação Microsoft Entra, estes serviços são:

  • Serviço de Gestão de Direitos do Azure
  • Serviço de Sincronização de Proteção de Informação Microsoft Purview

Conceda permissões de aplicação a uma ou mais APIs quando usar o MIP SDK para rotulagem e proteção. Diferentes cenários de autenticação de aplicações podem exigir permissões distintas. Para cenários de autenticação de aplicações, veja Cenários de autenticação.

Conceda consentimento administrativo a todo o inquilino para permissões de aplicação quando essas permissões exijam o consentimento do administrador. Para mais informações, consulte a documentação do Microsoft Entra.

Permissões do aplicativo

As permissões da aplicação permitem que uma aplicação no Microsoft Entra ID atue como entidade independente, em vez de em nome de um utilizador específico.

Service Nome da permissão Descrição Consentimento do administrador necessário
Serviço de Gestão de Direitos do Azure Content.SuperUser Leia todo o conteúdo protegido deste inquilino Sim
Serviço de Gestão de Direitos do Azure Content.DelegatedReader Leia conteúdo protegido em nome de um utilizador Sim
Serviço de Gestão de Direitos do Azure Conteúdo.DelegadoEscritor Crie conteúdo protegido em nome de um utilizador Sim
Serviço de Gestão de Direitos do Azure Redator de Conteúdo Criar conteúdo protegido Sim
Serviço de Gestão de Direitos do Azure Application.Read.All Não é necessária permissão para utilização do MIP SDK Não aplicável
Serviço de Sincronização MIP UnifiedPolicy.Tenant.Read Leia todas as políticas unificadas do locatário Sim

Content.SuperUser

Use esta permissão quando uma aplicação precisar de desencriptar todo o conteúdo protegido para o tenant específico. Exemplos de serviços que requerem Content.SuperUser direitos são a prevenção de perda de dados ou os serviços de corretores de segurança de acesso à nuvem, que têm de visualizar todo o conteúdo em texto simples para tomar decisões políticas sobre onde esses dados podem fluir ou ser armazenados.

Conteúdo.DelegadoEscritor

Use esta permissão quando uma aplicação precisar de encriptar conteúdos protegidos por um utilizador específico. Exemplos de serviços que requerem Content.DelegatedWriter direitos são aplicações de linha de negócio que precisam de encriptar conteúdos com base nas políticas de etiquetas do utilizador, aplicar rótulos ou encriptar conteúdo nativamente. Esta permissão permite à aplicação encriptar conteúdos no contexto do utilizador.

Content.DelegatedReader

Use esta permissão quando uma aplicação precisar de desencriptar todo o conteúdo protegido para um utilizador específico. Exemplos de serviços que requerem Content.DelegatedReader direitos são aplicações de linha de negócio que precisam de desencriptar conteúdo com base nas políticas de etiquetas do utilizador e exibir o conteúdo de forma nativa. Esta permissão permite à aplicação desencriptar e ler conteúdos no contexto do utilizador.

Redator de Conteúdo

Use esta permissão quando uma aplicação precisar de listar modelos e encriptar conteúdo. Um serviço que tenta listar modelos sem esta permissão recebe do serviço uma mensagem a indicar que o token foi rejeitado. Exemplos de serviços que requerem Content.Writer são aplicações de linha de negócio que aplicam etiquetas de classificação a ficheiros na exportação. O Content.Writer encripta o conteúdo como identidade do principal do serviço, pelo que o proprietário dos ficheiros protegidos é a identidade do principal do serviço.

UnifiedPolicy.Tenant.Read

Use esta permissão quando uma aplicação precisar de descarregar políticas unificadas de rotulagem para o inquilino. Exemplos de serviços que requerem UnifiedPolicy.Tenant.Read são aplicações que precisam de funcionar com rótulos como identidade principal de serviço.

Permissões delegadas

Permissões delegadas permitem que uma aplicação no Microsoft Entra ID realize ações em nome de um determinado utilizador.

Service Nome da permissão Descrição Consentimento do administrador necessário
Serviço de Gestão de Direitos do Azure user_impersonation Criar e aceder a conteúdos protegidos para o utilizador No
Serviço de Sincronização MIP UnifiedPolicy.User.Read Leia todas as políticas unificadas a que um utilizador tem acesso No

user_impersonation

Use esta permissão quando uma aplicação precisar de utilizar os Serviços de Gestão de Direitos do Azure em nome do utilizador. Exemplos de serviços que exigem user_impersonation direitos são aplicações que precisam de encriptar ou aceder a conteúdos com base nas políticas de etiquetas do utilizador para aplicar rótulos ou encriptar conteúdo nativamente.

UnifiedPolicy.User.Read

Use esta permissão quando uma aplicação precisa de ler políticas unificadas de rotulagem relacionadas com um utilizador. Exemplos de serviços que requerem UnifiedPolicy.User.Read permissões são aplicações que precisam de encriptar e desencriptar conteúdos com base nas políticas de rótulos do utilizador.