Skip to content 
           █
 ▄▄▄  ▄▄▄  █  ▄▄▄
▀▄▄  █   █ █ █   █
▄▄▄▀ ▀▄▄▄▀ █ ▀▄▄▄▀

Configurazione Host e TLS

La gestione degli Host in Solo è una funzionalità avanzata che ti permette di definire regole di rete specifiche per determinati domini. È lo strumento indispensabile per lavorare in ambienti aziendali protetti, gestire certificati mTLS (Mutual TLS) o interagire con server che richiedono una Certification Authority (CA) privata.

Il pannello delle impostazioni Host di Solo con un host già configurato, che mostra i dettagli TLS e i cookie associati.

Quando Configurare un Host?

Section titled “Quando Configurare un Host?”

Dovresti creare una configurazione Host in Solo si ti trovi in uno di questi scenari:

  • Certificati Client: La tua API richiede un certificato (.crt) e una chiave privata (.key) per autenticare il tuo computer (mTLS).
  • CA Private: Lavori con server interni i cui certificati non sono riconosciuti dal tuo sistema operativo.
  • Sviluppo Locale: Hai bisogno di ignorare gli errori di sicurezza per un server con certificato auto-firmato.
  • Cookie Persistenti: Vuoi che Solo invii automaticamente determinati cookie a ogni richiesta verso un dominio specifico, senza doverli aggiungere manualmente ogni volta.

How it Works: L’Automazione di Rete

Section titled “How it Works: L’Automazione di Rete”

Una volta configurato un Host, Solo diventa “intelligente”:

  1. Rilevamento Automatico: Ogni volta che invii una richiesta, Solo controlla l’URL. Se corrisponde a un Host configurato, applica istantaneamente le regole salvate.
  2. Iniezione Trasparente: Il certificato client viene presentato al server durante l’handshake SSL, e i cookie vengono iniettati negli header HTTP senza che tu debba fare nulla.
  3. Isolamento: Le configurazioni sono specifiche per l’host. Le regole per api.sviluppo.local non influenzeranno mai le tue chiamate verso google.com.

Guida alla Configurazione TLS

Section titled “Guida alla Configurazione TLS”
  1. Aggiungi Host: Vai in Settings > Hosts e clicca su “Add Host”. Inserisci il dominio (es. api.azienda.it).
  2. Abilita TLS: Attiva il toggle “Enable Custom TLS Configuration”.
  3. Carica i File: Usa il pulsante “Browse” per selezionare il tuo certificato pubblico e la tua chiave privata dal disco. Il modulo di aggiunta host con la sezione TLS espansa e i percorsi dei file certificato (.crt) e chiave (.key) inseriti.
  4. CA Personalizzata: Se necessario, carica il file della tua CA Root per permettere a Solo di fidarsi del server.
  5. Salva: Clicca su “Save Host”. Tutte le richieste future verso quel dominio useranno ora questa configurazione sicura.

Specifiche della Configurazione

Section titled “Specifiche della Configurazione”
OpzioneDescrizioneUso Tipico
Insecure Skip VerifyIgnora la validazione del certificato del server.Ambiente di sviluppo locale.
Client CertificateFile .crt o .pem fornito dall’amministratore.Autenticazione mTLS.
Client KeyFile .key associato al certificato client.Autenticazione mTLS.
Root CAFile di certificato della Certification Authority.Server aziendali interni.
Host CookiesLista di chiavi e valori inviati automaticamente.Sessioni persistenti legacy.

Risoluzione Problemi (Failure Map)

Section titled “Risoluzione Problemi (Failure Map)”