Firewall e residência dos dados.

O DXPR Builder guarda as suas páginas na sua própria base de dados Drupal. Contacta os serviços DXPR para verificações de licença, recursos do editor e pedidos de IA. Esta página lista cada ligação, o que cada uma transporta, onde correm os modelos DXAI Kavya, como a chave de produto é guardada e o que funciona quando o acesso de saída é restrito.

Ligações em resumo

Todas as ligações usam HTTPS na porta 443. Os visitantes do site nunca carregam nada dos servidores DXPR: as páginas publicadas são apresentadas a partir de HTML guardado na base de dados, e o script público (dxpr_builder/dxpr_frontend.min.js) vem dentro do módulo. app.dxpr.com aparece só em ligações mostradas a administradores.

Verificações de licença (dxpr.com)

O servidor Drupal chama quatro endpoints definidos em src/Service/DxprBuilderLicenseServiceInterface.php, cada um com a chave de produto como cabeçalho Authorization: Bearer.

O conteúdo das páginas nunca faz parte de um pedido de licença. O módulo também imprime um <div> oculto na página inicial com uma cadeia marcadora fixa, o escalão de licença, a contagem de editores e a contagem de gravações (dxpr_builder_page_bottom() em dxpr_builder.module). É legível no fonte da página.

Recursos do editor (cdn2.dxpr.com, cdn.dxpr.com)

Quando Editor Assets está em Cloud (a predefinição), o navegador do editor carrega o JavaScript e CSS do construtor de https://cdn2.dxpr.com/<version>/, com recurso a https://cdn.dxpr.com/<version>/ após uma sonda /health falhada. A chave de produto é anexada a cada URL de recurso como parâmetro de consulta jwt (dxpr_builder_library_info_build()). A CDN verifica essa chave: uma resposta 401 faz js/editor_validation.js mostrar "Your product key is not valid".

As opções Local (minified) e Local (unminified) só aparecem no formulário de definições quando existe uma cópia compilada do editor no diretório dxpr_builder/ do módulo, e tal cópia é usada automaticamente mesmo quando Cloud está selecionado. O repositório git não acompanha estes ficheiros compilados, por isso uma versão descarregada de drupal.org carrega o editor a partir da CDN.

Pedidos de IA (kavya.dxpr.com)

O navegador nunca contacta kavya.dxpr.com. O editor publica para rotas no seu próprio site (/dxpr_builder/ajax/ai/chat, /dxpr_builder/ajax/ai/image, /dxpr_builder/ajax/ai/image/edit; todas exigem a permissão edit with dxpr builder, um token CSRF e uma conta licenciada). O site retransmite cada pedido através do fornecedor DXPR do módulo Drupal AI (ai_provider_dxpr) para https://kavya.dxpr.com/v1/chat/completions, /v1/images/generations ou /v1/images/edits, autenticado com a chave de API DXPR guardada no módulo Key. A definição host do fornecedor (ai_provider_dxpr.settings) pode apontar os pedidos para outro anfitrião. Separadamente, a página de definições de IA chama GET https://kavya.dxpr.com/v1/account/balance com a chave de produto para mostrar o seu saldo de créditos.

O que um pedido de IA contém

Só as funcionalidades de IA enviam conteúdo da página para fora do site, e só quando um editor as aciona (dxpr_builder/build/dxpr-global/ai-service.js).

Duas conveniências obtêm páginas web do navegador do editor (ai-service-url-fetch.js): um URL numa pergunta é pedido com .md anexado e, se isso falhar, através de https://r.jina.ai/<url>, um serviço de leitura de terceiros não operado pela DXPR; uma pergunta que pede para clonar uma página envia o URL para https://html-extract.dxpr.com/?url=.... Em ambos os casos só o URL é enviado.

A saída da IA é filtrada no regresso. Domínios permitidos, etiquetas bloqueadas e etiquetas permitidas definem-se em /admin/dxpr_studio/dxpr_builder/ai_settings em AI Output Filtering.

Onde correm os modelos DXAI Kavya

O DXPR Builder oferece três modelos (src/Constants/AiModelConstants.php):

Não há definição de região em nenhum módulo. A residência dos dados é escolhida pelo modelo e pelos fornecedores a montante que ativar:

• kavya-m1 alterna entre cinco fornecedores, listados com o país no formulário de definições DXPR AI Provider: Anthropic (United States), Google Gemini (United States), MistralAI (France), OpenAI (United States), XAI (United States). No modo Manual priority arrasta fornecedores entre Enabled e Disabled e define a ordem.
• kavya-m1-eu usa só MistralAI. O README do DXPR AI Provider afirma que "keeps data within European boundaries (servers in Netherlands)"; a documentação afirma que o servidor Kavya corre nos Países Baixos com cópia de segurança na Alemanha, que os pedidos passam por servidores MistralAI em França, e que nunca recorre a um fornecedor fora da UE. Estas localizações são documentadas pela DXPR, não impostas por nada no código Drupal.

Com ai_provider_dxpr instalado, o modelo é escolhido em /admin/config/ai/providers/dxpr, e a sua definição allowed_models controla que modelos os editores podem escolher. Sem ele, modelo e ordem de fornecedores definem-se em /admin/dxpr_studio/dxpr_builder/ai_settings.

Como a chave de produto é guardada

A secção License de /admin/dxpr_studio/dxpr_builder/settings oferece duas opções de Storage method (src/Form/DxprBuilderSettingsForm.php, src/Service/DxprBuilderKeyService.php):

• Key module: a chave é lida da entidade Key escolhida em Key. dxpr_builder_update_9020() move uma chave encontrada em dxpr_builder.settings para a entidade Key dxpr_builder_jwt, cujo fornecedor Configuration ainda a exporta. Só o fornecedor File ou Environment mantém a chave fora das exportações de configuração.
• Configuration storage: a chave é guardada em texto claro como dxpr_builder.settings.json_web_token e é incluída nas exportações de configuração.

A chave de produto é um JSON Web Token que autentica chamadas de licença, a chamada de saldo de créditos e os URLs de recursos da CDN; trate-a como credencial.

Configuração de firewall

Análise (dxpr_builder/build/dxpr-analytics/, PostHog) identifica eventos pelo endereço de e-mail do editor e o nome de anfitrião do site. Desligue-a com drush config:set dxpr_builder.settings record_analytics 0; a chave não tem campo de formulário. Mais duas chaves sem campo de formulário são lidas de dxpr_builder.settings: cloud_url substitui o URL base da CDN (VERSION é substituído pela versão do módulo) e license_endpoint substitui o endpoint central de armazenamento de utilizadores. Defina-as com uma substituição de configuração em settings.php.

Configuração de proxy

Chamadas de licença e IA usam o cliente HTTP do Drupal, por isso um proxy configura-se em settings.php:

$settings['http_client_config']['proxy'] = [
  'http' => 'http://proxy.example.com:8080',
  'https' => 'http://proxy.example.com:8080',
  'no' => ['localhost', '127.0.0.1'],
];

Os navegadores dos editores carregam os recursos da CDN e chamam os serviços de análise e leitura diretamente, por isso esses pedidos seguem as definições de proxy da estação de trabalho.

Implementações isoladas e no local

O DXPR Builder corre no seu próprio servidor; nenhum conteúdo passa por um componente alojado. Quando nem o servidor nem os editores alcançam a DXPR:

Sem qualquer chave de produto, o módulo aplica os limites do escalão gratuito no código: um editor e 100 itens de conteúdo.

Uma implementação totalmente no local funciona portanto para apresentar e guardar conteúdo; a edição precisa de acesso à CDN ou de uma compilação local do editor, e a validação de licença precisa de dxpr.com. Contacte a DXPR se precisar de uma compilação do editor para alojar internamente.

E a seguir?

• Instale o DXPR Builder no seu site Drupal: configure a chave de produto e o método de armazenamento
• AI features: ative a IA e escolha um modelo
• Security: permissões e filtragem de saída
• Licence and product key: resolução de erros de licença