如何在microsoftTeams.authentication.authenticate()方法中传递所需scopes

具体传递实现方式 #

microsoftTeams.authentication.authenticate() 方法本身没有直接传入scopes的独立参数，你需要在构造该方法入参的url字段时，手动把scopes编码后拼接到auth-start.html的查询字符串中，Teams Toolkit生成的默认auth-start.html脚本会自动从页面URL的查询参数里读取scopes字段，操作步骤如下：

• 第一步：调用认证方法前拼接带scopes的访问地址
  示例代码：

// 定义你需要申请的权限范围
const requiredScopes = ["User.Read", "Mail.Read"];
// 拼接auth-start.html完整路径，将scopes编码后作为查询参数传入
const authStartUrl = `${window.location.origin}/auth-start.html?scopes=${encodeURIComponent(requiredScopes.join(" "))}`;

// 调用Teams官方认证方法
microsoftTeams.authentication.authenticate({
  url: authStartUrl,
  width: 600,
  height: 535
}).then(authResult => {
  // 认证成功后的业务逻辑
}).catch(error => {
  // 认证失败后的异常处理逻辑
});

• 第二步：无需修改默认auth-start.html逻辑
  Teams Toolkit生成的默认auth-start.html已经内置了从URL查询参数提取scopes的逻辑，只要按照上述方式传入参数即可直接识别使用。

注意事项 #

• 多个scopes之间用空格分隔，传递前必须调用encodeURIComponent编码，避免特殊字符导致URL解析异常
• 如果你自定义修改过auth-start.html的脚本，可参考以下逻辑确保scopes正常提取：

const queryParams = new URLSearchParams(window.location.search);
const scopes = queryParams.get('scopes')?.split(' ') || [];

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