Permissões de API para o SDK da Proteção de Informações da Microsoft

O SDK do MIP usa dois serviços do Azure de back-end para rotulagem e proteção. Na folha de permissões do aplicativo Microsoft Entra, esses serviços são:

  • Serviço de Gerenciamento de Direitos do Azure
  • Serviço de Sincronização de Proteção de Informações do Microsoft Purview

Conceda permissões de aplicativo a uma ou mais APIs ao usar o SDK do MIP para rotulagem e proteção. Diferentes cenários de autenticação de aplicativo podem exigir permissões de aplicativo diferentes. Para cenários de autenticação de aplicativo, consulte cenários de autenticação.

Conceder consentimento de administrador para todo o locatário para permissões do aplicativo quando essas permissões exigirem consentimento de administrador. Para obter mais informações, consulte a documentação do Microsoft Entra.

Permissões do aplicativo

As permissões de aplicativo permitem que um aplicativo em Microsoft Entra ID atue como sua própria entidade, em vez de em nome de um usuário específico.

Serviço Nome da permissão Descrição É necessário o consentimento do administrador
Serviço de Gerenciamento de Direitos do Azure Content.SuperUser Ler todo o conteúdo protegido para esse locatário Yes
Serviço de Gerenciamento de Direitos do Azure Content.DelegatedReader Ler o conteúdo protegido em nome de um usuário Yes
Serviço de Gerenciamento de Direitos do Azure Content.DelegatedWriter Criar conteúdo protegido em nome de um usuário Yes
Serviço de Gerenciamento de Direitos do Azure Redator de Conteúdo Criar conteúdo protegido Yes
Serviço de Gerenciamento de Direitos do Azure Application.Read.All Permissão não necessária para uso do SDK do MIP Não aplicável
Serviço de Sincronização de MIP UnifiedPolicy.Tenant.Read Ler todas as políticas unificadas do locatário Yes

Content.SuperUser

Use essa permissão quando um aplicativo precisar descriptografar todo o conteúdo protegido para o locatário específico. Exemplos de serviços que exigem direitos de Content.SuperUser são prevenção contra perda de dados ou serviços de agente de segurança de acesso à nuvem que devem visualizar todo o conteúdo em texto não criptografado para tomar decisões de política sobre onde esses dados podem fluir ou ser armazenados.

Content.DelegatedWriter

Use essa permissão quando um aplicativo precisar criptografar o conteúdo protegido por um usuário específico. Exemplos de serviços que exigem Content.DelegatedWriter direitos são aplicativos de linha de negócios que precisam criptografar conteúdo com base nas políticas de rótulo de um usuário, aplicar rótulos ou criptografar conteúdo nativamente. Essa permissão permite que o aplicativo criptografe o conteúdo no contexto do usuário.

Content.DelegatedReader

Use essa permissão quando um aplicativo precisar descriptografar todo o conteúdo protegido para um usuário específico. Exemplos de serviços que exigem direitos Content.DelegatedReader são aplicativos de negócios que precisam descriptografar o conteúdo com base nas políticas de rotulagem de um usuário e exibir o conteúdo nativamente. Essa permissão permite que o aplicativo descriptografe e leia conteúdo no contexto do usuário.

Redator de Conteúdo

Use essa permissão quando um aplicativo precisar listar modelos e criptografar conteúdo. Um serviço que tenta listar modelos sem essa permissão recebe do serviço uma mensagem informando que o token foi rejeitado. Exemplos de serviços que exigem Content.Writer são aplicativos de linha de negócios que aplicam rótulos de classificação a arquivos na exportação. Content.Writer criptografa o conteúdo como a identidade da entidade de serviço, portanto, o proprietário dos arquivos protegidos é a identidade da entidade de serviço.

UnifiedPolicy.Tenant.Read

Use essa permissão quando um aplicativo precisar baixar políticas de rotulagem unificadas para o locatário. Exemplos de serviços que exigem UnifiedPolicy.Tenant.Read são aplicativos que precisam trabalhar com rótulos como uma identidade de entidade de serviço.

Permissões delegadas

As permissões delegadas permitem que um aplicativo na ID do Microsoft Entra execute ações em nome de um usuário específico.

Serviço Nome da permissão Descrição É necessário o consentimento do administrador
Serviço de Gerenciamento de Direitos do Azure user_impersonation Criar e acessar conteúdo protegido para o usuário Não
Serviço de Sincronização de MIP UnifiedPolicy.User.Read Ler todas as políticas unificadas às quais um usuário tem acesso Não

user_impersonation

Use essa permissão quando um aplicativo precisar usar Azure Rights Management Services em nome do usuário. Exemplos de serviços que exigem user_impersonation direitos são aplicativos que precisam criptografar ou acessar conteúdo com base nas políticas de rótulo de um usuário para aplicar rótulos ou criptografar conteúdo nativamente.

UnifiedPolicy.User.Read

Use essa permissão quando um aplicativo precisar ler políticas de rotulagem unificadas relacionadas a um usuário. Exemplos de serviços que exigem UnifiedPolicy.User.Read permissões são aplicativos que precisam criptografar e descriptografar conteúdo com base nas políticas de rótulo de um usuário.