Firewall e residenza dei dati.

DXPR Builder conserva le tue pagine nel tuo database Drupal. Contatta i servizi DXPR per controlli di licenza, asset dell’editor e richieste AI. Questa pagina elenca ogni connessione, cosa trasporta ciascuna, dove girano i modelli DXAI Kavya, come è conservata la chiave prodotto, e cosa funziona quando l’accesso in uscita è limitato.

Le connessioni in breve

Tutte le connessioni usano HTTPS sulla porta 443. I visitatori del sito non caricano mai niente dai server DXPR: le pagine pubblicate sono rese da HTML conservato nel database, e lo script frontend (dxpr_builder/dxpr_frontend.min.js) è incluso nel modulo. app.dxpr.com appare solo in link mostrati agli amministratori.

Controlli di licenza (dxpr.com)

Il server Drupal chiama quattro endpoint definiti in src/Service/DxprBuilderLicenseServiceInterface.php, ognuno con la chiave prodotto come header Authorization: Bearer.

Il contenuto delle pagine non fa mai parte di una richiesta di licenza. Il modulo stampa anche un <div> nascosto nella home page contenente una stringa marcatrice fissa, la fascia di licenza, il conteggio redattori e il conteggio salvataggi (dxpr_builder_page_bottom() in dxpr_builder.module). È leggibile nel sorgente della pagina.

Asset dell’editor (cdn2.dxpr.com, cdn.dxpr.com)

Quando Asset dell’editor è Cloud (il predefinito), il browser del redattore carica JavaScript e CSS del builder da https://cdn2.dxpr.com/<version>/, ripiegando su https://cdn.dxpr.com/<version>/ dopo una probe /health fallita. La chiave prodotto è aggiunta a ogni URL di asset come parametro di query jwt (dxpr_builder_library_info_build()). La CDN verifica quella chiave: una risposta 401 fa mostrare a js/editor_validation.js “La tua chiave prodotto non è valida”.

Le opzioni Locale (minificato) e Locale (non minificato) appaiono nel modulo delle impostazioni solo quando esiste una copia compilata dell’editor nella directory dxpr_builder/ del modulo, e tale copia viene usata in automatico anche quando è selezionato Cloud. Il repository git non traccia questi file compilati, quindi una release scaricata da drupal.org carica l’editor dalla CDN.

Richieste AI (kavya.dxpr.com)

Il browser non contatta mai kavya.dxpr.com. L’editor invia post a route sul tuo sito (/dxpr_builder/ajax/ai/chat, /dxpr_builder/ajax/ai/image, /dxpr_builder/ajax/ai/image/edit; tutte richiedono il permesso edit with dxpr builder, un token CSRF e un account con licenza). Il sito inoltra ogni richiesta tramite il provider DXPR del modulo AI di Drupal (ai_provider_dxpr) a https://kavya.dxpr.com/v1/chat/completions, /v1/images/generations o /v1/images/edits, con l’autenticazione della chiave API DXPR conservata nel modulo Key. L’impostazione host del provider (ai_provider_dxpr.settings) può puntare le richieste a un altro host. Separatamente, la pagina delle impostazioni AI chiama GET https://kavya.dxpr.com/v1/account/balance con la chiave prodotto per mostrare il tuo saldo crediti.

Cosa contiene una richiesta AI

Solo le funzioni AI mandano contenuti della pagina fuori dal sito, e solo quando un redattore le avvia (dxpr_builder/build/dxpr-global/ai-service.js).

Due comodità scaricano pagine web dal browser del redattore (ai-service-url-fetch.js): un URL in un prompt è richiesto con .md aggiunto e, se fallisce, tramite https://r.jina.ai/<url>, un servizio di lettura di terze parti non gestito da DXPR; un prompt che chiede di clonare una pagina invia l’URL a https://html-extract.dxpr.com/?url=.... In entrambi i casi viene inviato solo l’URL.

L’output AI è filtrato al ritorno. Domini permessi, tag bloccati e tag permessi si impostano in /admin/dxpr_studio/dxpr_builder/ai_settings sotto Filtro dell’output AI.

Dove girano i modelli DXAI Kavya

DXPR Builder offre tre modelli (src/Constants/AiModelConstants.php):

Non c’è un’impostazione di regione in nessuno dei due moduli. La residenza dei dati si sceglie per modello e per quali provider a monte abiliti:

• kavya-m1 commuta tra cinque provider, elencati con il loro paese nel modulo delle impostazioni del Provider AI DXPR: Anthropic (Stati Uniti), Google Gemini (Stati Uniti), MistralAI (Francia), OpenAI (Stati Uniti), XAI (Stati Uniti). In modalità Priorità manuale trascini i provider tra Abilitati e Disabilitati e ne imposti l’ordine.
• kavya-m1-eu usa solo MistralAI. Il README del Provider AI DXPR dichiara che “mantiene i dati entro i confini europei (server nei Paesi Bassi)”; la sua documentazione dichiara che il server Kavya gira nei Paesi Bassi con un backup in Germania, che le richieste passano dai server MistralAI in Francia, e che non ripiega mai su un provider fuori UE. Queste sedi sono documentate da DXPR, non imposte da niente nel codice Drupal.

Con ai_provider_dxpr installato, il modello si sceglie in /admin/config/ai/providers/dxpr, e la sua impostazione allowed_models controlla quali modelli i redattori possono scegliere. Senza di esso, modello e ordine dei provider si impostano in /admin/dxpr_studio/dxpr_builder/ai_settings.

Come è conservata la chiave prodotto

La sezione Licenza di /admin/dxpr_studio/dxpr_builder/settings offre due opzioni di Metodo di archiviazione (src/Form/DxprBuilderSettingsForm.php, src/Service/DxprBuilderKeyService.php):

• Modulo Key: la chiave è letta dall’entità Chiave scelta sotto Chiave. dxpr_builder_update_9020() sposta una chiave trovata in dxpr_builder.settings nell’entità Chiave dxpr_builder_jwt, il cui provider Configurazione la esporta comunque. Solo il provider File o Ambiente tiene la chiave fuori dalle esportazioni di configurazione.
• Archiviazione in configurazione: la chiave è salvata in testo in chiaro come dxpr_builder.settings.json_web_token ed è inclusa nelle esportazioni di configurazione.

La chiave prodotto è un JSON Web Token che autentica le chiamate di licenza, la chiamata di saldo crediti e gli URL di asset CDN; trattala come una credenziale.

Configurazione del firewall

Le analisi (dxpr_builder/build/dxpr-analytics/, PostHog) identificano gli eventi tramite l’indirizzo email del redattore e l’hostname del sito. Disattivale con drush config:set dxpr_builder.settings record_analytics 0; la chiave non ha un campo nel modulo. Altre due chiavi senza campo nel modulo sono lette da dxpr_builder.settings: cloud_url sostituisce l’URL base della CDN (VERSION è sostituito con la versione del modulo) e license_endpoint sostituisce l’endpoint centrale di archiviazione utenti. Impostale con un override di configurazione in settings.php.

Configurazione del proxy

Le chiamate di licenza e AI usano il client HTTP di Drupal, quindi un proxy si configura in 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'],
];

I browser dei redattori caricano gli asset CDN e chiamano i servizi di analisi e lettura direttamente, quindi quelle richieste seguono le impostazioni proxy della postazione.

Distribuzioni senza accesso alla rete e on-premise

DXPR Builder gira sul tuo server; nessun contenuto passa da un componente ospitato. Quando né il server né i redattori possono raggiungere DXPR:

Senza proprio una chiave prodotto, il modulo applica in codice i limiti del piano gratuito: un redattore e 100 elementi di contenuto.

Una distribuzione del tutto on-premise funziona quindi per distribuire e conservare contenuti; la modifica ha bisogno di accesso CDN o di una build locale dell’editor, e la convalida della licenza ha bisogno di dxpr.com. Contatta DXPR se ti serve una build dell’editor da ospitare internamente.

Passi successivi

• Installazione: configura la chiave prodotto e il metodo di archiviazione
• Funzioni AI: abilita l’AI e scegli un modello
• Sicurezza: permessi e filtro dell’output
• Licenza e chiave prodotto: risoluzione degli errori di licenza