hs-sql-agent
2.0.3
Documentation 2.0.3
Version de la documentation
2.0.3 Actuelle
2.0.2 Prise en charge 2.0.3 Actuelle
Documentation Administration

Vue d’ensemble du panneau d’administration

Le plan de contrôle opérateur pour l’accès aux bases de données, les identifiants MCP, l’identité, l’autorisation, l’audit, les politiques de sécurité et l’exploitation du runtime.

Le panneau d’administration est le plan de contrôle opérateur de hs-sql-agent. Les opérateurs définissent ce qu’un client MCP peut atteindre et la manière dont SQL est gouverné ; les clients MCP utilisent ensuite l’endpoint /mcp, authentifié séparément.

Database Management Enregistrer les connexions aux moteurs, vérifier la connectivité et contrôler la base à laquelle une clé MCP peut être liée.
MCP Keys Émettre, renouveler, révoquer et restreindre les identifiants MCP, puis générer leur configuration client.
Semantic Metadata Ajouter des noms lisibles, descriptions, synonymes, relations et métriques à la découverte de schéma.
Custom Tools Publier des opérations SQL gouvernées comme outils MCP nommés sans contourner la politique d’exécution.
Sécurité Comprendre l’authentification, l’autorisation, les périmètres de tables/outils, la politique SQL par refus par défaut et les frontières d’audit.
Exploitation Configurer le déploiement, l’état partagé, l’observabilité, la rétention, les limites et le comportement du runtime en production.

Identité, gouvernance et exploitation

Members & Roles Créer des membres Admin, attribuer des rôles, révoquer des sessions et gérer le cycle de vie des rôles en sécurité.
Permissions Comprendre le modèle chemin de permission + action appliqué par les contrôleurs Admin.
Audit Rechercher, agréger, exporter et appliquer la rétention aux enregistrements d’audit runtime et sécurité.
Security Policies Gérer les limites de requête, DML, débit par clé et concurrence SQL.
Operability Inspecter les métriques d’exécution, la santé des bases, l’usage des clés et l’état des livraisons sortantes.
Admin HTTP API Consulter les routes 2.0.2/2.0.2 issues du code source et la surface d’autorisation utilisée par l’interface intégrée.

Parcours opérateur recommandé

01 Enregistrer la base
02 Émettre une clé MCP
03 Définir le périmètre outils/tables
04 Enrichir les métadonnées
05 Connecter le client
06 Observer et auditer
  1. Enregistrez et vérifiez la connexion à la base que l’agent doit exposer.
  2. Émettez une clé MCP liée à cette base et n’accordez que les outils/tables nécessaires au client.
  3. Ajoutez des métadonnées sémantiques lorsque les noms physiques ne suffisent pas à une découverte fiable par l’agent.
  4. Générez la configuration cliente et connectez-vous via l’endpoint Streamable HTTP public /mcp.
  5. Utilisez les surfaces d’audit et d’exploitation pour observer le runtime et resserrer la politique si nécessaire.

Cycle de vie des clés MCP

Lorsqu’une clé est émise, renouvelée ou dupliquée, l’interface peut générer directement une configuration Streamable HTTP pour les formats clients pris en charge. Le secret en clair n’est affiché que dans cette boîte de dialogue de cycle de vie et n’est pas conservé pour affichage ultérieur.

Copiez la configuration générée avant de fermer la boîte de dialogue.

L’interface intégrée et l’identité intégrée sont facultatives

Un hôte ASP.NET Core peut exposer l’API Admin HsSqlAgent sans servir l’interface Admin empaquetée. Dans le mode d’intégration modulaire, utilisez UseHsSqlAgentAdminApi() et laissez l’hôte appeler MapControllers() ; ajoutez UseHsSqlAgentAdminUi() uniquement si l’interface intégrée est souhaitée.

L’hôte peut aussi utiliser AddHsSqlAgentHostAuthorization(...) pour conserver son système existant de connexion et de permissions au lieu d’installer les membres, rôles, JWT, SMTP ou OIDC HsSqlAgent. MCP est choisi et mappé indépendamment avec AddHsSqlAgentMcp(...) / UseHsSqlAgentMcp().

Consultez Intégration ASP.NET Core pour le modèle de composition complet de la version 2.0.2.