ConduitSharp.Gateway.AspNetCore
2.0.0
dotnet add package ConduitSharp.Gateway.AspNetCore --version 2.0.0
NuGet\Install-Package ConduitSharp.Gateway.AspNetCore -Version 2.0.0
<PackageReference Include="ConduitSharp.Gateway.AspNetCore" Version="2.0.0" />
<PackageVersion Include="ConduitSharp.Gateway.AspNetCore" Version="2.0.0" />
<PackageReference Include="ConduitSharp.Gateway.AspNetCore" />
paket add ConduitSharp.Gateway.AspNetCore --version 2.0.0
#r "nuget: ConduitSharp.Gateway.AspNetCore, 2.0.0"
#:package ConduitSharp.Gateway.AspNetCore@2.0.0
#addin nuget:?package=ConduitSharp.Gateway.AspNetCore&version=2.0.0
#tool nuget:?package=ConduitSharp.Gateway.AspNetCore&version=2.0.0
ConduitSharp.Gateway.AspNetCore
Embed the ConduitSharp API gateway inside your own ASP.NET Core application.
Usage
Add to your ASP.NET Core host:
builder.Services.AddConduitSharpGateway(opts =>
{
opts.ConfigPath = "conduit-routes.json";
opts.PluginPath = "./plugins";
});
var app = builder.Build();
app.MapConduitSharpGateway();
app.Run();
Routes are defined in JSON:
{
"routes": [
{
"path": "/api/users",
"methods": ["GET"],
"upstream": "http://backend:3000",
"plugins": ["my-plugin", "auth"]
}
]
}
Forwarding is built on YARP, so HTTP/2, gRPC, WebSockets, and streaming bodies pass through natively via the http-proxy plugin.
Plugin System
Plugins run per-route to inspect, transform, or filter requests/responses. Drop a compiled plugin assembly into your plugins/ folder and reference it in route config — no restart required.
Build plugins with ConduitSharp.Core.
Drop-in Plugin Packages
The NuGet ecosystem provides ready-to-use plugins:
- ConduitSharp.Cache.RedisProtocol — Redis-backed response cache
- ConduitSharp.RateLimit.RedisProtocol — Redis-backed rate limiter
Observability
Structured logging, distributed traces (OpenTelemetry), and Prometheus metrics are built in. Wire them into your observability stack:
builder.Services
.AddLogging(l => l.AddOpenTelemetry())
.AddOpenTelemetry()
.WithTracing(t => t.AddConduitSharpInstrumentation());
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- ConduitSharp.Core (>= 2.0.0)
- ConduitSharp.Observability (>= 2.0.0)
- ConduitSharp.Security (>= 2.0.0)
- ConduitSharp.Traffic (>= 2.0.0)
- ConduitSharp.Transformation (>= 2.0.0)
- OpenTelemetry.Exporter.Console (>= 1.16.0)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.16.0)
- OpenTelemetry.Extensions.Hosting (>= 1.16.0)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.15.2)
- OpenTelemetry.Instrumentation.Http (>= 1.15.1)
- Polly.Core (>= 8.7.0)
- Yarp.ReverseProxy (>= 2.3.0)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on ConduitSharp.Gateway.AspNetCore:
| Package | Downloads |
|---|---|
|
ConduitSharp.RateLimit.RedisProtocol
Distributed rate-limit store (IRateLimitStore) for ConduitSharp over the Redis protocol (RESP) — works with Valkey, Redis 7, and any RESP-compatible server. Shares fixed-window counters across gateway replicas instead of each instance counting independently. Fails open: a backend outage degrades to allowing requests rather than taking down the gateway. |
|
|
ConduitSharp.Cache.RedisProtocol
Drop-in distributed response cache (ICacheService) for ConduitSharp over the Redis protocol — works with Valkey, Redis 7, and any RESP-compatible server. Shared across gateway instances, with request coalescing and route invalidation. Fails open: a backend outage degrades to no-cache rather than taking down the gateway. |
|
|
ConduitSharp.Gateway.AspNetCore.Swagger
Aggregated Swagger UI add-on for ConduitSharp.Gateway.AspNetCore — call UseConduitSharpGatewaySwagger() to serve one Swagger UI built from every route's OpenAPI spec. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.0 | 150 | 8/14/2026 |
| 1.0.0 | 142 | 7/25/2026 |
| 1.0.0-rc.1 | 74 | 7/18/2026 |