Salta al contenuto principale

Configurare i Certificati SSL

Segui queste istruzioni per configurare un certificato SSL per servire un registro npm via HTTPS.

  • Aggiorna la proprietà d'ascolto in ~/.config/verdaccio/config.yaml:
listen: 'https://your.domain.com/'

Una volta aggiornata la proprietà d'ascolto e provato a eseguire nuovamente Verdaccio, chiederà i certificati.

  • Genera i tuoi certificati
 $ openssl genrsa -out /Users/user/.config/verdaccio/verdaccio-key.pem 2048
$ openssl req -new -sha256 -key /Users/user/.config/verdaccio/verdaccio-key.pem -out /Users/user/.config/verdaccio/verdaccio-csr.pem
$ openssl x509 -req -in /Users/user/.config/verdaccio/verdaccio-csr.pem -signkey /Users/user/.config/verdaccio/verdaccio-key.pem -out /Users/user/.config/verdaccio/verdaccio-cert.pem
  • Modifica il tuo file di configurazione /Users/user/.config/verdaccio/config.yaml e aggiungi la seguente sezione:
https:
key: /Users/user/.config/verdaccio/verdaccio-key.pem
cert: /Users/user/.config/verdaccio/verdaccio-cert.pem
ca: /Users/user/.config/verdaccio/verdaccio-csr.pem

Altrimenti, se hai un certificato con il formato server.pfx, puoi aggiungere la seguente sezione di configurazione: (La parola in codice è facoltativa e necessaria solo se il tuo certificato è crittografato.)

https:
pfx: /Users/user/.config/verdaccio/server.pfx
passphrase: 'secret'

Puoi trovare altre info sugli argomenti key, cert, ca, pfx e passphrase nella documentazione di Node

  • Esegui Verdaccio nella tua riga di comando.

  • Apri il browser e visita https://your.domain.com:port/A

Queste istruzioni sono prevalentemente valide sotto OSX e Linux; su Windows i percorsi varieranno, ma i passaggi sono gli stessi.

Docker

Se stai usando l'immagine del Docker, devi impostare la variabile ambientale VERDACCIO_PROTOCOL a https, poiché l'argomento listen è fornito nel Dockerfile e dunque ignorato dal tuo file di configurazione.

Puoi anche impostare la variabile ambientale VERDACCIO_PORT se stai usando una porta diversa da 4873.