SuperAPI AI 工具集

m365-clients

编程与开发

查看项目

更新于 10-30 01:16

技能介绍

用途

该技能面向需要编写 TypeScript 代码访问 Microsoft 365 平台资源的场景,核心是两套 API:Dataverse Web API(/api/data/v9.2/)与 Microsoft Graph(graph.microsoft.com)。它提供认证、带类型客户端和组合预配三方面的模式与参考。

主要能力

  • 共享令牌提供器:用同一个凭证实例同时服务 Dataverse 与 Graph。DefaultAzureCredential 依次尝试环境变量、Workload Identity(Kubernetes)、托管标识(Azure VM、Functions、AKS)、Azure CLI、Azure PowerShell。
  • Dataverse 客户端:环境 URL 初始化、连接测试(whoAmI)、增删改查(create/get/patch/delete)与 OData 过滤查询。
  • Graph 服务:用户查询、创建 Teams 频道、创建 SharePoint 文件夹、列出群组成员等。
  • 联合预配工作流:先在 Dataverse 创建状态为 provisioning 的项目记录,并行通过 Graph 创建 Teams 频道与 SharePoint 文件夹,再把资源 ID 回写 Dataverse 并将状态改为 active。
  • 环境认证策略:本地开发用环境变量(AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET),Azure Functions 用系统分配托管标识,AKS 用 Workload Identity,非 Azure K8s 与 CI/CD 用客户端密钥。DefaultAzureCredential 使代码跨环境无需改动。

使用方式

安装依赖:

npm install @azure/identity @microsoft/microsoft-graph-client
npm install @microsoft/microsoft-graph-client/authProviders/azureTokenCredentials

典型代码:

import { DefaultAzureCredential, TokenCredential } from "@azure/identity";

export function getCredential(): TokenCredential {
  return new DefaultAzureCredential();
}

const client = new DataverseClient(
  { environmentUrl: "https://contoso.crm.dynamics.com" },
  getCredential()
);
const whoAmI = await client.whoAmI();
const id = await client.create("accounts", { name: "Contoso" });

const graph = new GraphService(getCredential());
const channel = await graph.createTeamsChannel(teamId, "Project Alpha");

Entra 配置清单:注册应用;为 Dynamics CRM 配置 user_impersonation(委托)或应用权限,为 Graph 配置所需应用权限(如 User.Read.All、Files.ReadWrite.All、Channel.Create);授予管理员同意;在 Dataverse 环境创建绑定该 Client ID 的应用用户并分配安全角色;生产环境可改用托管标识并赋予相同权限。

技能附带参考文件:references/azure-auth.md(认证与 Entra 配置)、references/dataverse-client.md(完整带类型客户端、OData、批处理、分页)、references/graph-client.md(Graph 服务类)、references/environment-strategies.md(环境与密钥管理)、references/graph-client-patterns.md(中间件、JSON Batch、PageIterator),以及 examples 下的认证、Dataverse、Graph 与组合流程示例。

适用场景

Node/TypeScript 后端服务、Azure Functions、AKS 工作负载中需要同时读写 Dataverse 数据并操作 Microsoft 365 资源(Teams、SharePoint、用户、群组、邮件、日历)的集成与自动化预配。

限制

该资料未提供收费、价格、平台支持范围之外的信息;除上述已列 API 与能力外的功能暂未提供。