c# HttpWebRequest 设置Basic Auth

### C# 中实现 HTTP 认证的方法 在 C# 中，可以通过多种方式实现 HTTP 认证。通常情况下，使用 `HttpClient` 或者 `HttpWebRequest` 来处理网络请求，并通过设置相应的头部信息完成身份验证。 以下是基于 `HttpClient` 的基本示例： #### 使用 Basic Authentication 进行认证 Basic Authentication 是一种常见的 HTTP 身份验证机制。它涉及将用户名和密码编码为 Base64 字符串并将其作为 Authorization 头部的一部分发送给服务器。 ```csharp using System; using System.Net.Http; using System.Text; public class Program { public static async void Main() { var username = "your_username"; var password = "your_password"; using (var client = new HttpClient()) { // 创建授权头 string credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes($"{username}:{password}")); client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", credentials); try { HttpResponseMessage response = await client.GetAsync("https://example.com/api/resource"); response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } catch (Exception ex) { Console.WriteLine($"Error: {ex.Message}"); } } } } ``` 上述代码展示了如何创建一个带有 Basic Auth 的 HTTP 请求[^1]。 --- #### 使用 Bearer Token 进行认证 Bearer Token 是 OAuth 2.0 常见的身份验证形式之一。在这种模式下，客户端会收到一个令牌（Token），并将该令牌附加到每次请求的 Authorization 头部中。 ```csharp using System; using System.Net.Http; public class Program { public static async void Main() { var token = "your_access_token"; using (var client = new HttpClient()) { // 设置 Bearer Token client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token); try { HttpResponseMessage response = await client.GetAsync("https://example.com/api/resource"); response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } catch (Exception ex) { Console.WriteLine($"Error: {ex.Message}"); } } } } ``` 此代码片段演示了如何向 API 发送带有效令牌的请求。 --- #### 结合异步操作优化性能 为了提升程序的响应速度，在实际开发过程中推荐采用异步编程模型。这不仅适用于邮件发送场景，也适合于任何耗时的操作，比如网络通信。可以参考以下改进版本： ```csharp using System; using System.Net.Http; using System.Threading.Tasks; public class AsyncProgram { public static async Task RunAsync(string url, string token) { using (var client = new HttpClient()) { client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token); try { HttpResponseMessage response = await client.GetAsync(url).ConfigureAwait(false); // 防止线程阻塞 response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync().ConfigureAwait(false); Console.WriteLine(responseBody); } catch (Exception ex) { Console.WriteLine($"Error: {ex.Message}"); } } } public static void Main() { _ = RunAsync("https://example.com/api/resource", "your_access_token").ContinueWith(task => { if (task.IsFaulted && task.Exception != null) { Console.WriteLine($"Task failed with exception: {task.Exception.InnerException?.Message}"); } }); } } ``` 这里引入了 `.ConfigureAwait(false)` 和任务链式调用来进一步减少上下文切换开销。 --- #### 扩展：HTTPS 客户端证书认证 对于某些安全需求较高的服务来说，可能还需要提供 SSL/TLS 客户端证书来进行额外的安全保障。下面是一个简单的例子展示如何加载 PFX 文件用于 HTTPS 请求中的客户机认证。 假设已经有一个名为 `client.pfx` 的文件及其对应的密钥字符串，则可通过 OpenSSL 工具生成所需的 PKCS12 格式的 pfx 文件[^2]: ```bash openssl pkcs12 -export -out client.pfx -inkey client.key -in client.cer ``` 接着可以在 .NET 应用里读取这个 pfx 并配置 SslClientAuthenticationOptions: ```csharp using System; using System.IO; using System.Security.Cryptography.X509Certificates; using System.Net.Http; using System.Net.Security; using System.Threading.Tasks; class Program { private const string CertPath = @"path\to\client.pfx"; private const string Password = "pfx_password"; static async Task Main(string[] args) { X509Certificate2 cert = new X509Certificate2(CertPath, Password); HttpHandler handler = new HttpClientHandler(); handler.ClientCertificates.Add(cert); using(HttpClient client = new HttpClient(handler)) { try { HttpResponseMessage resp = await client.GetAsync("https://secure.example.com/"); resp.EnsureSuccessStatusCode(); string content = await resp.Content.ReadAsStringAsync(); Console.WriteLine(content); }catch(Exception e){ Console.WriteLine(e.ToString()); } } } } ``` 以上代码实现了通过指定路径下的 PFX 文件以及其密码来建立具有客户端证书支持的 HTTPS 请求连接。 ---