Soenneker.Utils.HttpClientCache.Ssrf
11.0.103
Prefix Reserved
See the version list below for details.
dotnet add package Soenneker.Utils.HttpClientCache.Ssrf --version 11.0.103
NuGet\Install-Package Soenneker.Utils.HttpClientCache.Ssrf -Version 11.0.103
<PackageReference Include="Soenneker.Utils.HttpClientCache.Ssrf" Version="11.0.103" />
<PackageVersion Include="Soenneker.Utils.HttpClientCache.Ssrf" Version="11.0.103" />
<PackageReference Include="Soenneker.Utils.HttpClientCache.Ssrf" />
paket add Soenneker.Utils.HttpClientCache.Ssrf --version 11.0.103
#r "nuget: Soenneker.Utils.HttpClientCache.Ssrf, 11.0.103"
#:package Soenneker.Utils.HttpClientCache.Ssrf@11.0.103
#addin nuget:?package=Soenneker.Utils.HttpClientCache.Ssrf&version=11.0.103
#tool nuget:?package=Soenneker.Utils.HttpClientCache.Ssrf&version=11.0.103
Soenneker.Utils.HttpClientCache.Ssrf
SSRF-safe, DNS-rebinding-resistant HttpClient caching.
Installation
dotnet add package Soenneker.Utils.HttpClientCache.Ssrf
Registration
using Soenneker.Utils.HttpClientCache.Ssrf.Registrars;
services.AddSsrfHttpClientCacheAsSingleton();
AddSsrfHttpClientCacheAsScoped() is also available. Both methods register the underlying
Soenneker.Utils.HttpClientCache service with the matching lifetime when it has not already
been registered.
Usage
using Soenneker.Utils.HttpClientCache.Ssrf.Abstract;
public sealed class RemoteDocumentClient
{
private readonly ISsrfHttpClientCache _clientCache;
public RemoteDocumentClient(ISsrfHttpClientCache clientCache)
{
_clientCache = clientCache;
}
public async ValueTask<string> Download(Uri uri, CancellationToken cancellationToken)
{
HttpClient client = await _clientCache.Get("remote-documents", cancellationToken);
return await client.GetStringAsync(uri, cancellationToken);
}
}
The cache implements the same API as IHttpClientCache, including synchronous and asynchronous
option factories, cache removal, and disposal. An id identifies one cached client within this
cache instance. Configure a given ID consistently: as with the underlying cache, the options
factory is used only when that client is first created.
Security behavior
- DNS is resolved when a connection is opened.
- Every resolved address must be publicly routable.
- The socket connects directly to the validated address set, preventing a second DNS lookup from changing the destination.
- Redirect destinations pass through the same connection validation.
- Loopback, private, link-local, carrier-grade NAT, documentation, benchmark, multicast, and reserved address ranges are blocked for IPv4 and IPv6.
- Proxies, custom
HttpClientHandlerinstances, and customSslOptionsare rejected because they expand or bypass the cache's controlled transport configuration.
Validation happens when a connection is opened, not when Get returns a client. A hostname that
resolves to any blocked address is rejected rather than falling back to another address. This
protects outbound connections; it does not impose an application-level allowlist for hosts or
paths.
The caller owns neither the returned HttpClient nor its handler. Use Remove/RemoveSync when a
cached client is no longer needed, or dispose the cache with its dependency-injection scope.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- Soenneker.Utils.HttpClientCache (>= 11.0.2139)
- Soenneker.Validators.IpAddresses.Ssrf (>= 11.0.39)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Soenneker.Utils.HttpClientCache.Ssrf:
| Package | Downloads |
|---|---|
|
Soenneker.N8n.HttpClients
Provides cached, authenticated HTTP clients for one or more n8n servers. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.0.120 | 104 | 11/19/2026 |
| 11.0.119 | 78 | 11/19/2026 |
| 11.0.118 | 53 | 11/18/2026 |
| 11.0.117 | 44 | 11/18/2026 |
| 11.0.116 | 46 | 11/18/2026 |
| 11.0.114 | 168 | 11/15/2026 |
| 11.0.113 | 115 | 11/15/2026 |
| 11.0.111 | 218 | 11/11/2026 |
| 11.0.109 | 117 | 11/11/2026 |
| 11.0.108 | 92 | 11/11/2026 |
| 11.0.107 | 181 | 11/3/2026 |
| 11.0.106 | 97 | 11/3/2026 |
| 11.0.105 | 104 | 11/3/2026 |
| 11.0.104 | 110 | 11/3/2026 |
| 11.0.103 | 113 | 10/27/2026 |
| 11.0.100 | 100 | 10/27/2026 |
| 11.0.94 | 100 | 10/26/2026 |
| 11.0.93 | 96 | 10/26/2026 |
| 11.0.92 | 101 | 10/26/2026 |
| 4.0.91 | 635 | 10/15/2026 |
Updated Multiple NuGet packages