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'

Multiple Auth plugins

This is tecnically possible, making the plugin order important, as the credentials will be resolved in order.

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: auth plugin for sinopia supporting atlassian crowd.
• sinopia-activedirectory: Active Directory authentication plugin for sinopia.
• sinopia-github-oauth: authentication plugin for sinopia2, supporting github oauth web flow.
• sinopia-delegated-auth: Sinopia authentication plugin that delegates authentication to another HTTP URL
• sinopia-altldap: Alternate LDAP Auth plugin for Sinopia
• sinopia-request: An easy and fully auth-plugin with configuration to use an external API.
• sinopia-htaccess-gpg-email: Generate password in htaccess format, encrypt with GPG and send via MailGun API to users.
• sinopia-mongodb: An easy and fully auth-plugin with configuration to use a mongodb database.
• sinopia-htpasswd: auth plugin for sinopia supporting htpasswd format.
• sinopia-leveldb: a leveldb backed auth plugin for sinopia private npm.
• sinopia-gitlabheres: Gitlab authentication plugin for sinopia.
• sinopia-gitlab: Gitlab authentication plugin for sinopia
• sinopia-ldap: LDAP auth plugin for sinopia.
• sinopia-github-oauth-env Sinopia authentication plugin with github oauth web flow.

All sinopia plugins should be compatible with all future verdaccio versions. Anyhow, we encourage contributors to migrate them to the modern verdaccio API and using the prefix as verdaccio-xx-name.

Verdaccio Plugins

(compatible since 2.1.x)

Authorization Plugins

• verdaccio-bitbucket: Bitbucket 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-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.

Middleware Plugins

• verdaccio-audit: verdaccio plugin for npm audit cli support (built-in) (compatible since 3.x)

• verdaccio-profile-api: verdacci plugin for npm profile cli support and npm profile set password for verdaccio-htpasswd based authentificaton

Storage Plugins

(compatible since 3.x)

• verdaccio-memory Storage plugin to host packages in Memory
• verdaccio-s3-storage Storage plugin to host packages Amazon S3
• verdaccio-google-cloud Storage plugin to host packages Google Cloud Storage

Caveats

Not all these plugins are been tested continuously, some of them might not work at all. Please if you found any issue feel free to notify the owner of each plugin.