Distribuisci Data API Builder in ambienti isolati dalla rete

Questa guida illustra come installare ed eseguire Data API Builder (DAB) in ambienti senza accesso a Internet. Le implementazioni isolate dalla rete sono comuni nei settori sanitario, della difesa, finanziario, energetico e marittimo, in cui la connettività di rete verso l’esterno è limitata o vietata.

Prerequisiti

  • Un computer con accesso a Internet per scaricare i pacchetti (il computer di gestione temporanea).
  • La macchina ad aria compressa di destinazione con un sistema operativo supportato.
  • Metodo per trasferire file tra computer (unità USB, trasferimento file approvato e così via).

Passaggio 1: Scaricare i pacchetti nel computer di gestione temporanea

In un computer con accesso a Internet scaricare tutti i pacchetti necessari.

Scarica .NET runtime

Scarica l'archivio binario del runtime ASP.NET Core .NET 9.0 per il sistema operativo di destinazione dalla pagina di download di .NET. Scegliere l'archivio binario ASP.NET Core Runtime (.tar.gz per Linux, .zip per Windows), non il programma di installazione o l'SDK.

Importante

DAB richiede il runtime di ASP.NET Core, non solo il runtime di base .NET. Scaricare l'archivio binario ASP.NET Core in modo che possa essere estratto senza un programma di installazione.

Scarica ASP.NET Core Runtime .zip dalla pagina di download di .NET 9.0. Seleziona la colonna Binaries per la piattaforma di destinazione (x64).

Scaricare il pacchetto di Generatore API dati

Usare dotnet tool install con --tool-path per scaricare DAB e tutte le relative dipendenze in una directory portabile:

dotnet tool install --tool-path ./dab-tool Microsoft.DataApiBuilder

Questo comando crea una directory degli strumenti autonoma con tutti i file necessari.

Passaggio 2: Trasferisci i file nella macchina isolata dalla rete

Copiare questi elementi nel computer di destinazione:

  • Archivio binario di ASP.NET Core Runtime (.zip o .tar.gz)
  • Directory dab-tool contenente lo strumento DAB e tutte le dipendenze

Passaggio 3: Installa sul sistema isolato dalla rete

Installare .NET runtime

Estrarre l'archivio binario di runtime. Non è necessario alcun programma di installazione o accesso a Internet.

Expand-Archive -Path "aspnetcore-runtime-9.0.x-win-x64.zip" -DestinationPath "C:\dotnet"
$env:DOTNET_ROOT = "C:\dotnet"
$env:PATH = "C:\dotnet;$env:PATH"

Installare Data API builder

La directory dab-tool della macchina di staging è già autosufficiente. Aggiungilo a PATH:

$env:PATH = "C:\path\to\dab-tool;$env:PATH"
dab --version

Passaggio 4: Configurare ed eseguire

  1. Creare il file di configurazione:

    dab init --database-type mssql --connection-string "Server=<server>;Database=<database>;User ID=<user>;Password=<password>;TrustServerCertificate=true"

  2. Aggiungere entità:

    dab add <entity-name> --source <schema>.<table> --permissions "anonymous:*"

  3. Avvia DAB:

    dab start

Convalidare l'installazione

Verificare che DAB sia in esecuzione controllando l'endpoint dell'API REST:

curl http://localhost:5000/api/<entity-name>

Per la validazione del server MCP, verificare che l'endpoint di stato risponda:

curl http://localhost:5000/health

Tip

Per testare le chiamate agli strumenti MCP, usare MCP Inspector o una libreria client MCP che gestisce l'handshake di inizializzazione completo del protocollo MCP.

Considerazioni sulla rete e sul firewall

  • DAB è in ascolto sulla porta 5000 per impostazione predefinita. Modificare con ASPNETCORE_URLS se necessario.
  • Se si utilizza CORS, configurare le origini consentite nel dab-config.json.
  • Non è necessario alcun accesso a Internet in uscita in fase di esecuzione. DAB opera interamente su database locali o accessibili dalla rete.

Contenuti correlati

  • Last updated on