IRONSOFTWAREHOME
IRONSUITE所有10個程式庫只需支付2個的價格
聯絡銷售
按公司
開發者更新

C# OAuth2（對於開發者的運行原理）

Jacob Mellor，首席技術官 @ Team Iron
Jacob Mellor
Updated: 2026年4月21日

OAuth2 是一個強大的協議，用於處理使用者驗證和授權，從而保護您的網頁應用程式。 在C#開發領域中，了解OAuth2可以大大增強您的應用程式的安全性和功能。

本指南專為初學者量身打造，重點介紹關鍵概念、實用範例和容易理解的解釋。 我們還將學習使用 IronPDF 程式庫搭配OAuth2的使用例。

了解OAuth2及其重要性

C# OAuth2（對開發者而言的運作方式）：圖1 - OAuth2網頁

OAuth2是一種協議，允許客戶端應用程式在使用者的授權下，請求存取由授權伺服器託管的資源。 它是現代網頁應用程式中常用的用來處理使用者驗證和授權的方法。

OAuth2的主要目標是提供安全且有效的資源存取，而不直接與客戶端應用程式共享使用者的憑證（如使用者名稱和密碼）。

OAuth2的關鍵概念

在進入實作之前，讓我們澄清一些基本的OAuth2術語：

  • 客戶端應用程式： 請求存取使用者帳戶的應用程式。
  • 授權伺服器： 驗證使用者並向客戶端應用程式發出存取令牌的伺服器。
  • 存取令牌： 賦予客戶端應用程式在有限時間內存取使用者帳戶的權限。
  • 刷新令牌： 當當前的存取令牌過期時，用於獲取新存取令牌，而無需再次要求使用者的憑證。
  • 客戶端ID 和 客戶端密鑰： 用於識別客戶端應用程式對授權伺服器的憑證。
  • 重定向URI： 授權伺服器在授予或拒絕客戶端應用程式存取後將使用者發送至的URI。
  • 授權碼流程： 一種安全的方法，其中客戶端應用程式接受授權碼作為中間步驟，然後將其交換為存取令牌。

在C#中實施OAuth2：基本範例

讓我們建立一個簡單的C#應用程式，使用OAuth2進行使用者驗證。 此範例將指導您設置OAuth2客戶端、獲取存取令牌並向受保護資源發出請求。

設置您的OAuth2客戶端

首先，您需要將您的C#應用程式註冊到OAuth2授權伺服器。 此過程取決於伺服器，但通常您會收到一個客戶端ID和一個客戶端密鑰，這些是OAuth2流程中的關鍵。

步驟1：定義應用程式的憑證

作為第一步，您需要設置客戶端憑證，如客戶端ID和客戶端密鑰。 這是範例程式碼：

// Define your client credentials
class Program
{
    private static string clientId = "your-client-id"; // Your client ID
    private static string clientSecret = "your-client-secret"; // Your client secret
    private static string redirectUri = "your-redirect-uri"; // Your redirect URI
    static void Main(string[] args)
    {
        // OAuth2 implementation will go here
    }
}

步驟2：請求使用者授權

要啟動OAuth2流程，將使用者重定向到授權伺服器的授權端點。 下面是如何構建授權請求的URL：

static void Main(string[] args)
{
    var authorizationEndpoint = "https://authorization-server.com/auth"; // Authorization server endpoint
    var responseType = "code"; // Response type for authorization
    var scope = "email profile"; // Scopes for the authorization request
    var authorizationUrl = $"{authorizationEndpoint}?response_type={responseType}&client_id={clientId}&redirect_uri={redirectUri}&scope={scope}";
    // Redirect the user to authorizationUrl
}

步驟3：處理授權回應

在使用者授予或拒絕權限後，授權伺服器會重定向他們回到您的應用程式，並帶著授權碼或錯誤訊息。 您需要從重定向URI的查詢參數中獲取此程式碼。

步驟4：交換授權碼

現在，您要將授權碼交換為存取令牌。 這需要向授權伺服器的令牌端點發送一個POST請求。

using System.IO;
using System.Net;
using System.Text;
using System.Threading.Tasks;

// Method to exchange authorization code for an access token
public static async Task<string> ExchangeAuthorizationCodeForAccessToken(string authorizationCode)
{
    var tokenEndpoint = "https://authorization-server.com/token"; // Token endpoint
    var postData = $"grant_type=authorization_code&code={authorizationCode}&redirect_uri={redirectUri}&client_id={clientId}&client_secret={clientSecret}";
    var data = Encoding.ASCII.GetBytes(postData);
    var request = WebRequest.Create(tokenEndpoint);
    request.Method = "POST"; // Use post method to request the access token
    request.ContentType = "application/x-www-form-urlencoded"; // Content type
    request.ContentLength = data.Length;
    using (var stream = request.GetRequestStream())
    {
        stream.Write(data, 0, data.Length);
    }
    var response = (HttpWebResponse)request.GetResponse();
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    // Extract and return the access token from the response
    var token = ExtractAccessTokenFromResponse(responseString);
    return token;
}

此函式發送一個POST請求到令牌端點，附上必要資料，並從回應中提取存取令牌。

步驟5：發出授權請求

使用存取令牌，您現在可以向需要身份驗證的資源發出請求。 將存取令牌作為Bearer令牌附加到您的請求的授權標頭中。

using System.Net.Http;
using System.Threading.Tasks;

// Method to make authorized requests
public static async Task<string> MakeAuthorizedRequest(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    // Make the request to the API
    var response = await httpClient.GetAsync(apiUrl);
    response.EnsureSuccessStatusCode();
    var responseString = await response.Content.ReadAsStringAsync();
    return responseString;
}

IronPDF簡介

C# OAuth2（對開發者而言的運作方式）：圖2 - IronPDF網頁

IronPDF 是一個多功能的C#程式庫，允許在.NET應用程式中直接生成、操作和渲染PDF文件。 這個強大的工具簡化了處理PDF文件的過程，使其輕鬆建立複雜的文件、毫不費力地將HTML轉換為PDF、從PDF中提取文字，還有更多功能。 其簡單明瞭的API允許開發者快速將PDF功能整合到他們的應用程式中，而無需深入了解PDF規範。

IronPDF在HTML轉換為PDF方面表現出色，保留佈局和樣式。 此功能允許從網頁內容生成PDF，非常適用於報告、發票和文件。 支持將HTML文件、URL和HTML字串轉換為PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer(); // Create an instance of the PDF renderer

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"; // HTML content as string
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf"); // Save the PDF

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf"); // Save the PDF

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf"); // Save the PDF
    }
}

程式碼範例：從受保護內容生成PDF

想像一下，您有一個端點，該端點僅供認證使用者存取HTML內容。 您可以使用IronPDF將此HTML內容轉換為PDF文件，利用通過OAuth2獲得的存取令牌。

首先，讓我們定義一個方法，使用存取令牌來獲取受保護的HTML內容：

using System.Net.Http;
using System.Threading.Tasks;

// Method to fetch protected content
public static async Task<string> FetchProtectedContent(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    var response = await httpClient.GetAsync(apiUrl); // Make the request to the protected API
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync(); // Return the HTML content
}

現在，讓我們使用IronPDF將獲取的HTML內容轉換為PDF文件：

using IronPdf;

// Method to convert HTML content to PDF
public static async Task ConvertHtmlToPdf(string accessToken, string apiUrl, string outputPdfPath)
{
    // Fetch protected content using the access token
    string htmlContent = await FetchProtectedContent(accessToken, apiUrl);
    // Use IronPDF to convert the HTML content to a PDF document
    var renderer = new IronPdf.HtmlToPdf();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to a file
    pdf.SaveAs(outputPdfPath);
}

在上述程式碼中，FetchProtectedContent 負責使用OAuth2存取令牌從受保護資源中檢索HTML內容。 一旦獲取HTML內容，就將其傳遞給IronPDF的 HtmlToPdf 渲染器，以生成PDF文件，然後保存到指定路徑。

結論

本指南介紹了在C#應用程式中使用OAuth2的基礎，包括關鍵概念、術語和一個簡單明瞭的實作範例。 OAuth2通過高效處理使用者驗證和授權，對保護網頁應用程式起著關鍵作用。 雖然本範例演示了授權碼流程，但OAuth2還支持其他適合不同型別應用程式的流程。

通過整合IronPDF的高階PDF操作，C#開發者可以擴展其應用程式的能力，包含PDF生成和操作，豐富已認證使用者可享用的功能。 IronPDF使用簡單且全面的PDF操作能力，使其成為.NET開發者在項目中處理PDF文件的絕佳工具。 提供免費試用以探索所有功能，其授權價格從$999起。

Jacob Mellor，首席技術官 @ Team Iron
Jacob Mellor
首席技術官

Jacob Mellor是Iron Software的首席技術官，一位在C# PDF技術上開創先河的遠見工程師。作為Iron Software核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。

...
閱讀更多

相關文章

Key in blue circle

立即免費取得 30 天試用金鑰。

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

OR
bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
預訂您的免費現場演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密。
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立
C# 用於PDF的NuGet程式庫
使用NuGet安裝

版本： 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器，右鍵點選參考，管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝
C# PDF DLL
下載DLL

版本： 2026.9

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置，位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器，右鍵點選參考。選擇瀏覽，"IronPdf.dll"

授權從$999起