HTTP authentication with client certificate

Author: mihaj

.github/workflows/dotnet-core.yml

@@ -24,8 +24,10 @@ jobs:
       uses: actions/setup-dotnet@v1
       with:
         dotnet-version: '5.0.x'
+    - name: Clean
+      run: dotnet clean --configuration Release && dotnet nuget locals all --clear
     - name: Install dependencies
-      run: dotnet restore
+      run: dotnet restore qatoolkit-engine-httptester-net.sln
     - name: Build
       run: dotnet build --configuration Release --no-restore
     - name: Test

Directory.Build.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>0.3.0</Version>
+    <Version>0.3.1</Version>
   </PropertyGroup>
 </Project>

Nuget.config

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+    <packageRestore>
+        <add key="enabled" value="True" />
+    </packageRestore>
+    <packageManagement>
+        <add key="format" value="1" />
+    </packageManagement>
+    <packageSources>
+        <clear />
+        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+    </packageSources>
+    <activePackageSource>
+        <add key="All" value="(Aggregate source)" />
+    </activePackageSource>
+</configuration>

README.md

@@ -30,10 +30,10 @@ using (var client = new HttpTesterClient())
         .WithBearerAuthentication("eXy....")
         .Start();
 
-    var msg = await response.GetResponseBody<List<Bicycle>>();
+    var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
-    var expecterResponse = BicycleFixture.GetBicycles().ToExpectedObject();
-    expecterResponse.ShouldEqual(msg);
+    var expectedResponse = BicycleFixture.GetBicycles().ToExpectedObject();
+    expectedResponse.ShouldEqual(msg);
 
     Assert.True(client.Duration < 2000); //Start() method execution duration
     Assert.True(client.HttpDuration < 2000); //HTTP request duration
@@ -64,10 +64,10 @@ using (var client = new HttpTesterClient())
         .WithBasicAuthentication("user", "pass")
         .Start();
 
-    var msg = await response.GetResponseBody<Bicycle>();
+    var msg = await response.GetResponseJsonBody<Bicycle>();
 
-    var expecterResponse = bicycle.ToExpectedObject();
-    expecterResponse.ShouldEqual(msg);
+    var expectedResponse = bicycle.ToExpectedObject();
+    expectedResponse.ShouldEqual(msg);
 
     Assert.True(client.Duration < 2000);
     Assert.True(response.IsSuccessStatusCode);
@@ -196,6 +196,18 @@ Currently `HttpTesterClient` supports:
         .Start();
 ```
 
+##### Client certificate authentication
+
+You can pass `X509Certificate2` objet to the `WithCertificateAuthentication` method from certificate store or file.
+
+```csharp
+    var response = await client
+        .CreateHttpRequest(new Uri("https://qatoolkitapi.azurewebsites.net"))
+        ....
+        .WithCertificateAuthentication(new X509Certificate2(...))
+        .Start();
+```
+
 ### HttpTestAsserter
 
 This is an implementation of the HTTP response message asserter, which can be used to assert different parameters.

src/QAToolKit.Engine.HttpTester.Test/Exceptions/QAToolKitEngineHttpTesterExceptionTests.cs

@@ -1,5 +1,6 @@
 using QAToolKit.Engine.HttpTester.Exceptions;
 using System;
+using System.Runtime.Serialization;
 using Xunit;
 
 namespace QAToolKit.Engine.HttpTester.Test.Exceptions

src/QAToolKit.Engine.HttpTester.Test/HttpTestAsserterTests.cs

@@ -25,7 +25,7 @@ public async Task HttpTestAsserterSimple_Success()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
 
@@ -56,7 +56,7 @@ public async Task HttpTestAsserterDoesNotContainHeader_Success()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
 
@@ -83,7 +83,7 @@ public async Task HttpTestAsserterDoesNotContainKeywordInBody_Success()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
 
@@ -110,7 +110,7 @@ public async Task HttpTestAsserterHeaderMissing_Fails()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
 
@@ -138,7 +138,7 @@ public async Task HttpTestAsserterBodyNull_Fails()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
 
@@ -163,7 +163,7 @@ public async Task HttpTestAsserterAlternativeDurationPredicate_Success()
                  .WithPath("/api/bicycles")
                  .Start();
 
-                var msg = await response.GetResponseBody<List<Bicycle>>();
+                var msg = await response.GetResponseJsonBody<List<Bicycle>>();
 
                 var asserter = new HttpTestAsserter(response);
                 var duration = client.Duration;