hs-sql-agent

ASP.NET Core · NuGet

製品一式を組み込むなら Hosting、構成を選びたいなら Server。

HsSqlAgent.Hosting は公式 Docker イメージと同じ標準構成を .NET ホストへ組み込みます。既存の ASP.NET Core アプリが認証、ミドルウェア、管理 UI、テレメトリ、承認フローを自ら管理する場合は HsSqlAgent.Server を使います。

技術ドキュメントを読む GitHub
01

製品一式を組み込む

HsSqlAgent.Hosting は Docker と同じ第一方の標準構成と設定契約を提供します。

02

必要な機能だけ構成する

HsSqlAgent.Server では実行環境、永続化、MCP、管理 API、認証、テレメトリ、承認をホスト側で選べます。

03

ホストの境界を維持する

既存アプリの認証、認可、フロントエンド、例外処理、テレメトリ、ミドルウェア順序をそのまま管理できます。

3 つの利用方法

独立サービスなら公式 Docker イメージをデプロイします。.NET アプリに同じ製品一式を組み込むなら HsSqlAgent.Hosting、個別の機能を差し替えたり省いたりするなら HsSqlAgent.Server を使います。

  • 独立サービス：公式 Docker イメージ
  • 製品一式の組み込み：HsSqlAgent.Hosting
  • カスタム ASP.NET Core 統合：HsSqlAgent.Server
標準ホストを組み込む

            
              using HsSqlAgent.Hosting;

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

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

HsSqlAgent.Server で既存アプリの主導権を保つ

既存 API では AddHsSqlAgentCore() から始め、必要な機能だけ追加します。管理 API の認可は既存ホストのポリシーへ委譲でき、DML 承認プロバイダーも独立して差し替えられます。

モジュール式統合

            
              var hs = builder.Services.AddHsSqlAgentCore();

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

承認先に SQL 実行権限は渡さない

既定の第一方承認は MCP Elicitation です。標準 Hosting は設定で公式 Webhook アダプターを選択でき、モジュール式ホストは HsSqlAgent.Approvals.Webhook または独自の IDmlApprovalProvider を登録できます。SQL 検証、承認証跡の結び付け、コミット直前の再検証、原子的な実行は HsSqlAgent が担います。