verdaccio/website/translated_docs/it/plugins.md

id	title
plugin	Plugin

Verdaccio è un'applicazione estensibile. Si può espandere in molti modi, o con nuovi metodi di autenticazione, aggiungendo endpoint o utilizzando un archivio personalizzato.

Se sei interessato a sviluppare il tuo plugin personale, leggi la sezione sviluppo.

Utilizzo

Installazione

$> npm install --global verdaccio-activedirectory

verdaccio essendo un fork di sinopia, ha compatibilità con le versioni precedenti e con plugin che sono compatibili con sinopia@1.4.0. In questo caso l'installazione è la stessa.

$> npm install --global sinopia-memory

Configurazione

Aprire il file config.yaml e aggiornare la sezione auth come segue:

La configurazione predefinita appare così, poiché usiamo un plugin htpasswd incorporato di default che si può disabilitare commentando le seguenti linee.

Configurazione del plugin Auth

 htpasswd:
    file: ./htpasswd
    #max_users: 1000

e sostituendo con (in caso si decida di utilizzare un plugin ldap.

auth:
  activedirectory:
    url: "ldap://10.0.100.1"
    baseDN: 'dc=sample,dc=local'
    domainSuffix: 'sample.local'

Plugin Auth multipli

Questo è tecnicamente possibile, prestando importanza all'ordine del plugin, dato che le credenziali verranno risolte in ordine.

auth:
  htpasswd:
    file: ./htpasswd
    #max_users: 1000
  activedirectory:
    url: "ldap://10.0.100.1"
    baseDN: 'dc=sample,dc=local'
    domainSuffix: 'sample.local'

Configurazione del Plugin Middleware

Questo è un esempio di come si configura un plugin middleware. Tutti i plugin middleware devono essere definiti nel namespace middlewares.

middlewares:
  audit:
    enabled: true

Si potrebbe seguire il plugin audit middle come esempio di base.

Configurazione del Plugin Store

Questo è un esempio di come configurare un plugin di archiviazione. Tutti i plugin di archiviazione devono essere definiti nel namespace store.

store:
  memory:
    limit: 1000

Se si definisce uno store personalizzato, la proprietà di archiviazione nel file di configurazione verrà ignorata.

Plugin ereditati

Plugin di Sinopia

(compatibili con tutte le versioni)

• sinopia-npm: plugin auth per il supporto di sinopia a un registro npm.
• sinopia-memory: plugin auth per sinopia che mantiene gli utenti in memoria.
• sinopia-github-oauth-cli.
• sinopia-crowd: plugin auth per sinopia che supporta atlassian crowd.
• sinopia-activedirectory: Plugin di autenticazione Active Directory per sinopia.
• sinopia-github-oauth: plugin di autenticazione per sinopia2, che supporta il flusso web di github oauth.
• sinopia-delegated-auth: plugin di autenticazione di Sinopia che delega autenticazione ad altro URL HTTP
• sinopia-altldap: Alterna il plugin LDAP Auth per Sinopia
• sinopia-request: Un plugin auth semplice e completo con la configurazione per utilizzare un'API esterna.
• sinopia-htaccess-gpg-email: Genera password in formato htaccess, cripta con GPG ed invia attraverso MailGun API agli utenti.
• sinopia-mongodb: Un plugin auth semplice e completo con la configurazione per utilizzare un database mongodb.
• sinopia-htpasswd: plugin auth per sinopia che supporta il formato htpasswd.
• sinopia-leveldb: plugin auth supportato da leveldb per l'npm privato di sinopia.
• sinopia-gitlabheres: plugin di autenticazione Gitlab per sinopia.
• sinopia-gitlab: plugin di autenticazione Gitlab per sinopia
• sinopia-ldap: plugin auth LDAP per sinopia.
• sinopia-github-oauth-env plugin di autenticazione di Sinopia con flusso web github oauth.

Tutti i plugin di sinopia dovrebbero essere compatibili con tutte le versioni future di verdaccio. Tuttavia, incoraggiamo i contributori a spostarli sull'API attuale di verdaccio e ad utilizzare il prefisso così verdaccio-xx-name.

Plugin di Verdaccio

(compatibile da 2.1.x)

Plugin di autorizzazione

• verdaccio-bitbucket: plugin di autenticazione di Bitbucket per verdaccio.
• verdaccio-bitbucket-server: Bitbucket Server authentication plugin for verdaccio.
• verdaccio-ldap: LDAP auth plugin for verdaccio.
• verdaccio-active-directory: Active Directory authentication plugin for verdaccio
• verdaccio-gitlab: use GitLab Personal Access Token to authenticate
• verdaccio-gitlab-ci: Enable GitLab CI to authenticate against verdaccio.
• verdaccio-htpasswd: Auth based on htpasswd file plugin (built-in) for verdaccio
• verdaccio-github-oauth: Github oauth authentication plugin for verdaccio.
• verdaccio-github-oauth-ui: GitHub OAuth plugin for the verdaccio login button.

Plugin di Middleware

• verdaccio-audit: plugin verdaccio per il supporto cli di npm audit (incorporato) (compatibile da 3.x)

• verdaccio-profile-api: plugin di verdaccio per il supporto cli di npm profile e npm profile set password per l'autenticazione basata su verdaccio-htpasswd

Plugin di archiviazione

(compatibile da 3.x)

• verdaccio-memory Plugin di archiviazione per ospitare pacchetti in Memoria
• verdaccio-s3-storage Plugin di archiviazione per ospitare pacchetti Amazon S3
• verdaccio-google-cloud Plugin di archiviazione per ospitare pacchetti Google Cloud Storage

Avvertenze

Non tutti questi plugin vengono testati assiduamente, alcuni di essi potrebbero anche non funzionare affatto. In caso si incontri qualsiasi problema, si prega di notificarlo al proprietario del plugin in questione.