verdaccio/website/translated_docs/it/packages.md

id	title
pacchetti	Accesso al pacchetto

È una serie di restrizioni che permettono o limitano l'accesso all'archiviazione locale basandosi su criteri specifici.

Le restrizioni di sicurezza dipendono dal plugin che si sta utilizzando, verdaccio usa di default il plugin htpasswd. Se si usa un plugin differente il funzionamento potrebbe essere diverso. Il plugin predefinito non gestisce direttamente allow_access e allow_publish, ma utilizza un'alternativa interna nel caso in cui il plugin non sia pronto per questo.

Per ulteriori informazioni sui permessi, visita la sezione autenticazione nella wiki.

Utilizzo

packages:
  # scoped packages
  '@scope/*':
    access: $all
    publish: $all
    proxy: server2

  'private-*':
    access: $all
    publish: $all
    proxy: uplink1

  '**':
    # allow all users (including non-authenticated users) to read and
    # publish all packages
    access: $all
    publish: $all
    proxy: uplink2

se non ne viene specificato nemmeno uno, rimane quello predefinito

packages:
  '**':
    access: $all
    publish: $authenticated

La lista di gruppi validi a seconda dei plugin predefiniti è

'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous'

Tutti gli utenti ricevono tutti questi gruppi di permessi indipendentemente dal fatto che siano anonimi o no, più i gruppi previsti dal plugin, nel caso htpasswd respinga lo username come un gruppo. Per esempio, se si è loggati come npmUser l'elenco dei nomi sarà.

// groups without '$' are going to be deprecated eventually
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous', 'npmUser'

Se si desidera proteggere un insieme specifico di pacchetti dentro al proprio gruppo, è necessario fare qualcosa simile a questo. Utilizziamo un Regex che copra tutti i pacchetti con prefisso npmuser-. Raccomandiamo di utilizzare un prefisso per i pacchetti, in modo che possa essere più semplice proteggerli.

packages:
  'npmuser-*':
    access: npmuser
    publish: npmuser

Riavviare verdaccio e provare ad installare npmuser-core nella console.

$ npm install npmuser-core
npm install npmuser-core
npm ERR! code E403
npm ERR! 403 Forbidden: npmuser-core@latest

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/user/.npm/_logs/2017-07-02T12_20_14_834Z-debug.log

È possibile modificare la condotta esistente utilizzando un plugin di autenticazione differente. verdaccio verifica semplicemente che l'utente che ha provato ad accedere o pubblicare un pacchetto specifico appartenga al gruppo corretto.

Definire gruppi multipli

Definire gruppi di accesso multipli è abbastanza facile, è sufficiente distinguerli semplicemente con uno spazio bianco tra di essi.

  'company-*':
    access: admin internal
    publish: admin
    proxy: server1
  'supersecret-*':
    access: secret super-secret-area ultra-secret-area
    publish: secret ultra-secret-area
    proxy: server1

Bloccare l'accesso a gruppi di pacchetti

Se si desidera bloccare l'accesso/pubblicazione ad uno specifico gruppo di pacchetti, è sufficiente non definire access e publish.

packages:
  'old-*':
  '**':
    access: $all
    publish: $authenticated

Bloccare l'inoltro di un gruppo di pacchetti specifici

Si potrebbe voler impedire che uno o vari pacchetti vengano raggiunti dai registri remoti, ma allo stesso tempo, permettere ad altri l'accesso a differenti uplink.

Vediamo l'esempio seguente:

packages:
  'jquery':
    access: $all
    publish: $all
  'my-company-*':
    access: $all
    publish: $authenticated
  '@my-local-scope/*':
    access: $all
    publish: $authenticated
  '**':
    access: $all
    publish: $authenticated
    proxy: npmjs

Descriviamo quello che si desidera con l'esempio precedente:

• Desidero ospitare la mia dipendenza jquery ma ho necessità di evitare il suo inoltro.
• Desidero tutte le dipendenze che coincidano con my-company-* ma ho necessità di evitare di inoltrarle.
• Desidero tutte le dipendenze che si trovino nell'ambito my-local-scope ma ho necessità di evitare di inoltrarle.
• Desidero l'inoltro per tutte le dipendenze rimanenti.

Non dimenticare l'importanza dell'ordine dei pacchetti e di utilizzare sempre il doppio asterisco. Poiché se non lo si include, verdaccio lo includerà per voi e questo inciderà sulla modalità con cui le dipendenze sono risolte.

Configurazione

Si possono definire pacchetti multipli ed ognuno di essi deve avere un Regex unico. La sintassi è basata su espressioni minimatch glob.

Proprietà	Tipo	Richiesto	Esempio	Supporto	Descrizione
accesso	stringa	No	$all	tutti	definisce i gruppi autorizzati ad accedere al pacchetto
pubblicazione	stringa	No	$authenticated	tutti	definisce i gruppi autorizzati a pubblicare
proxy	stringa	No	npmjs	tutti	limita le ricerche di un uplink specifico
archiviazione	variabile booleana	No	[vero/falso]	tutti	TODO

Vogliamo rimarcare che non raccomandiamo più l'utilizzo di allow_access/allow_publish e proxy_access che sono superati e saranno presto rimossi, si prega di utilizzare invece la versione breve di ognuna di queste (access/publish/proxy).