OfficeJS插件本地EWS共享邮箱：如何获取全权限令牌或替代方案？

一、替代EWS：直接使用Office.js原生API获取邮件及附件 #

如果你的插件运行在邮件阅读场景下，完全可以跳过EWS，直接通过Office.js原生API获取当前邮件的内容和附件，无需依赖EWS令牌。这是插件访问当前邮件数据的标准方式，不需要额外权限申请。

获取邮件核心内容示例 #

// 获取邮件主题
Office.context.mailbox.item.subject.getAsync(function(result) {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    const subject = result.value;
    // 后续处理逻辑
  }
});

// 获取HTML格式的邮件正文
Office.context.mailbox.item.body.getAsync(Office.CoercionType.Html, function(result) {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    const bodyHtml = result.value;
    // 后续处理逻辑
  }
});

获取附件示例 #

// 获取当前邮件所有附件
Office.context.mailbox.item.getAttachmentsAsync(function(result) {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    const attachments = result.value;
    attachments.forEach(attachment => {
      // 区分内嵌附件和普通文件附件
      if (!attachment.isInline) {
        // 获取Base64格式的附件内容
        Office.context.mailbox.item.getAttachmentContentAsync(attachment.id, function(contentResult) {
          if (contentResult.status === Office.AsyncResultStatus.Succeeded) {
            const attachmentContent = contentResult.value;
            // 将附件内容保存至你的系统
          }
        });
      }
    });
  }
});

二、客户端获取全权限令牌的可行方案 #

Office.js返回的EWS令牌受限于插件权限范围（默认仅能访问当前用户的当前邮件），无法直接获取全权限令牌。你可以通过以下两种方式解决共享邮箱访问问题：

1. OAuth 2.0授权流程获取共享邮箱权限 #

在Azure AD中注册插件应用，申请Mail.Read.Shared或Mail.ReadWrite.Shared权限（按需选择）。在插件中引导用户完成OAuth授权，获取包含共享邮箱访问权限的令牌，之后用该令牌调用EWS或Microsoft Graph API访问共享邮箱数据。

注意：该方式需要用户手动授权，且Exchange 2019本地环境需提前开启OAuth支持。

2. 后端代理模式（推荐） #

客户端插件仅收集需要访问的共享邮箱及邮件信息，传递给你的后端服务。后端服务使用服务账号或用户授权的高权限令牌（通过OAuth获取）调用EWS或Graph API访问共享邮箱数据，再将结果返回给插件。

这种方式的优势：

• 避免客户端处理高权限令牌，提升安全性
• 后端统一处理权限验证和数据逻辑
• 适配本地Exchange与Exchange Online场景的一致性

内容的提问来源于stack exchange，提问作者rasmeta