使用 ASP.NET Core 與 MongoDB 建立 Web API

由 普拉提克·汗德爾瓦爾 和 斯科特·阿迪

本教學課程會建立 Web API，以在 MongoDB NoSQL 資料庫上執行建立、讀取、更新和刪除 （CRUD） 作業。

在本教學課程中，您會了解如何：

• 設定 MongoDB
• 建立 MongoDB 資料庫
• 定義 MongoDB 集合與結構描述
• 從 Web API 執行 MongoDB CRUD 作業
• 自訂 JSON 序列化

必要條件

• MongoDB 6.0.5 或更新版本
• MongoDB 命令行

Visual Studio

• 具有 ASP.NET 和 Web 開發工作負載的 Visual Studio 2022。

  

Visual Studio Code

• Visual Studio Code
• 適用於 Visual Studio Code 的 C# 開發套件
• .NET 9 SDK（軟體開發工具包）

您可以遵循macOS、Linux或 Windows 上的Visual Studio Code 指示。 如果您使用 Visual Studio Code 以外的整合開發環境（IDE），可能需要變更。

設定 MongoDB

從開發機器上的任何位置啟用 MongoDB 和 Mongo DB 殼層存取 (Windows/Linux/macOS):

1. 下載並安裝 MongoDB Shell:

   • macOS/Linux: 選擇要擷取 MongoDB Shell 的目錄。 將針對 mongosh 產生的路徑新增至 PATH 環境變數。
   • Windows：MongoDB Shell (mongosh.exe) 安裝在 C:\Users\<user>\AppData\Local\Programs\mongosh。 將針對 mongosh.exe 產生的路徑新增至 PATH 環境變數。

2. 下載並安裝 MongoDB:

   • macOS/Linux：確認已安裝 MongoDB 的目錄，通常是在 /usr/local/mongodb 中。 將針對 mongodb 產生的路徑新增至 PATH 環境變數。
   • Windows：MongoDB 預設會安裝在 C：\Program Files\MongoDB 。 將 C：\Program Files\MongoDB\Server\<version_number>\bin 新增至 PATH 環境變數。

3. 選擇資料記憶體目錄: 選取開發電腦上的目錄來儲存資料。 若該目錄不存在，請建立它。 MongoDB 殼層不會建立新目錄:

   • macOS/Linux: 例如 /usr/local/var/mongodb。
   • Windows: 例如 C:\\BooksData。

4. 在 OS 命令殼層 (非 MongoDB 殼層) 中，使用下列命令在預設連接埠 27017 上連線到 MongoDB。 將 <data_directory_path> 取代為上一個步驟中所選擇的目錄。

   mongod --dbpath <data_directory_path>
   

在下列步驟中使用先前安裝的 MongoDB 殼層來建立資料庫、建立集合及儲存文件。 如需 MongoDB 殼層命令的詳細資訊，請參閱 mongosh。

1. 啟動 mongosh.exe，或在命令殼層中執行下列命令，以開啟 MongoDB 命令殼層實例：

   mongosh
   

2. 在命令殼層中，執行下列命令介面以連線到預設測試資料庫：

   use BookStore
   

   如果 BookStore 不存在，就會建立名為 BookStore 的資料庫。 若該資料庫存在，會開啟其連線進行交易。

3. 使用下列命令建立 Books 集合：

   db.createCollection('Books')
   

   顯示的結果如下：

   { "ok" : 1 }
   

4. 使用下列命令為 Books 集合定義結構描述並插入兩份文件：

   db.Books.insertMany([{ "Name": "Design Patterns", "Price": 54.93, "Category": "Computers", "Author": "Ralph Johnson" }, { "Name": "Clean Code", "Price": 43.15, "Category": "Computers","Author": "Robert C. Martin" }])
   

   會顯示類似下列的結果：

   {
       "acknowledged" : true,
       "insertedIds" : [
           ObjectId("61a6058e6c43f32854e51f51"),
           ObjectId("61a6058e6c43f32854e51f52")
        ]
    }
   

   注意

   上述結果中顯示的 ObjectId，不符合命令列介面中顯示的結果。

5. 使用下列命令檢視資料庫中的文件：

   db.Books.find().pretty()
   

   會顯示類似下列的結果：

   {
        "_id" : ObjectId("61a6058e6c43f32854e51f51"),
        "Name" : "Design Patterns",
        "Price" : 54.93,
        "Category" : "Computers",
        "Author" : "Ralph Johnson"
    }
    {
        "_id" : ObjectId("61a6058e6c43f32854e51f52"),
        "Name" : "Clean Code",
        "Price" : 43.15,
        "Category" : "Computers",
        "Author" : "Robert C. Martin"
    }
   

   結構描述會為每份文件新增自動生成的 _id 屬性 (類型 ObjectId)。

建立 ASP.NET Core Web API 專案

Visual Studio

1. 移至 [ 檔案>新>專案]。
2. 選取 [ASP.NET Core Web API] 專案型別，然後選取 [下一步]。
3. 將專案命名為 BookStoreApi，然後選取 [ 下一步]。
4. 在 [其他資訊] 對話方塊中：

• 確認架構為.NET 9.0（標準支援期）。
• 請確認 [使用控制器] 的核取方塊已被勾選。
• 確認已核取 [啟用 OpenAPI 支援 ] 複選框。
• 選擇建立。

1. 在 [套件管理員主控台] 視窗中，瀏覽到專案根目錄。 執行下列命令以安裝適用於 MongoDB 的 .NET 驅動程式：

   Install-Package MongoDB.Driver
   

Visual Studio Code

1. 在命令提示字元中執行下列命令：

   dotnet new webapi -o BookStoreApi --use-controllers
   code BookStoreApi
   

   上述命令會產生新的 ASP.NET Core Web API 專案，然後在 Visual Studio Code 中開啟專案。

2. 當 OmniSharp 伺服器啟動時，對話方塊會顯示 'BookStoreApi' 缺少建立和偵錯所需的資產。要新增它們嗎？。 選取 [是] 。

3. 開啟 [整合式終端]，並執行下列命令來安裝適用於 MongoDB 的 .NET 驅動程式：

   dotnet add package MongoDB.Driver
   

新增實體模型

1. 將 Models 目錄新增至專案根目錄。

2. 使用下列程式代碼將類別 Book 新增至 Models 目錄：

   using MongoDB.Bson;
   using MongoDB.Bson.Serialization.Attributes;
   
   namespace BookStoreApi.Models;
   
   public class Book
   {
       [BsonId]
       [BsonRepresentation(BsonType.ObjectId)]
       public string? Id { get; set; }
   
       [BsonElement("Name")]
       public string BookName { get; set; } = null!;
   
       public decimal Price { get; set; }
   
       public string Category { get; set; } = null!;
   
       public string Author { get; set; } = null!;
   }
   

   在上述類別中，Id 屬性為：

   • 將 Common Language Runtime (CLR) 物件對應到 MongoDB 集合所需。
   • 使用 [BsonId] 標註，以讓此屬性成為文件的主索引鍵。
   • 加上[BsonRepresentation(BsonType.ObjectId)]批註，以允許將參數傳遞為型別string，而非ObjectId結構。 Mongo 會處理從 string 轉換到 ObjectId 的作業。

   BookName 屬性會使用 [BsonElement] 屬性標註。 Name 的屬性值代表 MongoDB 集合中的屬性名稱。

新增組態模型

1. 將下列資料庫設定值新增至 appsettings.json：

   {
     "BookStoreDatabase": {
       "ConnectionString": "mongodb://localhost:27017",
       "DatabaseName": "BookStore",
       "BooksCollectionName": "Books"
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   }
   

2. 使用下列程式代碼將類別 BookStoreDatabaseSettings 新增至 Models 目錄：

   namespace BookStoreApi.Models;
   
   public class BookStoreDatabaseSettings
   {
       public string ConnectionString { get; set; } = null!;
   
       public string DatabaseName { get; set; } = null!;
   
       public string BooksCollectionName { get; set; } = null!;
   }
   

   上述 BookStoreDatabaseSettings 類別是用來儲存 appsettings.json 檔案的 BookStoreDatabase 屬性值。 JSON 和 C# 屬性名稱以相同方式命名，以簡化對應程序。

3. 將下列醒目提示的程式碼新增至 Program.cs：

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   

   在上述程式碼中，appsettings.json 檔案的 BookStoreDatabase 區段所繫結的設定執行個體已註冊在相依性注入 (DI) 容器中。 例如，BookStoreDatabaseSettings 物件的 ConnectionString 屬性會填入 BookStoreDatabase:ConnectionString 中的 appsettings.json 屬性。

4. 在 Program.cs 的頂端新增下列程式碼，以解析 BookStoreDatabaseSettings 參考：

   using BookStoreApi.Models;
   

新增 CRUD 作業服務

1. 將 Services 目錄新增至專案根目錄。

2. 使用下列程式代碼將類別 BooksService 新增至 Services 目錄：

   using BookStoreApi.Models;
   using Microsoft.Extensions.Options;
   using MongoDB.Driver;
   
   namespace BookStoreApi.Services;
   
   public class BooksService
   {
       private readonly IMongoCollection<Book> _booksCollection;
   
       public BooksService(
           IOptions<BookStoreDatabaseSettings> bookStoreDatabaseSettings)
       {
           var mongoClient = new MongoClient(
               bookStoreDatabaseSettings.Value.ConnectionString);
   
           var mongoDatabase = mongoClient.GetDatabase(
               bookStoreDatabaseSettings.Value.DatabaseName);
   
           _booksCollection = mongoDatabase.GetCollection<Book>(
               bookStoreDatabaseSettings.Value.BooksCollectionName);
       }
   
       public async Task<List<Book>> GetAsync() =>
           await _booksCollection.Find(_ => true).ToListAsync();
   
       public async Task<Book?> GetAsync(string id) =>
           await _booksCollection.Find(x => x.Id == id).FirstOrDefaultAsync();
   
       public async Task CreateAsync(Book newBook) =>
           await _booksCollection.InsertOneAsync(newBook);
   
       public async Task UpdateAsync(string id, Book updatedBook) =>
           await _booksCollection.ReplaceOneAsync(x => x.Id == id, updatedBook);
   
       public async Task RemoveAsync(string id) =>
           await _booksCollection.DeleteOneAsync(x => x.Id == id);
   }
   

   在前面的程式碼中，一個 BookStoreDatabaseSettings 執行個體是透過建構子注入從 DI 取得的。 此技術可讓您存取在appsettings.json一節中新增的設定值。

3. 將下列醒目提示的程式碼新增至 Program.cs：

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   
   builder.Services.AddSingleton<BooksService>();
   

   在上述程式碼中，BooksService 類別要向 DI 註冊才能在取用類別中支援建構函式插入。 因為 BooksService 直接依存於 MongoClient，所以 Singleton 服務存留期最適合。 根據官方的 Mongo 用戶端重複使用指導方針，應該將 MongoClient 註冊為 DI 中的單例服務存留期。

4. 在 Program.cs 的頂端新增下列程式碼，以解析 BooksService 參考：

   using BookStoreApi.Services;
   

BooksService 類別使用下列 MongoDB.Driver 成員來對資料庫執行 CRUD 作業：

• MongoClient：讀取執行資料庫作業的伺服器實例。 此類別的建構函式會在 MongoDB 連接字串中提供：

  public BooksService(
      IOptions<BookStoreDatabaseSettings> bookStoreDatabaseSettings)
  {
      var mongoClient = new MongoClient(
          bookStoreDatabaseSettings.Value.ConnectionString);
  
      var mongoDatabase = mongoClient.GetDatabase(
          bookStoreDatabaseSettings.Value.DatabaseName);
  
      _booksCollection = mongoDatabase.GetCollection<Book>(
          bookStoreDatabaseSettings.Value.BooksCollectionName);
  }
  

• IMongoDatabase：代表執行作業的 Mongo 資料庫。 本教學課程使用 介面上的一般 GetCollection<TDocument>（collection） 方法，以存取特定集合中的數據。 呼叫此方法之後，針對集合執行 CRUD 作業。 在 GetCollection<TDocument>(collection) 方法呼叫中：

  • collection 代表集合名稱。
  • TDocument 代表儲存在集合中的 CLR 物件類型。

GetCollection<TDocument>(collection) 會傳回代表集合的 MongoCollection 物件。 在此教程中，會在集合上調用下列方法：

• DeleteOneAsync：刪除符合所提供搜尋準則的單一檔。
• 找到<TDocument>：傳回集合中符合所提供搜尋準則的所有檔。
• InsertOneAsync：將提供的 物件插入為集合中的新檔。
• ReplaceOneAsync：將符合所提供搜尋準則的單一檔取代為提供的物件。

新增控制器

使用下列程式代碼將類別 BooksController 新增至 Controllers 目錄：

using BookStoreApi.Models;
using BookStoreApi.Services;
using Microsoft.AspNetCore.Mvc;

namespace BookStoreApi.Controllers;

[ApiController]
[Route("api/[controller]")]
public class BooksController : ControllerBase
{
    private readonly BooksService _booksService;

    public BooksController(BooksService booksService) =>
        _booksService = booksService;

    [HttpGet]
    public async Task<List<Book>> Get() =>
        await _booksService.GetAsync();

    [HttpGet("{id:length(24)}")]
    public async Task<ActionResult<Book>> Get(string id)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        return book;
    }

    [HttpPost]
    public async Task<IActionResult> Post(Book newBook)
    {
        await _booksService.CreateAsync(newBook);

        return CreatedAtAction(nameof(Get), new { id = newBook.Id }, newBook);
    }

    [HttpPut("{id:length(24)}")]
    public async Task<IActionResult> Update(string id, Book updatedBook)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        updatedBook.Id = book.Id;

        await _booksService.UpdateAsync(id, updatedBook);

        return NoContent();
    }

    [HttpDelete("{id:length(24)}")]
    public async Task<IActionResult> Delete(string id)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        await _booksService.RemoveAsync(id);

        return NoContent();
    }
}

之前的 Web API 控制器。

• 使用 BooksService 類別來執行 CRUD 作業。
• 包含動作方法以支援 GET、POST、PUT 與 DELETE HTTP 要求。
• 在CreatedAtAction 動作方法中呼叫 Create，以傳回 HTTP 201 回應。 對於可在伺服器上建立新資源的 HTTP POST 方法，其標準回應是狀態碼 201。 CreatedAtAction 也會將 Location 標頭新增至回應。 Location 標頭指定新建書籍的 URI。

設定 JSON 序列化選項

有兩個細節需要變更，此變更涉及在「測試 Web API」章節中傳回的 JSON 回應。

• 屬性名稱的預設駝峰式大小寫應更改，使其符合 CLR 物件屬性的 Pascal 大小寫。
• bookName 屬性應傳回為 Name。

為滿足上述需求，請進行下列變更：

1. 在 Program.cs 中，將下列醒目提示的程式碼鏈結至 AddControllers 方法呼叫：

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   
   builder.Services.AddSingleton<BooksService>();
   
   builder.Services.AddControllers()
       .AddJsonOptions(
           options => options.JsonSerializerOptions.PropertyNamingPolicy = null);
   

   完成前述變更後，Web API 序列化 JSON 回應中屬性名稱即符合其對應的 CLR 物件類型屬性名稱。 例如，Book 類別的 Author 屬性會序列化為 Author，而非 author。

2. 在 Models/Book.cs 中，為 BookName 屬性標註 [JsonPropertyName] 屬性：

   [BsonElement("Name")]
   [JsonPropertyName("Name")]
   public string BookName { get; set; } = null!;
   

   [JsonPropertyName] 的屬性值 Name 代表 Web API 序列化 JSON 回應中的屬性名稱。

3. 在 Models/Book.cs 的頂端新增下列程式碼，以解析 [JsonProperty] 屬性參考：

   using System.Text.Json.Serialization;
   

4. 重複測試 Web API 一節中定義的步驟。 請注意 JSON 屬性名稱中的差異。

測試 Web API

Visual Studio

本教學課程使用 端點總管和 .HTTP 檔案 來測試 API。

1. 建置並執行應用程式。

2. 在 [端點總管] 中，以滑鼠右鍵按兩下第一個 GET 端點 /api/books，然後選取 [ 產生要求]。

   下列內容會新增至 BookStoreApi.http 檔案。 如果這是第一次產生要求，則會在專案根目錄中建立檔案。

   @BookStoreApi_HostAddress = https://localhost:<port>
   
   GET {{BookStoreApi_HostAddress}}/api/books
   
   ###
   

   連接埠號碼應該已經設定為應用程式所使用的埠，例如 https://localhost:56874。 如果不是這種情況，當您啟動應用程式時，可以在輸出視窗中找到您的埠號碼。

3. 選取新要求行上方的 GET] 連結。

   GET 要求會傳送至應用程式，而回應會顯示在 [回應] 窗格中。

4. ** 回應內容會顯示 JSON 結果，其中包含類似下列的書籍條目：

   [
     {
       "Id": "61a6058e6c43f32854e51f51",
       "Name": "Design Patterns",
       "Price": 54.93,
       "Category": "Computers",
       "Author": "Ralph Johnson"
     },
     {
       "Id": "61a6058e6c43f32854e51f52",
       "Name": "Clean Code",
       "Price": 43.15,
       "Category": "Computers",
       "Author": "Robert C. Martin"
     }
   ]
   

5. 若要取得單一書籍，請在 /api/books/{id}, params (string id) 中以滑鼠右鍵按一下 GET 端點，然後選取 產生要求。

   下列內容會附加至 BookStoreApi.http 檔案：

   @id=string
   GET {{BookStoreApi_HostAddress}}/api/books/{{id}}
   
   ###
   

6. 以先前要求傳回的其中一個標識碼取代 id 變數，例如：

   @id="61a6058e6c43f32854e51f52"
   GET {{BookStoreApi_HostAddress}}/api/books/{{id}}
   
   ###
   

7. 選取新要求行上方的 GET] 連結。

   GET 要求會傳送至應用程式，而回應會顯示在 [回應] 窗格中。

8. 回應主體會顯示類似下列的 JSON：

   {
     "Id": "61a6058e6c43f32854e51f52",
     "Name": "Clean Code",
     "Price": 43.15,
     "Category": "Computers",
     "Author": "Robert C. Martin"
   }
   

9. 若要測試 POST 端點，請以滑鼠右鍵按兩下 /api/booksPOST 端點，然後選取 [ 產生要求]。

   下列內容會新增至 BookStoreApi.http 檔案：

   POST {{BookStoreApi_HostAddress}}/api/books
   Content-Type: application/json
   
   {
     //Book
   }
   
   ###
   

10. 將書籍評論替換為 book 物件，作為 JSON 請求的主體：

    POST {{BookStoreApi_HostAddress}}/api/books
    Content-Type: application/json
    
     {
       "Name": "The Pragmatic Programmer",
       "Price": 49.99,
       "Category": "Computers",
       "Author": "Andy Hunt"
     }
    
    ###
    

11. 選取要求行上方的 POST] 連結。

    POST 要求會傳送至應用程式，而響應會顯示在 [ 回應 ] 窗格中。 回應應該包含新建立的書籍及其指定的ID。

12. 最後，若要刪除書籍，請以滑鼠右鍵按兩下 /api/books/{id}, params (string id)DELETE 端點，然後選取 [ 產生要求]。

    下列內容會附加至 BookStoreApi.http 檔案：

    DELETE {{BookStoreApi_HostAddress}}/api/Books/{{id}}
    
    ###
    

13. 將id 變數替換為之前的請求返回的其中一個識別碼，然後點擊 [傳送要求]。 例如：

    DELETE {{BookStoreApi_HostAddress}}/api/Books/67f417517ce1b36aeab71236
    
    ###
    

Visual Studio Code

本教學課程使用 OpenAPI 規格 （openapi.json） 和 Swagger UI 來測試 API。

1. 執行下列命令來安裝 Swagger UI：

dotnet add package NSwag.AspNetCore

上一個命令會新增 NSwag.AspNetCore 套件，其中包含用來產生 Swagger 檔和 UI 的工具。 因為我們的專案是使用 OpenAPI，所以我們只會使用 NSwag 套件來產生 Swagger UI。

1. 設定 Swagger 中介軟體

在 Program.cs中，加入下列醒目標示的程式碼：

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.MapOpenApi();
    app.UseSwaggerUI(options =>
    {
        options.SwaggerEndpoint("/openapi/v1.json", "v1");
    });
}

先前的程式代碼會啟用 Swagger 中間件，以使用 Swagger UI 提供產生的 JSON 檔。 Swagger 只會在開發環境中啟用。 在生產環境中啟用 Swagger 可能會公開關於 API 結構和實作的潛在敏感性詳細資料。

應用程式會使用 OpenApi 所產生的 OpenAPI 檔，位於 /openapi/v1.json，來產生 UI。 在專案運行時，透過瀏覽器前往 WeatherForecast，以檢視 https://localhost:<port>/openapi/v1.json API 所生成的 OpenAPI 規格。

OpenAPI 規格是 JSON 格式的檔，可描述 API 的結構和功能，包括端點、要求/回應格式、參數等等。 它基本上是 API 的藍圖，可供各種工具用來瞭解並與您的 API 互動。

1. 建置並執行應用程式。

2. 在您的瀏覽器中導航至 https://localhost:<port>/swagger。 Swagger 提供 UI，以根據 OpenAPI 檔測試所有 API 端點。

3. 展開 [GET /api/books ] 端點，然後按兩下 [ 試用] 按鈕。

4. 按兩下 [ 執行] 按鈕，將要求傳送至 API。

5. 回應主體 區段會顯示 JSON 陣列，其書籍類似如下：

   [
     {
       "Id": "61a6058e6c43f32854e51f51",
       "Name": "Design Patterns",
       "Price": 54.93,
       "Category": "Computers",
       "Author": "Ralph Johnson"
     },
     {
       "Id": "61a6058e6c43f32854e51f52",
       "Name": "Clean Code",
       "Price": 43.15,
       "Category": "Computers",
       "Author": "Robert C. Martin"
     }
   ]
   

6. 接下來，展開 GET /api/books/{id} 端點，然後點擊 試用。

7. 在 標識符 欄位中輸入先前回應中的其中一個書籍標識碼，然後按兩下 [ 執行]。

8. 回應主體 區段會顯示指定書籍的 JSON 物件。 例如，標識碼 61a6058e6c43f32854e51f52 的結果類似下列：

   {
     "Id": "61a6058e6c43f32854e51f52",
     "Name": "Clean Code",
     "Price": 43.15,
     "Category": "Computers",
     "Author": "Robert C. Martin"
   }
   

9. 若要測試建立新書籍，請展開 POST /api/books 端點，然後按兩下 [試用]。

10. 將預設請求內容替換為新的書籍物件：

    {
      "Name": "The Pragmatic Programmer",
      "Price": 49.99,
      "Category": "Computers",
      "Author": "Andy Hunt"
    }
    

11. 按兩下 [執行 ] 以傳送要求。

12. 回應應具有 201（已建立）的狀態代碼，並在回應本文中包含新建立的書籍及其指派標識符。

13. 最後，若要刪除書籍記錄，請展開 DELETE /api/books/{id} 端點，點擊 試用，然後在 id 欄位中輸入先前回應中的其中一個書籍ID。 按兩下 [執行 ] 以傳送要求。

14. 回應應具有狀態代碼 204 （無內容），表示已成功刪除書籍。

將驗證支援新增至 Web API

ASP.NET Core Identity 會將使用者介面 (UI) 登入功能新增至 ASP.NET Core Web 應用程式。 若要保護 Web API 和 SPA，請使用下列其中一項：

• Microsoft Entra 身份識別
• Azure Active Directory B2C （Azure AD B2C）
• Duende Identity 伺服器

Duende Identity 伺服器是適用於 ASP.NET Core 的 OpenID Connect 和 OAuth 2.0 架構。 Duende Identity 伺服器會啟用下列安全性功能：

• 驗證即服務 (AaaS)
• 多個應用程式類型的單一登入/登出 (SSO)
• API 的存取控制
• 同盟閘道

重要

Duende Software 可能會要求您支付使用 Duende Identity 伺服器的授權費用。 如需詳細資訊，請參閱 從 .NET 5 中的 ASP.NET Core 移轉至 .NET 6。

如需詳細資訊，請參閱 Duende 伺服器檔（Duende Identity Software 網站）。

其他資源

• 檢視或下載範例程式代碼 （如何下載）
• 使用 ASP.NET Core 建立 Web API
• ASP.NET Core Web API 中的控制器動作傳回類型
• 使用 ASP.NET Core 建立 Web API