SysPass Plugins
Depuis la version 2.1.13.17083101, une structure est mise en place pour accepter des Plugins. Par défaut il faut les déployer dans le répertoire inc/Plugins. Cet article présente une mise ne place pour une installation sous Ubuntu afin de faciliter leur installation et activation selon les versions de SysPass.
Votre avis
| Nobody voted on this yet
|
|
Accès
Les Plugins doivent être déposés dans le répertoire inc/Plugins.
Ajout
Dans un premier temps, l'organisation suivante est mise en place.
- common/plugins-available : Pour placer les plugins téléchargés.
- common/plugins-enabled : Pour placer des liens sur les plugins à activer.
- common/inc/Plugins : liens sur le répertoire
common/plugins-enabled.
La structure reprend le principe d'installation des sites et modules d'Apache sous Ubuntu.
#sudo mkdir -p /var/opt/syspass/common/plugins-available #sudo mkdir -p /var/opt/syspass/common/plugins-enabled #sudo chown www-data:www-data /var/opt/syspass/common/plugins-available #sudo chown www-data:www-data /var/opt/syspass/common/plugins-enabled #sudo chmod 700 /var/opt/syspass/common/plugins-available #sudo chmod 700 /var/opt/syspass/common/plugins-enabled #sudo mkdir -p /var/opt/syspass/common/inc #sudo chown www-data:www-data /var/opt/syspass/common/inc #sudo chmod 700 /var/opt/syspass/common/inc #sudo ln -s /var/opt/syspass/common/plugins-enabled /var/opt/syspass/common/inc/Plugins #sudo chown -h www-data:www-data /var/opt/syspass/common/inc/Plugins
Activation
Un lien Plugins est placé sous /var/opt/syspass/syspass/inc pour pointer vers /var/opt/syspass/common/inc/Plugins.
Ainsi, les liens placés dans /var/opt/syspass/common/plugins-enabled activeront automatiquement les applications.
#sudo rm -rf /var/opt/syspass/syspass/inc/Plugins #sudo ln -s /var/opt/syspass/common/inc/Plugins /var/opt/syspass/syspass/inc/Plugins #sudo chown -h www-data:www-data /var/opt/syspass/syspass/inc/Plugins
Téléchargement
Tous les plugins sont dans un premier temps téléchargés.
#sudo wget -P /var/opt/syspass/common/plugins-available https://github.com/nuxsmin/sysPass-Plugins/archive/master.zip
Installation
Lors de l'introduction de ces Plugins, une seul était disponible à savoir Authenticator. La structure du plugin est mise en place dans un premier temps.
#sudo mkdir /var/opt/syspass/common/plugins-available/Authenticator #sudo chown www-data:www-data /var/opt/syspass/common/plugins-available/Authenticator #sudo chmod 700 www-data:www-data /var/opt/syspass/common/plugins-available/Authenticator
Puis l'archive téélchargée est décompressée. Attention, celle-ci contient l'ensemble des plugins officiels.
#sudo unzip /var/opt/syspass/common/plugins-available/master.zip -d /var/opt/syspass/common/plugins-available
Pour ce téléchargement, la version du plugin est 1.1.2 et est déplacé dans un répertoire dont le nom est le numéro de la version.
#sudo mv /var/opt/syspass/common/plugins-available/sysPass-Plugins-master/Authenticator /var/opt/syspass/common/plugins-available/Authenticator/1.1.2
#sudo chown -R www-data:www-data /var/opt/syspass/common/plugins-available/Authenticator/1.1.2
#sudo find /var/opt/syspass/common/plugins-available/Authenticator/1.1.2 -type f -exec chmod 0600 {} \;
#sudo find /var/opt/syspass/common/plugins-available/Authenticator/1.1.2 -type d -exec chmod 0700 {} \;
Le fichier téléchargé, et les résidus de l'extraction, peuvent être supprimés.
#sudo rm /var/opt/syspass/common/plugins-available/master.zip #sudo rm -rf /var/opt/syspass/common/plugins-available/sysPass-Plugins-master
Il reste à mettre en place le lien dans le répertoire /var/opt/syspass/common/plugins-enabled.
#sudo ln -s /var/opt/syspass/common/plugins-available/Authenticator/1.1.2 /var/opt/syspass/common/plugins-enabled/Authenticator #sudo chown -h www-data:www-data /var/opt/syspass/common/plugins-enabled/Authenticator
Le plugin est alors disponible. En effet, le contenu du sous-répertoire inc est le suivant.
#sudo ll /var/opt/syspass/syspass/inc/ total 44 drwxr-x--- 7 www-data www-data 4096 oct. 27 23:38 ./ drwxr-x--- 8 www-data www-data 4096 oct. 21 21:26 ../ -rw-r----- 1 www-data www-data 2806 oct. 17 08:59 BaseFunctions.php -rw-r----- 1 www-data www-data 2905 oct. 17 08:59 Base.php drwxr-x--- 6 www-data www-data 4096 oct. 17 08:59 Exts/ drwxr-x--- 12 www-data www-data 4096 oct. 17 08:59 locales/ lrwxrwxrwx 1 www-data www-data 35 oct. 27 23:38 Plugins -> /var/opt/syspass/common/inc/Plugins/ drwxr-x--- 17 www-data www-data 4096 oct. 17 08:59 SP/ -rw-r----- 1 www-data www-data 5547 oct. 17 08:59 SplClassLoader.php drwxr-x--- 2 www-data www-data 4096 oct. 17 08:59 sql/ drwxr-x--- 3 www-data www-data 4096 oct. 17 08:59 themes/
L'emplacement /var/opt/syspass/common/inc/Plugins étant un lien sur /var/opt/syspass/common/plugins-enabled, le contnu est le suivant.
#sudo ll /var/opt/syspass/common/plugins-enabled/ total 12 drwxr-x--- 2 www-data www-data 4096 oct. 28 00:02 ./ drwxr-x--- 6 www-data www-data 4096 oct. 27 23:18 ../ lrwxrwxrwx 1 www-data www-data 61 oct. 28 00:02 Authenticator -> /var/opt/syspass/common/plugins-available/Authenticator/1.1.2/
Voir aussi
Documentation officielle: https://github.com/nuxsmin/sysPass-Plugins
