Azure Active Directory Library for .NET 使用教程

1. 项目的目录结构及介绍

Azure Active Directory Library for .NET 项目的目录结构如下：

azure-activedirectory-library-for-dotnet/
├── automation/
│   └── WinFormsAutomationApp/
├── build/
├── devApps/
├── src/
├── tests/
├── .gitignore
├── LICENSE
├── LibsAndSamples.sln
├── LibsAndUITests.sln
├── LibsNoSamples.sln
├── LibsNoSamples.sln.DotSettings
├── README.md
├── RELEASES.md
├── build.cmd
├── buildAll.cmd
├── buildNoVS.cmd
└── buildVS2017.cmd

目录介绍

• automation/: 包含自动化测试相关的项目。
• build/: 包含构建脚本和配置文件。
• devApps/: 包含开发人员应用程序。
• src/: 包含项目的主要源代码。
• tests/: 包含项目的测试代码。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• LibsAndSamples.sln: 包含库和示例的解决方案文件。
• LibsAndUITests.sln: 包含库和 UI 测试的解决方案文件。
• LibsNoSamples.sln: 不包含示例的解决方案文件。
• LibsNoSamples.sln.DotSettings: 解决方案的设置文件。
• README.md: 项目说明文档。
• RELEASES.md: 发布说明文档。
• build.cmd: 构建项目的命令行脚本。
• buildAll.cmd: 构建所有内容的命令行脚本。
• buildNoVS.cmd: 不使用 Visual Studio 构建项目的命令行脚本。
• buildVS2017.cmd: 使用 Visual Studio 2017 构建项目的命令行脚本。

2. 项目的启动文件介绍

项目的启动文件通常位于 src/ 目录下，具体文件名和路径可能因项目结构而异。例如，如果项目是一个控制台应用程序，启动文件可能是 Program.cs。

示例启动文件

假设 src/ 目录下有一个控制台应用程序项目，其启动文件 Program.cs 可能如下所示：

using System;
using Microsoft.IdentityModel.Clients.ActiveDirectory;

namespace AzureADExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 初始化认证客户端
            var authContext = new AuthenticationContext("https://login.microsoftonline.com/common");
            var result = authContext.AcquireTokenAsync("https://graph.microsoft.com", "client_id", new Uri("redirect_uri"), new PlatformParameters(PromptBehavior.Auto)).Result;

            // 输出访问令牌
            Console.WriteLine($"Access Token: {result.AccessToken}");
        }
    }
}

3. 项目的配置文件介绍

项目的配置文件通常包括 appsettings.json 或 app.config，用于存储应用程序的配置信息，如连接字符串、认证信息等。

示例配置文件

假设项目使用 appsettings.json 作为配置文件，其内容可能如下所示：

{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "Domain": "yourdomain.onmicrosoft.com",
    "TenantId": "your-tenant-id",
    "ClientId": "your-client-id",
    "CallbackPath": "/signin-oidc"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*"
}

配置文件介绍

• AzureAd: 包含 Azure Active Directory 的配置信息，如实例地址、域名、租户 ID、客户端 ID 和回调路径。
• Logging: 包含日志记录的配置信息，如日志级别。
• AllowedHosts: 允许的主机列表。

以上是 Azure Active Directory Library for .NET 项目的目录结构