Implementar el generador de API de datos en entornos aislados de la red

En esta guía se muestra cómo instalar y ejecutar Data API Builder (DAB) en entornos sin acceso a Internet. Las implementaciones aisladas son comunes en los sectores sanitario, de defensa, financiero, energético y marítimo, donde la conectividad de red hacia el exterior está restringida o prohibida.

Prerequisites

  • Una máquina con acceso a Internet para descargar paquetes (la máquina de "ensayo").
  • La máquina de destino aislada de la red con un sistema operativo compatible.
  • Método para transferir archivos entre máquinas (unidad USB, transferencia de archivos aprobada, etc.).

Paso 1: Descargar paquetes en la máquina de ensayo

En una máquina con acceso a Internet, descargue todos los paquetes necesarios.

Descarga del entorno de ejecución de .NET

Descargue el archivo binario del entorno de ejecución de ASP.NET Core de .NET 9.0 para su sistema operativo de destino desde la página de descargas de .NET. Elija el archivo binario ASP.NET Core Runtime (.tar.gz para Linux, .zip para Windows), no el instalador ni el SDK.

Importante

DAB requiere el entorno de ejecución de ASP.NET Core, no solo el entorno de ejecución de .NET base. Descargue el ASP.NET Core archivo binario para que se pueda extraer sin un instalador.

Descargue el entorno de ejecución de ASP.NET Core .zip desde la página de descarga de .NET 9.0. Seleccione la columna Binarios para la plataforma de destino (x64).

Descarga del paquete del generador de API de datos

Use dotnet tool install con --tool-path para descargar DAB y todas sus dependencias en un directorio portátil:

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

Este comando crea un directorio de herramientas independiente con todos los archivos necesarios.

Paso 2: Transfiera los archivos a la máquina aislada de la red

Copie estos elementos en la máquina de destino:

  • Archivo binario de ASP.NET Core runtime (.zip o .tar.gz)
  • Directorio dab-tool que contiene la herramienta DAB y todas las dependencias

Paso 3: Instalar en la máquina aislada de la red

Instalación del entorno de ejecución de .NET

Extraiga el archivo binario de ejecución. No se requiere ningún instalador ni acceso 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"

Instalación de Data API Builder

El directorio dab-tool de la máquina de ensayo ya es autocontenido. Agréguelo a PATH:

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

Paso 4: Configurar y ejecutar

  1. Cree el archivo de configuración:

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

  2. Agregar entidades:

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

  3. Inicie DAB:

    dab start

Validar la instalación

Compruebe que DAB se está ejecutando comprobando el punto de conexión de la API REST:

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

Para la validación del servidor MCP, compruebe que el punto de conexión de mantenimiento responde:

curl http://localhost:5000/health

Sugerencia

Para probar las llamadas a herramientas de MCP, use MCP Inspector o una biblioteca cliente de MCP que gestione todo el proceso de negociación de inicialización del protocolo MCP.

Consideraciones de red y firewall

  • DAB escucha en el puerto 5000 de forma predeterminada. Ajuste con ASPNETCORE_URLS si es necesario.
  • Si usa CORS, configure los orígenes permitidos en dab-config.json.
  • No se requiere acceso saliente a Internet en tiempo de ejecución. DAB funciona completamente con bases de datos locales o accesibles a la red.

Contenido relacionado

  • Last updated on