Configurazione Web Server Banana (macOS)

La guida seguente ti mostra passo per passo come configurare correttamente il Web Server Banana su macOS.

1. Avvia il Web Server Banana

• Apri Banana Contabilità Plus.
• Dal menu Strumenti > Opzioni programma.
• Seleziona la sezione Generale.
• Spunta l'opzione Avvia Web Server e anche Avvia Web Server con ssl.
  In macOS si deve usare l'SSL https://127.0.0.1:8089,+non il localhost.
  
  
   

2. Modifica il file di configurazione del Web Server Banana (file httpconfig.ini)

• Dal menu Strumenti > Opzioni programma.
• Seleziona la sezione Avanzato.
• Clicca su Info sistema.
  
  
   
• Seleziona la voce Web Server > Settings file path
• Clicca su Apri percorso...
  
  
   
• Apri il file httpconfig.ini
  • Tasto destro del mouse > Apri con > TextEdit.
• Nel file cerca le seguenti proprietà e modificale come indicato:
  • accessControlAllowOrigin
    Modifica il valore della proprietà accessControlAllowOrigin con "*" (accessControlAllowOrigin=*)
  • accessToken
    Modifica il valore della proprietà accessToken con una password di sicurezza di tua scelta (es. "accessToken=MyPasswordX" )
    Serve per avere maggiore sicurezza quando si utiliizza il Web Server Banana. Per maggiori informazioni vedi Web Server Security (solo inglese).
    
    
     
• Salva e chiudi il file.
• Riavvia Banana Contabilità Plus.

3. Usa un certificato SSL autofirmato 

Crea un certificato con il Terminale di macOS e utilizzalo con il Web Server di Banana.

a) Rimuovi il certificato banana.localhost esistente (se presente)

• Chiudi Banana Contabilità Plus.
• Apri l'applicazione Accesso Portachiavi di macOS (Applicazioni > Utility).
• Seleziona la scheda Certificati e cercare banana.
  
  
   
• Clicca con il tasto destro sul certificato banana.localhost e seleziona Elimina "banana.localhost".
• Conferma con Elimina e, se richiesto, inserire la password di sistema.
• Chiudi l'applicazione Accesso Portachiavi.

b) Avvia i web server di Banana Contabilità Plus

• Apri Banana Contabilità Plus.
• Clicca sul menu Strumenti > Opzioni programma.
• Seleziona la scheda Generale.
• Attiva le opzioni Avvia Web Server e Avvia Web Server con ssl.
  Su macOS devi usare l'indirizzo SSL https://127.0.0.1:8089,+non localhost.
• Chiudi Banana Contabilità Plus.

c) Crea il certificato

• Apri l'applicazione Terminale di macOS (Applicazioni > Utility).
• Copia e incolla i seguenti comandi e premi Invio:

mkdir -p ~/banana-cert && cd ~/banana-cert

openssl req -x509 -newkey rsa:2048 -nodes -sha256 -days 825 \
  -keyout mybanana.key -out mybanana.pem \
  -subj "/CN=Banana Local Web Server" \
  -addext "subjectAltName=DNS:banana.localhost,DNS:localhost,IP:127.0.0.1" \
  -addext "extendedKeyUsage=serverAuth"

Nella cartella banana-cert della directory utente vengono creati due file:

• mybanana.pem: il certificato.
• mybanana.key: la chiave privata.

d) Rendi il certificato attendibile

• Nel Terminale, esegui il seguente comando:

sudo security add-trusted-cert -d -r trustRoot -p ssl \
  -k /Library/Keychains/System.keychain mybanana.pem

• Inserisci la password di sistema quando richiesta.

Il certificato viene aggiunto al portachiavi Sistema e contrassegnato come attendibile per SSL.

e) Copia il certificato nella cartella Ssl di Banana

• Nel Terminale, esegui i seguenti comandi per creare la cartella Ssl e copiarvi i file del certificato:

mkdir -p "$HOME/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl"
cp mybanana.pem mybanana.key "$HOME/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl/"
chmod 600 "$HOME/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl/mybanana.key"

Il comando chmod fa sì che la chiave privata sia leggibile solo dal proprio utente.

La cartella banana-cert non è più necessaria e può essere eliminata.

f) Modifica il file di configurazione del web server di BananaPlus (httpconfig.ini)

• Apri Banana Contabilità Plus.
• Clicca sul menu Strumenti > Opzioni programma.
• Seleziona la scheda Avanzate.
• Clicca sul pulsante Info sistema.
• Seleziona la voce Web Server > Settings file path.
• Clicca sul pulsante Apri percorso.
• Apri il file httpconfig.ini
  Tasto destro > Apri con > Altro... > selezionare TextEdit.
• Nel file cercare le proprietà sslCertFile e sslKeyFile nella sezione [Https].
  Inserisci il percorso dei file del certificato.
  Sostituisci username con il nome utente macOS.

[Https]
sslCertFile=/Users/username/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl/mybanana.pem
sslKeyFile=/Users/username/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl/mybanana.key

• Salva e chiudi il file.
• Riavvia Banana Contabilità Plus.

g) Verifica la connessione

• Apri Safari e inserisci l'indirizzo https://127.0.0.1:8089. 
• La pagina deve aprirsi senza avvisi di sicurezza.

Validità del certificato

Il certificato è valido 825 giorni, il massimo accettato da macOS.

Alla scadenza, rimuovi il vecchio certificato (vedi sotto) e crearne uno nuovo.

Rimuovi il certificato personale

• Nel Terminale, esegui i seguenti comandi:

sudo security delete-certificate -c "Banana Local Web Server" /Library/Keychains/System.keychain
rm -r "$HOME/Library/Application Support/Banana.ch/BananaPlus/10.0/Ssl"

• Riavvia Banana Contabilità Plus.