Implantar o Data API builder em ambientes isolados da internet

Este guia mostra como instalar e executar o DAB (Construtor de API de Dados) em ambientes sem acesso à Internet. Implantações isoladas da rede são comuns nos setores de saúde, defesa, finanças, energia e marítimo, nos quais a conectividade de saída com a rede é restrita ou proibida.

Pré-requisitos

  • Um computador com acesso à Internet para baixar pacotes (o computador de "preparo").
  • A máquina de destino isolada da rede com um sistema operacional compatível.
  • Um método para transferir arquivos entre computadores (unidade USB, transferência de arquivo aprovada etc.).

Etapa 1: Baixar pacotes no computador de preparo

Em um computador com acesso à Internet, baixe todos os pacotes necessários.

Baixar .NET runtime

Baixe o arquivo binário do .NET 9.0 ASP.NET Core para o sistema operacional de destino na página de download .NET. Escolha o arquivo binário ASP.NET Core Runtime (.tar.gz para Linux, .zip para Windows), não o instalador ou o SDK.

Importante

O DAB requer o runtime do ASP.NET Core, não apenas o runtime básico do .NET. Baixe o ASP.NET Core arquivo binário para que ele possa ser extraído sem um instalador.

Baixe o runtime do ASP.NET Core .zip na página de download do .NET 9.0. Selecione a coluna Binários para sua plataforma de destino (x64).

Baixar pacote do construtor de API de Dados

Use dotnet tool install com --tool-path para baixar o DAB e todas as suas dependências em um diretório portátil:

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

Esse comando cria um diretório de ferramentas autocontido com todos os arquivos necessários.

Etapa 2: Transfira arquivos para a máquina isolada da rede

Copie estes itens para o computador de destino:

  • O arquivo binário do ASP.NET Core Runtime (.zip ou .tar.gz)
  • O dab-tool diretório que contém a ferramenta DAB e todas as dependências

Etapa 3: Instale na máquina isolada da rede

Instalar .NET runtime

Extraia o arquivo binário de runtime. Nenhum instalador ou acesso à Internet é necessário.

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"

Instalar o construtor de API de Dados

O dab-tool diretório do computador de preparo já está autocontido. Adicione-o ao seu PATH:

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

Etapa 4: Configurar e executar

  1. Crie seu arquivo de configuração:

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

  2. Adicionar entidades:

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

  3. Inicie o DAB:

    dab start

Validar a instalação

Verifique se o DAB está em execução verificando o ponto de extremidade da API REST:

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

Para validar o servidor MCP, verifique se o endpoint de integridade responde:

curl http://localhost:5000/health

Dica

Para testar chamadas de ferramenta MCP, use o Inspetor MCP ou uma biblioteca de clientes MCP que manipula o handshake de inicialização completo do protocolo MCP.

Considerações sobre rede e firewall

  • O DAB escuta na porta 5000 por padrão. Ajuste com ASPNETCORE_URLS , se necessário.
  • Se estiver usando CORS, configure as origens permitidas em seu dab-config.json.
  • Nenhum acesso à Internet de saída é necessário no runtime. O DAB opera inteiramente em bancos de dados locais ou acessíveis à rede.

Conteúdo relacionado

  • Last updated on