Compartilhar via

Noções básicas sobre permissões de suplemento do Outlook

  • Artigo

Os suplementos do Outlook especificam o nível de permissão necessário nos seus manifestos. Existem quatro níveis disponíveis.

Nome canónico de nível
de permissão		 nome de manifesto apenas do suplemento manifesto unificado para o nome do Microsoft 365 Descrição do resumo
restrito Restricted MailboxItem.Restricted.User Permite o acesso a propriedades e métodos que não dizem respeito a informações específicas sobre o utilizador ou o item de correio.
ler item ReadItem MailboxItem.Read.User Além do que é permitido em restrições, permite:
  • expressões regulares
  • acesso de leitura para a API do suplemento do Outlook
  • obter as propriedades do item e o token de retorno de chamada
  • escrever propriedades personalizadas
ler/escrever item ReadWriteItem MailboxItem.ReadWrite.User Além do que é permitido no item de leitura, permite:
  • acesso completo à API do Suplemento do Outlook, exceto makeEwsRequestAsync
  • definição das propriedades do item
caixa de correio de leitura/escrita ReadWriteMailbox Caixa de Correio.ReadWrite.User Além do que é permitido no item de leitura/escrita, permite:

As permissões são declaradas no manifesto. A marcação varia consoante o tipo de manifesto.

  • Manifesto apenas de suplemento: utilize o <elemento Permissões> .
  • Manifesto unificado para o Microsoft 365: utilize a propriedade "name" de um objeto na matriz "authorization.permissions.resourceSpecific".

Observação

Os quatro níveis de permissão são cumulativos: a permissão leitura/gravação de caixa de correio inclui as permissões leitura/gravação de item, leitura de item e restrita, leitura/gravação de item inclui leitura de item e restrita e a permissão leitura de item inclui restrita.

Pode ver as permissões pedidas por um suplemento de correio antes de o instalar a partir do AppSource. Também pode ver as permissões necessárias de suplementos instalados no Centro de Administração do Exchange.

Dica

Para se certificar de que o seu suplemento do Outlook especifica o nível de permissão correto, verifique o nível de permissão mínimo exigido por cada API implementada pelo seu suplemento. Para obter informações sobre os níveis mínimos de permissão, veja Referência da API do Outlook.

permissão restrita

A permissão restrita é o nível de permissão mais básico. O Outlook atribui esta permissão a um suplemento de correio por predefinição se o suplemento não pedir uma permissão específica no respetivo manifesto.

Pode ser feito

Acessar quaisquer propriedades e métodos que não pertencem às informações específicas sobre o usuário ou o item (confira a próxima seção para ver a lista de membros que fazem isso).

Não pode ser feito

permissão ler item

A permissão ler item é o próximo nível de permissão no modelo de permissões.

Pode ser feito

  • Leia todas as propriedades do item atual num formulário de leitura ou composição. Por exemplo, item.to num formulário de leitura e item.to.getAsync num formulário de composição.

  • Em ambientes do Exchange no local, obtenha um token de chamada de retorno para obter o item de correio completo com os Serviços Web do Exchange (EWS).

    Importante

    Os tokens legados do Exchange foram preteridos. A partir de fevereiro de 2025, vamos começar a desativar a identidade de utilizador e os tokens de chamada de retorno legados do Exchange para Exchange Online inquilinos. Para obter os detalhes e linha do tempo, consulte a nossa página de FAQ. Isto faz parte da Iniciativa Secure Future da Microsoft, que fornece às organizações as ferramentas necessárias para responder ao cenário de ameaças atual. Os tokens de identidade de utilizador do Exchange continuarão a funcionar para o Exchange no local. A autenticação de aplicações aninhadas é a abordagem recomendada para tokens em curso.

  • Gravar propriedades personalizadas definidas pelo suplemento nesse item.

  • Utilize expressões regulares num suplemento contextual.

Não pode ser feito

permissão de item de leitura/escrita

Especifique a permissão de item de leitura/escrita no manifesto para pedir esta permissão. Os suplementos de email ativados nos formulários de redação que usam métodos de gravação (Message.to.addAsync ou Message.to.setAsync) devem usar pelo menos esse nível de permissão.

Pode ser feito

  • Ler e gravar todas as propriedades no nível do item que está sendo visualizado ou redigido no Outlook.

  • Adicionar ou remover anexos desse item.

  • Utilize todos os outros membros da API JavaScript do Office aplicáveis aos suplementos de correio, exceto Mailbox.makeEWSRequestAsync.

Não pode ser feito

  • Usar o token fornecido por mailbox.getCallbackTokenAsync para:

    • Atualizar ou excluir o item atual usando a API REST do Outlook ou acessar outros itens na caixa de correio do usuário.
    • Obter o item de evento de calendário atual usando a API REST do Outlook.

  • Usar mailbox.makeEWSRequestAsync.

permissão de caixa de correio de leitura/escrita

A permissão de caixa de correio de leitura/escrita é o nível mais elevado de permissão.

Em ambientes do Exchange no local, o token fornecido por mailbox.getCallbackTokenAsync fornece acesso para utilizar operações do Exchange Web Services (EWS) ou APIs REST do Outlook para fazer o seguinte:

  • Ler e gravar todas as propriedades de qualquer item na caixa de correio do usuário.
  • Criar, ler e gravar em qualquer pasta ou item nessa caixa de correio.
  • Enviar um item dessa caixa de correio.

Através de mailbox.makeEwsRequestAsync, pode aceder às seguintes operações do EWS.

A tentativa de usar uma operação sem suporte resulta em uma resposta de erro.

Importante

Os tokens legados do Exchange foram preteridos. A partir de fevereiro de 2025, vamos começar a desativar a identidade de utilizador e os tokens de chamada de retorno legados do Exchange para Exchange Online inquilinos. Para obter os detalhes e linha do tempo, consulte a nossa página de FAQ. Isto faz parte da Iniciativa Secure Future da Microsoft, que fornece às organizações as ferramentas necessárias para responder ao cenário de ameaças atual. Os tokens de identidade de utilizador do Exchange continuarão a funcionar para o Exchange no local. A autenticação de aplicações aninhadas é a abordagem recomendada para tokens em curso.

Confira também