syspass/syspass-decrypter

A standalone utility for decrypting sysPass XML files

v0.1.2-beta 2019-09-15 18:26 UTC

Requires

• php: ~7.2 || ~7.3
• ext-dom: *
• ext-fileinfo: *
• ext-json: *
• ext-libxml: *
• ext-mbstring: *
• defuse/php-encryption: ^2.1
• league/climate: 3.5.0
• php-di/php-di: ^6.0
• symfony/console: v4.3.3

Requires (Dev)

• ext-xmlwriter: *
• fzaninotto/faker: ~v1.8
• phpunit/phpunit: ^8

GPL-3.0

• Rubén Domínguez

README

sysPass Decrypter

Current status: BETA

This is an standalone tool for decrypting sysPass exported XML files. It supports either encrypted or non encrypted files.

The purpose of this tool is for using in DR (Disaster Recovery) scenarios where you cannot access to your sysPass instance. It would be useful to store the exported XML file and a copy of this tool within a secure location, though all the data is decrypted on-the-fly, nevertheless a secure location adds an additional layer of security, avoiding fire risks, thefts, etc.

This tool requires PHP 7.2 or higher

Install

Using PHAR (recommended)

You can simply download a pre-compiled and ready-to-use version as a Phar to any directory. Download the latest syspass-decrypter.phar file from our releases page:

Latest release

Using Composer

TODO

Usage

Global Options

• --xmlpath Set the XML file path
• --password Set the password for the encrypted XML (it will be asked if not set)
• --masterPassword Set the master password for decrypting the accounts' password (it will be asked if not set)
• --wide=[yes|no] Do not truncate text fields
• --help Commands help

Search Account

• spd:search-account [name] Search for an account with the given name. If [name] is omitted it will list all the accounts

• --withCategories=[yes|no] Include the category column for each result
• --withTags=[yes|no] Include the tags column for each result

Examples

syspass-decrypter.phar spd:search-account "GitHub" --xmlpath ./syspass.xml --withCategories=yes --wide

syspass-decrypter.phar spd:search-account --xmlpath ./syspass.xml