IdentityServer4.Contrib.HttpClientService 2.1.0

An HttpClient service for IdentityServer4

An HttpClient service that makes it easy to make authenticated HTTP requests to protected by IdentityServer4 resources. Complex types are automatically serialized for requests / deserialized form responses, all with a fluent interface design:

var responseObject = await _requestServiceFactory
                          //Create a instance of the service
                          .CreateHttpClientService()
                          //Also supports IOptions<>
                          .SetIdentityServerOptions("appsettings_section")
                          //GET and deserialize the response body to IEnumerable<Customers>
                          .GetAsync<IEnumerable<Customers>>("https://api/customers");

The variable responseObject contains multiple properties: from the entire HttpResponseMessage and HttpRequestMessage, to HttpStatusCode and HttpResponseHeaders. The most exciting feature though, is the TResponseBody BodyAsType property which will contain deserializabled complex types from JSON responses (in the example above the BodyAsType will be of type IEnumerable<Customers>). Check the ResponseObject<TResponseBody> in the docs.

Setting up complex request body for POST, PUT and PATCH requests is also very easy! Here are some examples:

var responseObject = await _requestServiceFactory
                          //Create a instance of the service
                          .CreateHttpClientService()
                          //.PostAsync<TRequestBody,TResponseBody>(URL, customer of type Customer1)
                          .PostAsync<Customer1,Customer2>("https://api/customers", customer);

You can also fine tune encoding and media-type by using the TypeContent(TRequestBody model, Encoding encoding, string mediaType) like this:

var responseObject = await _requestServiceFactory
                          //Create a instance of the service
                          .CreateHttpClientService()
                          //.PostAsync<TRequestBody,TResponseBody>(URL, customer of type Customer1)
                          .PostAsync<TypeContent<Customer1>,Customer2>("https://api/customers", new TypeContent(customer, Encoding.UTF8, "application/json"));

HTTP verbs supported are: GET, POST, PUT, DELETE, PATCH and HEAD. Read the Documentation for technical details, check the features sample or a more complete one.

Getting Started

Getting started with IdentityServer4.Contrib.HttpClientService is easy; you only need three things:

1. Install the nuget package IdentityServer4.Contrib.HttpClientService
2. Provide the options to authenticate in appsettings.json
3. Register the service in Startup.cs

Read the entire Getting Started guide for a quick start. You can also take a look at the Documentation, check the features sample or a more complete one.

Contributing

Feedback and contibution is more than welcome, as there are many more things to do!

Just as a sample:

1. Expand the IdentityServer4.Contrib.HttpClientService.CompleteSample with more functionality.
2. Support JsonSerializerSettings for JsonConvert.DeserializeObject<TResponseBody>(apiResponse.BodyAsString) in HttpClientService.
3. Support more than ClientCredentials.
4. Add logging.

Many more are coming soon and all of them should be issues, so feel free to open one and let's start discussing solutions!