// Copyright (C) 2024, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using System; using System.Collections.Generic; using System.Net.Http; using Duplicati.Library.Interface; namespace Duplicati.Library.Utility; /// /// This class was created as a proxy to access the HttpClientFactory /// in places where dependency injection is not yet implemented or /// desirable. /// public static class HttpClientHelper { /// /// Globally configured certificate validator to be used across the application. /// Each backend can choose when creating the httpclient/requesthandler if it will /// use this or the default (null) validator. /// public static SslCertificateValidator CertificateValidator { get; set; } /// /// Central HttpClient singleton instance to be used across the application as /// per the HttpClientFactory recommended pattern. /// public static HttpClient DefaultClient { get; private set; } /// /// Reference to the HttpClientFactory instance so we can create specific clients /// when the singleton pattnern is not desirable. /// private static IHttpClientFactory _factory { get; set; } /// /// Sets the factory reference. /// /// IHttpClientFactory instance public static void Configure(IHttpClientFactory factory) { _factory = factory; DefaultClient = factory.CreateClient(); } /// /// Creates a new HttpClient instance, to be used in places where the singleton /// pattern is not desirable. /// /// public static HttpClient CreateClient() { return _factory?.CreateClient() ?? new HttpClient(); } /// /// Creates a new HttpClient instance with a specific handler, wherever its needed. /// /// HttpClientHandler configured with authentication parameters /// public static HttpClient CreateClient(HttpClientHandler handler) { return new HttpClient(handler); } /// /// Configures the httphandler with the certificate validator, if needed. /// /// The parameters indicate if it should accept all certificates or only the ones specified in the /// hashes array. /// /// The HttpClientHandler to be configured /// If all certificates will be considered valid /// List of hashes of certificates that will be accepted public static void ConfigureHandlerCertificateValidator(HttpClientHandler handler, bool acceptAllCertificates, string[] acceptSpecificCertificateHashes) { var validator = new SslCertificateValidator(acceptAllCertificates, acceptSpecificCertificateHashes); handler.ServerCertificateCustomValidationCallback = validator.ValidateServerCertificate; } }