hs-sql-agent

ASP.NET Core · NuGet

Hosting pour le produit complet ; Server pour une intégration sur mesure.

HsSqlAgent.Hosting intègre dans un hôte .NET la même composition standard que l'image Docker officielle. Utilisez HsSqlAgent.Server lorsqu'une application ASP.NET Core existante doit conserver la maîtrise de l'authentification, des middlewares, de l'interface d'administration, de la télémétrie ou des approbations.

Lire la documentation technique GitHub
01

Produit complet intégré

HsSqlAgent.Hosting fournit la même composition officielle et le même contrat de configuration standard que Docker.

02

Intégration sur mesure

HsSqlAgent.Server laisse l'hôte choisir explicitement l'exécution, la persistance, MCP, l'API d'administration, l'identité, la télémétrie et les approbations.

03

Frontières conservées par l'hôte

L'application existante peut garder son authentification, son autorisation, son interface, sa gestion des erreurs, sa télémétrie et l'ordre de ses middlewares.

Trois modes d'utilisation

Pour un service autonome, déployez l'image Docker officielle. Pour intégrer la même composition complète dans une application .NET, utilisez HsSqlAgent.Hosting. Pour remplacer ou omettre certaines capacités, utilisez HsSqlAgent.Server.

  • Service autonome : image Docker officielle
  • Produit complet intégré : HsSqlAgent.Hosting
  • Intégration ASP.NET Core sur mesure : HsSqlAgent.Server
Hôte standard intégré

            
              using HsSqlAgent.Hosting;

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

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

Conserver la maîtrise de l'application avec HsSqlAgent.Server

Dans une API existante, partez de AddHsSqlAgentCore() puis ajoutez uniquement les capacités nécessaires. L'autorisation d'administration peut être déléguée à une policy de l'hôte et le fournisseur d'approbation DML peut être remplacé indépendamment.

Intégration modulaire

            
              var hs = builder.Services.AddHsSqlAgentCore();

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

Le système d'approbation n'obtient pas le droit d'exécuter le SQL

MCP Elicitation reste le mécanisme d'approbation officiel par défaut. Le Hosting standard peut sélectionner l'adaptateur Webhook officiel par configuration ; un hôte modulaire peut enregistrer HsSqlAgent.Approvals.Webhook ou son propre IDmlApprovalProvider. HsSqlAgent conserve la validation SQL, la liaison des preuves d'approbation, la revalidation avant commit et l'exécution atomique.