Data API Builder implementeren in geïsoleerde omgevingen

Deze handleiding laat zien hoe u Data API Builder (DAB) installeert en uitvoert in omgevingen zonder internettoegang. Air-gapped implementaties zijn gebruikelijk in gezondheidszorg, defensie, financiën, energie en maritieme omgevingen waarbij uitgaande netwerkconnectiviteit beperkt of verboden is.

Prerequisites

  • Een computer met internettoegang om pakketten te downloaden (de 'staging'-machine).
  • De van netwerken geïsoleerde doelmachine met een ondersteund besturingssysteem.
  • Een methode voor het overdragen van bestanden tussen machines (USB-station, goedgekeurde bestandsoverdracht, enzovoort).

Stap 1: Pakketten downloaden op de staging-machine

Download alle vereiste pakketten op een computer met internettoegang.

.NET runtime downloaden

Download het binaire archief van .NET 9.0 ASP.NET Core runtime voor uw doelbesturingssysteem vanaf de downloadpagina .NET. Kies het binaire archief ASP.NET Core Runtime (.tar.gz voor Linux, .zip voor Windows), niet het installatieprogramma of de SDK.

Important

DAB vereist de ASP.NET Core runtime, niet alleen de basis-.NET runtime. Download het binaire ASP.NET Core archief, zodat het zonder installatieprogramma kan worden geëxtraheerd.

Download de ASP.NET Core-runtime .zip van de downloadpagina voor .NET 9.0. Selecteer de kolom Binaire bestanden voor uw doelplatform (x64).

Data API Builder-pakket downloaden

Gebruik dotnet tool install met --tool-path om DAB en alle afhankelijkheden te downloaden naar een portable map:

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

Met deze opdracht maakt u een map met zelfstandige hulpprogramma's met alle vereiste bestanden.

Stap 2: Zet bestanden over naar de geïsoleerde machine

Kopieer deze items naar de doelcomputer:

  • Het binaire ASP.NET Core Runtime-archief (.zip of .tar.gz)
  • De dab-tool map met het DAB-hulpprogramma en alle afhankelijkheden

Stap 3: Installeren op de air-gapped machine

.NET runtime installeren

Pak het binaire runtimearchief uit. Er is geen installatieprogramma of internettoegang vereist.

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"

Data API Builder installeren

De map dab-tool van de stagingmachine is al op zichzelf staand. Voeg het toe aan uw PATH:

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

Stap 4: Configureren en uitvoeren

  1. Maak uw configuratiebestand:

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

  2. Entiteiten toevoegen:

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

  3. DAB starten:

    dab start

De installatie valideren

Controleer of DAB wordt uitgevoerd door het REST API-eindpunt te controleren:

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

Controleer voor MCP-servervalidatie of het statuseindpunt reageert:

curl http://localhost:5000/health

Tip

Als u MCP-hulpprogrammaaanroepen wilt testen, gebruikt u MCP Inspector of een MCP-clientbibliotheek waarmee de volledige handshake van het MCP-protocol wordt verwerkt.

Overwegingen voor netwerk en firewall

  • DAB luistert standaard op poort 5000 . Pas met ASPNETCORE_URLS indien nodig aan.
  • Als u CORS gebruikt, configureer dan de toegestane herkomsten in uw dab-config.json.
  • Er is geen uitgaande internettoegang vereist tijdens runtime. DAB werkt volledig op basis van lokale of netwerk toegankelijke databases.

Verwante inhoud

  • Last updated on