Eseguire in locale ★Data Center

Il Babel Licensing Service decifra gli script dell’applicazione web in memoria in fase di esecuzione, e solo quando la sua licenza include la funzionalità dell’applicazione web. Copiare i file dalla cartella wwwroot del servizio su un altro server web, per esempio un container nginx, non produce un’applicazione web funzionante.

Gestire un servizio remoto

Per consultare un Babel Licensing Service remoto dal tuo computer locale, installa Babel Desktop e aggiungi una connessione Licensing all’indirizzo del servizio con una chiave API. Babel Desktop funziona sia con l’edizione Server sia con l’edizione Data Center, ma i profili dei servizi remoti sono in sola lettura: per creare, modificare ed eliminare i record serve un profilo Test locale con Gestione locale, cioè Babel Desktop in esecuzione sul computer del servizio. Per modificare i dati di un servizio remoto, usa la Management API.

Se il servizio remoto esegue l’edizione Data Center, puoi anche aprire l’applicazione web direttamente in un browser all’indirizzo del servizio.

Eseguire il servizio solo come API

Per eseguire il servizio solo come API, senza servire l’applicazione web, imposta EnableWebUI su false nel file appsettings.json:

"Application": {
  "EnableWebApi": true,
  "EnableWebUI": false
}

Con EnableWebUI impostato su false il servizio non serve i file dell’applicazione web. L’API REST, gRPC e, quando sono abilitati, Swagger e l’endpoint del controllo di stato restano disponibili, quindi Babel Desktop e gli altri client dell’API continuano a funzionare.

Generazione della chiave API

La chiave API deve essere generata sul Babel Licensing Service remoto. Per generare una chiave API:

1. Apri l’applicazione web o Babel Desktop
2. Vai alla sezione “API Keys”
3. Crea una nuova chiave API con i permessi adeguati
4. Copia la chiave generata per usarla nella configurazione del tuo client

Assicurati che la chiave API abbia permessi sufficienti per eseguire le operazioni che ti servono.

Risoluzione dei problemi

Se riscontri problemi di connessione al servizio remoto:

1. Controlla la connettività di rete: verifica che il tuo computer locale riesca a raggiungere il server remoto (prova con ping o strumenti simili)
2. Convalida la chiave API: assicurati che la chiave API sia valida e abbia i permessi necessari
3. Controlla SSL/TLS: se usi HTTPS, verifica che il certificato SSL sia valido e attendibile
4. Impostazioni del firewall: assicurati che il firewall consenta le connessioni in uscita verso la porta del servizio remoto
5. Controlla lo stato del servizio: usa l’endpoint del controllo di stato (/health) del servizio remoto per verificare che sia operativo
6. Controlla l’edizione: se il browser mostra la pagina di upgrade al posto dell’applicazione web, la licenza del servizio non include la funzionalità dell’applicazione web. Sostituisci babel.licenses con una licenza Data Center e riavvia il servizio.

Considerazioni sulla sicurezza

Quando ti connetti a un servizio di licenze remoto, tieni presenti queste procedure consigliate per la sicurezza:

1. Usa HTTPS per una comunicazione sicura
2. Sostituisci periodicamente le chiavi API
3. Applica il principio del privilegio minimo quando assegni i permessi alle chiavi API
4. Non eseguire il commit di file di configurazione che contengono chiavi API nel controllo del codice sorgente