hs-sql-agent

ASP.NET Core · NuGet

Hosting für das vollständige Produkt, Server für eine eigene Integration.

HsSqlAgent.Hosting bettet dieselbe Standardkomposition wie das offizielle Docker-Image in einen .NET-Host ein. Verwenden Sie HsSqlAgent.Server, wenn eine bestehende ASP.NET-Core-Anwendung Authentifizierung, Middleware, Admin-Oberfläche, Telemetrie oder Freigaben selbst steuern soll.

Technische Dokumentation lesen GitHub
01

Vollständiges Produkt einbetten

HsSqlAgent.Hosting bietet dieselbe offizielle Standardkomposition und denselben Konfigurationsvertrag wie Docker.

02

Eigene Integration

Mit HsSqlAgent.Server wählt der Host Runtime, Persistenz, MCP, Admin API, Identität, Telemetrie und Freigaben ausdrücklich selbst.

03

Host-Grenzen beibehalten

Die bestehende Anwendung behält Authentifizierung, Autorisierung, Frontend, Fehlerbehandlung, Telemetrie und Middleware-Reihenfolge.

Drei Nutzungswege

Für einen eigenständigen Dienst deployen Sie das offizielle Docker-Image. Soll eine .NET-Anwendung dieselbe vollständige Produktkomposition einbetten, verwenden Sie HsSqlAgent.Hosting. Wenn einzelne Funktionen ersetzt oder weggelassen werden sollen, verwenden Sie HsSqlAgent.Server.

  • Eigenständiger Dienst: offizielles Docker-Image
  • Vollständiges Produkt einbetten: HsSqlAgent.Hosting
  • Eigene ASP.NET-Core-Integration: HsSqlAgent.Server
Standard-Host einbetten

            
              using HsSqlAgent.Hosting;

var builder = WebApplication.CreateBuilder(args);
builder.AddHsSqlAgentStandardHost();

var app = builder.Build();
app.UseHsSqlAgentStandardHost();
await app.RunAsync();

Mit HsSqlAgent.Server die Kontrolle beim Host behalten

Eine bestehende API beginnt mit AddHsSqlAgentCore() und fügt nur die benötigten Funktionen hinzu. Admin-Autorisierung kann an eine vorhandene Host-Policy delegiert werden; auch der DML-Freigabe-Provider lässt sich unabhängig austauschen.

Modulare Integration

            
              var hs = builder.Services.AddHsSqlAgentCore();

hs.AddHsSqlAgentRuntime();
hs.AddHsSqlAgentAdminStore(options =>
{
    options.Provider = "Postgres";
    options.ConnectionString =
        builder.Configuration.GetConnectionString("HsSqlAgent")!;
});
hs.AddHsSqlAgentHostAuthorization("SqlAgentAdmin");
hs.AddHsSqlAgentAdminApi();

Das Freigabesystem erhält keine SQL-Ausführungsrechte

MCP Elicitation bleibt der offizielle Standard für Freigaben. Standard Hosting kann den offiziellen Webhook-Adapter per Konfiguration wählen; modulare Hosts können HsSqlAgent.Approvals.Webhook oder einen eigenen IDmlApprovalProvider registrieren. SQL-Validierung, Bindung der Freigabenachweise, erneute Prüfung vor dem Commit und atomare Ausführung bleiben bei HsSqlAgent.