You need to enable JavaScript to run this app. 开发Microsoft Teams Tab应用时剪贴板写入失效,如何配置iframe参数?
优惠活动
大模型
产品
解决方案
定价
更多

开发Microsoft Teams Tab应用时剪贴板写入失效,如何配置iframe参数?

Teams Tab 剪贴板写入权限配置说明

核心逻辑

你的 Tab 应用页面是由 Microsoft Teams 作为宿主,通过 iframe 嵌入到 Teams 客户端/Web 端的,这个 iframe 的权限策略(allow 属性)由 Teams 统一管控,你无法直接修改。可通过以下两种官方方式申请所需权限:


方式1:通过 Teams JS SDK 运行时请求(兼容全版本客户端)

  • 这是目前兼容性最好的方式,适用于所有支持 Teams JS SDK v2.0+ 的客户端版本
  • 首先完成 SDK 初始化:
    import * as microsoftTeams from "@microsoft/teams-js";
    await microsoftTeams.app.initialize();
    
  • 初始化完成后,调用权限请求 API 申请剪贴板写入权限:
    import { permissions } from "@microsoft/teams-js";
    await permissions.request({
      permissions: [{ name: "clipboard-write" }]
    });
    
  • 用户在弹出的 Teams 客户端确认框中同意权限后,Teams 会即时给当前 Tab 对应的 iframe 追加 clipboard-write 权限策略,之后即可正常调用 navigator.clipboard.writeText() 等剪贴板写入 API

方式2:Manifest 静态声明(适用于最新版客户端,无需运行时弹窗)

  • 从 Teams 应用 Manifest 版本 1.13 开始,支持开发者在 Manifest 中静态声明 Tab 所需的 iframe 权限策略,配置后 Teams 加载 Tab 时会自动给 iframe 追加对应权限,无需用户手动确认
  • 手动编辑 Manifest 时,定位到 staticTabs 或 configurableTabs 节点下对应 Tab 的配置项,新增 permissionsPolicy 字段:
    "permissionsPolicy": ["clipboard-write"]
    
  • 如果你使用 App Studio 生成 Manifest,可直接在 Tab 的高级配置页勾选「剪贴板写入」选项,工具会自动写入该配置

补充注意事项

  • 你在 Manifest 中通过 validDomains 声明的域名,才会被允许申请该权限,未声明的域名无法生效
  • 调用剪贴板写入 API 时,需要由用户的主动交互(如点击按钮)触发,否则即使权限放行,浏览器仍可能拦截调用
  • Teams Web 端、桌面端、移动端均支持上述两种配置方式,配置生效后无需用户手动调整客户端默认权限

内容的提问来源于stack exchange,提问作者Dmytro Yaroshenko

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 20:24:03