快速入门：为 Microsoft Entra ID 用户设置和获取访问令牌

设置先决条件

• 适用于操作系统的最新版本 .NET SDK。
• 用于 .NET 的 Azure 标识 SDK ，以便使用 Microsoft Entra ID 进行身份验证。
• 用于 .NET 的 Azure 通信服务通用 SDK ，用于获取 Microsoft Entra ID 用户的 Azure 通信服务访问令牌。

最终代码

在 GitHub 上查找此快速入门的最终代码。

设置

新建 C# 应用程序

在控制台窗口（例如 cmd、PowerShell 或 Bash）中，使用 dotnet new 命令创建名为 EntraIdUsersSupportQuickstart 的新控制台应用。 此命令使用单个源文件创建一个简单的“Hello World”C# 项目： Program.cs。

dotnet new console -o EntraIdUsersSupportQuickstart

将目录更改为新创建的应用文件夹，并使用 dotnet build 命令编译应用程序。

cd EntraIdUsersSupportQuickstart
dotnet build

安装软件包

在应用程序目录中，使用 dotnet add package 命令安装用于 .NET 包的 Azure 标识和 Azure 通信服务通用库。 Azure 通信服务通用 SDK 版本应为 1.4.0 或更高版本。

dotnet add package Azure.Identity
dotnet add package Azure.Communication.Common

实现凭据流

从项目目录中执行以下操作：

1. 在文本编辑器中打开 Program.cs 文件
2. 将 Program.cs 的内容替换为以下代码：

using Azure.Communication;
using Azure.Identity;

namespace EntraIdUsersSupportQuickstart
{
    class Program
    {
        static async Task Main(string[] args)
        {
            Console.WriteLine("Azure Communication Services - Obtain Access Token for Entra ID User Quickstart");

            // Quickstart code goes here
        }
    }
}

步骤 1：从 Azure 标识 SDK 初始化 TokenCredential 的实现

为 Entra ID 用户获取通信服务访问令牌的第一步是使用 Azure 标识 SDK 为 Entra ID 使用者获取 Entra ID 访问令牌。 下面的代码从名为 ENTRA_CLIENT_ID 和 ENTRA_TENANT_ID 的环境变量中检索 Contoso Entra 客户端 ID 和 Fabrikam 租户 ID。 若要为跨多个租户的用户启用身份验证，请初始化 InteractiveBrowserCredential 类别并将授权设置为 https://login.microsoftonline.com/organizations。 有关详细信息，请参阅颁发机构。

// This code demonstrates how to fetch your Microsoft Entra client ID and tenant ID from environment variables.
string clientId = Environment.GetEnvironmentVariable("ENTRA_CLIENT_ID");
string tenantId = Environment.GetEnvironmentVariable("ENTRA_TENANT_ID");

//Initialize InteractiveBrowserCredential for use with CommunicationTokenCredential.
var options = new InteractiveBrowserCredentialOptions
{
    TenantId = tenantId,
    ClientId = clientId,
};
var entraTokenCredential = new InteractiveBrowserCredential(options);

步骤 2：初始化 CommunicationTokenCredential

用上面创建的 TokenCredential 以及通信服务资源终结点 URI，将 CommunicationTokenCredential 实例化。 以下代码从名为COMMUNICATION_SERVICES_RESOURCE_ENDPOINT的环境变量中检索资源的端点。

将以下代码添加到 Main 方法中：

// This code demonstrates how to fetch your Azure Communication Services resource endpoint URI
// from an environment variable.
string resourceEndpoint = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_RESOURCE_ENDPOINT");

// Set up CommunicationTokenCredential to request a Communication Services access token for a Microsoft Entra ID user.
var entraTokenCredentialOptions = new EntraCommunicationTokenCredentialOptions(
    resourceEndpoint: resourceEndpoint,
    entraTokenCredential: entraTokenCredential)
{
    Scopes = new[] { "https://communication.azure.com/clients/VoIP" }
};

var credential = new CommunicationTokenCredential(entraTokenCredentialOptions);

指定范围是一个选项。 如果未指定，https://communication.azure.com/clients/.default 范围会被自动使用，请求已注册在客户端应用程序上的通信服务客户端的所有 API 权限。

步骤 3：获取 Microsoft Entra ID 用户的 Azure 通信服务访问令牌

使用 GetTokenAsync 方法获取 Entra ID 用户的访问令牌。 CommunicationTokenCredential 可与 Azure 通信服务 SDK 一起使用。

// To obtain a Communication Services access token for Microsoft Entra ID call GetTokenAsync() method.
var accessToken = await credential.GetTokenAsync();
Console.WriteLine($"Token: {accessToken.Token}");

运行代码

从应用程序目录使用 dotnet run 命令运行应用程序。

dotnet run

设置先决条件

• Node.js
• 用于 JavaScript 的 Azure 标识 SDK ，使用 Microsoft Entra ID 进行身份验证。
• 用于 JavaScript 的 Azure 通信服务通用 SDK ，以获取 Microsoft Entra ID 用户的 Azure 通信服务访问令牌。

最终代码

在 GitHub 上查找此快速入门的最终代码。

设置

创建新的 Node.js 应用程序

打开终端或命令窗口，为应用创建一个新目录，并导航到该目录。

mkdir entra-id-users-support-quickstart && cd entra-id-users-support-quickstart

运行 npm init -y 以使用默认设置创建 package.json 文件。

npm init -y

安装软件包

npm install使用命令安装适用于 JavaScript 的 Azure 标识和 Azure 通信服务通用 SDK。 Azure 通信服务通用 SDK 版本应为 2.4.0 或更高版本。

npm install @azure/communication-common --save
npm install @azure/identity --save
npm install react react-dom --save
npm install vite --save

--save 选项将该库作为 package.json 文件中的依赖项列出。

将这些脚本添加到 package.json：

"scripts": {
  "dev": "vite",
  "build": "vite build",
  "preview": "vite preview"
}

实现凭据流

在本快速入门中，你将创建一个简单的 React 应用程序，该应用程序使用 Azure Common SDK 获取Microsoft Entra ID 用户的访问令牌。

从项目目录中执行以下操作：

1. 创建包含以下内容的 index.html 文件：

   <!DOCTYPE html>
       <html lang="en">
       <head>
           <meta charset="UTF-8" />
           <title>Entra ID Support Client</title>
       </head>
       <body>
           <div id="root"></div>
           <script type="module" src="/src/main.jsx"></script>
       </body>
   </html>
   

2. 创建目录 src 并在其中创建 main.jsx 包含以下内容的文件：

   import React from "react";
   import ReactDOM from "react-dom/client";
   import App from "./App";
   
   ReactDOM.createRoot(document.getElementById("root")).render(<App />);
   

3. 创建一个src/App.jsx文件，包含以下内容，并分别从 Azure Communication Common 和 Azure Identity SDK 导入AzureCommunicationTokenCredential和InteractiveBrowserCredential类。 另外，请确保使用 Microsoft Entra 客户端 ID、租户 ID 和 Azure 通信服务资源终结点 URI 更新变量 clientId、tenantId和 resourceEndpoint：

   import React, { useState } from "react";
   import { AzureCommunicationTokenCredential } from "@azure/communication-common";    
   import { InteractiveBrowserCredential } from "@azure/identity";
   
   function App() {
       // Set your Microsoft Entra client ID and tenant ID, Azure Communication Services resource endpoint URI.
       const clientId = 'YOUR_ENTRA_CLIENT_ID';
       const tenantId = 'YOUR_ENTRA_TENANT_ID';
       const resourceEndpoint = 'YOUR_COMMUNICATION_SERVICES_RESOURCE_ENDPOINT';
   
       const [accessToken, setAccessToken] = useState("");
       const [error, setError] = useState("");
   
       const handleLogin = async () => {
           try {
               // Quickstart code goes here
               setError("");
           } catch (err) {
               console.error("Error obtaining token:", err);
               setError("Failed to obtain token: " + err.message);
           }
       };
   
       return (
           <div>
               <h2>Obtain Access Token for Entra ID User</h2>
               <button onClick={handleLogin}>Login and Get Access Token</button>
               {accessToken && (
                   <div>
                   <h4>Access Token:</h4>
                   <textarea value={accessToken} readOnly rows={6} cols={60} />
                   </div>
               )}
               {error && <div style={{ color: "red" }}>{error}</div>}
           </div>
       );
   }
   
   export default App;
   

   可以从适用于 JavaScript 的 Azure 标识 SDK 导入 TokenCredential 接口的任何实现，以使用 Microsoft Entra ID 进行身份验证。 在本快速入门中，我们使用 InteractiveBrowserCredential 适用于浏览器基本身份验证方案的类。 有关所提供凭据的完整列表，请参阅凭据类。

步骤 1：从 Azure 标识 SDK 初始化 TokenCredential 的实现

为 Entra ID 用户获取通信服务访问令牌的第一步是使用 Azure 标识 SDK 为 Entra ID 使用者获取 Entra ID 访问令牌。 若要为跨多个租户的用户启用身份验证，请初始化 InteractiveBrowserCredential 类别并将授权设置为 https://login.microsoftonline.com/organizations。 有关详细信息，请参阅颁发机构。

// Initialize InteractiveBrowserCredential for use with AzureCommunicationTokenCredential.
const entraTokenCredential = new InteractiveBrowserCredential({
    tenantId: tenantId,
    clientId: clientId,
    authorityHost: "https://login.microsoftonline.com/organizations",
});

步骤 2：初始化 AzureCommunicationTokenCredential

用上面创建的 TokenCredential 以及通信服务资源终结点 URI，将 AzureCommunicationTokenCredential 实例化。

// Set up AzureCommunicationTokenCredential to request a Communication Services access token for a Microsoft Entra ID user.
const entraCommunicationTokenCredential = new AzureCommunicationTokenCredential({
    resourceEndpoint: resourceEndpoint,
    tokenCredential: entraTokenCredential,
});

指定范围是一个选项。 如果未指定，https://communication.azure.com/clients/.default 范围会被自动使用，请求已注册在客户端应用程序上的通信服务客户端的所有 API 权限。

步骤 3：获取 Microsoft Entra ID 用户的 Azure 通信服务访问令牌

使用 getToken 方法获取 Entra ID 用户的访问令牌。 AzureCommunicationTokenCredential 可与 Azure 通信服务 SDK 一起使用。

// To obtain a Communication Services access token for Microsoft Entra ID call getToken() function.
let accessToken = await entraCommunicationTokenCredential.getToken();
setAccessToken(accessToken.token);

运行代码

在控制台提示符下，导航到目录 entra-id-users-support-quickstart，然后执行以下命令 npm 来运行应用。

npm run dev