Este artigo responde a perguntas comuns sobre o SDK Microsoft Information Protection (MIP). Para problemas conhecidos e mensagens de erro, veja MIP SDK troubleshooting.
Geral
Quantas etiquetas são suportadas pelo MIP SDK?
O SDK MIP suporta até 500 etiquetas de sensibilidade encriptadas. Rótulos que não usam encriptação não estão sujeitos a este limite. Inquilinos com um grande número de etiquetas de sensibilidade podem experienciar algum impacto no desempenho. Para mais informações, consulte Limitações de etiquetas de sensibilidade.
O MIP SDK suporta a reetiquetação de tipos .pfile com etiquetas de classificação?
Não, isso ocorre por design porque os pfiles são tipos de arquivos protegidos. Desencripte com o Proteção de Informações do Microsoft Purview File Labeler antes da classificação.
Porque é que os ficheiros protegidos descarregados do Microsoft Teams falham em desencriptar?
Este é um problema conhecido em versões não suportadas do MIP SDK. Atualize para a versão mais recente do MIP SDK.
Como posso verificar que etiquetas são aplicadas quando múltiplas etiquetas de diferentes inquilinos são aplicadas a um ficheiro?
Consulte o método GetLabel no contexto do utilizador para cada inquilino.
Alterações no armazenamento de metadados
Outros formatos são afetados, como o PDF?
A Microsoft anunciou uma alteração na localização de armazenamento de metadados de etiquetas para ficheiros Office (Word, Excel e PowerPoint) para suportar novas funcionalidades no Office 365, SharePoint Online e outros serviços. Nenhum outro formato de ficheiro é afetado, apenas ficheiros do Office, especificamente ficheiros Word, Excel e PowerPoint.
Existe alguma versão específica do MIP SDK que seja necessária?
MIP SDK 1.7 e posterior são totalmente compatíveis.
Existe alguma versão específica do cliente Office que seja obrigatória para usar este local de armazenamento?
Todos os clientes do Microsoft 365 Apps lançados após setembro de 2021 suportam esse novo local de metadados. A nova localização de armazenamento não é usada até que o administrador do tenant ative a funcionalidade de coautoria protegida.
Os metadados existentes armazenados como uma propriedade personalizada em *custom.xml* são mantidos atualizados?
Não. Na primeira vez que guardar o documento após ativar a nova localização de armazenamento, os metadados da etiqueta movem-se para a nova localização. Metadados escritos usando LabelingOptions.ExtendedProperties permanecem em custom.xml.
É possível ler os metadados da etiqueta sem o MIP SDK?
Sim, mas tens de implementar o teu próprio código para analisar o ficheiro e extrair a informação.
Atualmente, é fácil "ler" o rótulo extraindo as cadeias do par chave/valor do ficheiro. Os metadados ainda podem ser lidos desta forma?
Sim, os metadados ainda estão disponíveis no arquivo XML do Office para serem lidos. Seu aplicativo deve ler a configuração de coautoria do arquivo de política para saber se o novo conjunto de recursos está habilitado. Esta definição define onde ler/escrever os dados do rótulo (custom.xml vs. labelinfo.xml). Consulte MS-OFFCRYPTO: LabelInfo versus Propriedades de Documento Personalizadas para detalhes de implementação.
Como posso determinar se a coautoria está ativada na política de etiquetas?
O motor de políticas devolve o estado da definição de coautoria a partir do valor da enableLabelCoauth chave. Um aplicativo pode ler os bytes brutos do mecanismo de política para determinar o status de coautoria.
Como é feita a migração das etiquetas para a nova localização?
O SDK MIP utiliza a seguinte lógica para determinar qual a secção que lê e utiliza para ler ou escrever dados de etiquetas.
| Action | Funcionalidade não ativada | Funcionalidade ativada |
|---|---|---|
| Ler | Etiqueta em custom.xml (não protegido) ou Doc SummaryInfo (protegido). | Se existe um rótulo em labelinfo.xml, é o rótulo efetivo. Se não houver etiqueta no labelinfo.xml, a etiqueta no custom.xml ou no Doc SummaryInfo é a etiqueta efetiva. |
| Write | O SDK MIP escreve todas as novas etiquetas em custom.xml (não protegido) ou Doc SummaryInfo (protegido). | O SDK MIP escreve todas as novas etiquetas em labelinfo.xml. |
Análise de ficheiros
Posso escrever no mesmo ficheiro que estou a ler atualmente com o SDK do ficheiro?
O MIP SDK não suporta a leitura e gravação simultâneas do mesmo arquivo. Todos os arquivos rotulados resultam em uma cópia do arquivo de entrada com as ações de rótulo aplicadas. A sua aplicação deve substituir o original pelo ficheiro rotulado.
Manipulação de cadeia de caracteres SDK
Como é que o SDK gere as strings e que tipo de string devo usar no meu código?
O SDK destina-se a ser usado entre plataformas e usa UTF-8 (Unicode Transformation Format - 8-bit) para manipulação de cadeia de caracteres. As orientações específicas dependem da plataforma que está a utilizar:
| Platform | Documentação de orientação |
|---|---|
| Nativo para Windows | Para clientes do SDK de C++, utilize o tipo std::string da Biblioteca Padrão de C++ para passar cadeias de caracteres de/para funções da API. O MIP SDK gerencia internamente a conversão de/para UTF-8. Quando uma API devolve um std::string, deve assumir a codificação UTF-8 e agir em conformidade se estiver a converter a cadeia de caracteres. Em alguns casos, uma API devolve uma string como parte de um uint8_t vetor (como uma licença de publicação (PL)), mas deve tratá-la como um blob opaco.Para mais informações e exemplos, consulte:
|
| .NET | Para clientes .NET SDK, todas as cadeias de caracteres usam a codificação UTF-16 padrão e nenhuma conversão especial é necessária. O MIP SDK gerencia internamente a conversão de/para UTF-16. |
| Outras plataformas | Todas as outras plataformas suportadas pelo MIP SDK têm suporte nativo para UTF-8. |
Marcação de conteúdo
O MIP SDK suporta marcação de conteúdo?
O MIP SDK não suporta a aplicação direta de marcação de conteúdo, incluindo cabeçalho, rodapé ou marca d'água, em nenhum arquivo. Quando o File SDK escreve metadados de etiquetas num ficheiro, escreve a propriedade de metadados contentBits para indicar que o File SDK aplicou proteção (se configurado). Não escreve as propriedades que indicam que a aplicação aplicou um cabeçalho, rodapé ou marca de água. Quando uma aplicação abre o ficheiro, deve avaliar a configuração de marcação de conteúdo e gravá-la no ficheiro ao guardar.
SDK de proteção e política no Android
Que biblioteca partilhada devo usar para integrar o SDK MIP na minha aplicação Android?
Os binários do SDK MIP do Android incluem libmip_core.so, libmip_protection_sdk.so, libmip_upe_sdk.so, e libmip_unified.so.
libmip_unified.so é a biblioteca recomendada e inclui as bibliotecas Núcleo, Proteção e Política Partilhadas.
Compliance
O Padrão Federal de Processamento de Informação (FIPS) 140-2 do SDK Microsoft Information Protection está em conformidade?
Consulte Validação FIPS 140-2.
Regulação de Velocidade
Existem limites de limitação baseados em serviços ao usar o MIP SDK?
O Serviço de Gestão de Direitos, utilizado pelo Protection SDK ou por operações de proteção no File SDK, tem um limite de 7.500 pedidos por 10 segundos para toda a organização. Se a Aplicação A gerar 4.000 pedidos por 10 segundos e a Aplicação B na mesma organização gerar 4.000 pedidos a cada 10 segundos, ambas as aplicações podem começar a receber HTTP 429 Too Many Requests respostas. Os programadores devem implementar um período de recuo quando recebem estas exceções. Versões futuras do MIP SDK implementam este período de retrocesso internamente.