A simple password manager using age written in POSIX sh.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ricardo García Jiménez 63dc8f7a14 passgesh v1.0-beta01 1 week ago
LICENSE.md passgesh v1.0-beta01 1 week ago
README.md passgesh v1.0-beta01 1 week ago
passgesh passgesh v1.0-beta01 1 week ago

README.md

passgesh

Un gestor de contraseñas simple que utiliza age escrito en POSIX sh, inspirado en pash por Dylan Araps:


Tabla de contenido


Dependencias

Soporte de portapapeles

  • xclip (Modificable con PASSGESH_CLIPBOARD_TOOL)

Soporte de compresión

  • lzip (Modificable con PASSGESH_COMPRESS_TOOL y PASSGESH_COMPRESS_EXTENSION)

Instalación

Clone el repositorio:

  • $ git clone https://git.disroot.org/ricardog08/passgesh
  • $ cd passgesh

Mueva el script de passgesh a /usr/local/bin:

  • # mv passgesh /usr/local/bin

Otorgue permisos de ejecución al script:

  • # chmod 755 /usr/local/bin/passgesh

Uso

[SINOPSIS]
	passgesh [OPCIÓN] [ARGUMENTO]

[OPCIONES] [ARGUMENTOS] - [DESCRIPCIÓN]
	=>  -a[dd]     [CATEGORÍA/NOMBRE] - Almacena una nueva contraseña.
	=>  -b[ackup]  [RUTA]             - Crea un respaldo del directorio personal de passgesh.
	=>  -c[opy]    [CATEGORÍA/NOMBRE] - Copia una contraseña al portapapeles.
	=>  -d[el]     [CATEGORÍA/NOMBRE] - Elimina una contraseña almacenada.
	=>  -l[ist]                       - Muestra una lista de todas las contraseñas almacenadas.
	=>  -n[ew]                        - Crea una nueva llave maestra.
	=>  -r[enew]                      - Renueva la contraseña de la llave maestra.
	=>  -s[how]    [CATEGORÍA/NOMBRE] - Muestra una contraseña (STDOUT).

[CONFIGURACIÓN POR DEFECTO]
	Directorio de almacenamiento:                              export PASSGESH_DIR=~/.local/share/passgesh
	Composición de la contraseña aleatoria:                    export PASSGESH_REGULAR_EXPRESSION=[:graph:]
	Longitud de la contraseña aleatoria:                       export PASSGESH_LENGTH=15
	Herramienta de portapapeles:                               export PASSGESH_CLIPBOARD_TOOL=xclip
	Parametros de opciones de la herramienta de portapapeles:  export PASSGESH_CLIPBOARD_PARAMETERS='-sel clip'
	Tiempo de espera para limpiar el portapapeles:             export PASSGESH_SET_TIME_CLIPBOARD=15
	Herramienta de compresión:                                 export PASSGESH_COMPRESS_TOOL=lzip
	Extensión para la herramienta de compresión:               export PASSGESH_COMPRESS_EXTENSION=lz

OPCIONAL: CATEGORÍA, RUTA (directorio actual).

Tutorial

Mostrar la ayuda del script:

  • $ passgesh

Crea una nueva llave maestra, es la parte principal del script, cifra y descifra las contraseñas que el usuario desea almacenar:

  • $ passgesh -n

Guarda una nueva contraseña con una categoría definida (opcional):

  • $ passgesh -a email/abc@email.com

Mostrar una lista de archivos de contraseñas almacenadas:

  • $ passgesh -l

Mostrar una contraseña almacenada en la salida estándar:

  • $ passgesh -s email/abc@email.com

Copiar una contraseña al portapapeles:

  • $ passgesh -c email/abc@email.com

Elimina una contraseña almacenada:

  • $ passgesh -d email/abc@email.com

Crear un respaldo de la carpeta personal de passgesh en el directorio actual (la ruta es opcional):

  • $ passgesh -b

Cambiar la contraseña de la llave maestra:

  • $ passgesh -r

Configuración (opcional)

¿Cómo cambiar el directorio por defecto?

Por defecto la carpeta personal de passgesh se almacena en el directorio ${XDG_DATA_HOME:=$HOME/.local/share}/passgesh}, solo defina la variable PASSGESH_DIR en el entorno shell:

# Defina un directorio:
export PASSGESH_DIR="$HOME/Documentos/passgesh"

# O si lo prefiere de esta manera:
PASSGESH_DIR="$HOME/Documentos/passgesh" passgesh

¿Cómo cambiar la composición aleatoria de contraseñas?

Por defecto utiliza la clase de caracteres [:graph:] (todos los caracteres ASCII a excepción de espacios), defina la variable PASSGESH_REGULAR_EXPRESSION para configurar otra clase o una expresión regular:

export PASSGESH_REGULAR_EXPRESSION=_A-Z-a-z-0-9

¿Cómo cambiar la longitud de las contraseñas aleatorias?

Defina la variable PASSGESH_LENGTH, por defecto genera contraseñas aleatorias de 15 caracteres:

export PASSGESH_LENGTH=20

¿Cómo cambiar la herramienta de portapapeles?

Defina una herramienta de portapapeles en la variable PASSGESH_CLIPBOARD_TOOL y sus parámetros de opciones en PASSGESH_CLIPBOARD_PARAMETERS:

# Por defecto:
export PASSGESH_CLIPBOARD_TOOL=xclip
export PASSGESH_CLIPBOARD_PARAMETERS='-sel clip'

¿Cómo cambiar el tiempo de borrado del portapapeles?

Passgesh limpia el portapapeles por defecto a los 15 segundos, el tiempo de espera está definido por el comando sleep, defina la variable PASSGESH_SET_TIME_CLIPBOARD asignandole un tiempo determinado, o si desea desactivar esta caracteristica asigne off:

export PASSGESH_SET_TIME_CLIPBOARD=off

¿Cómo cambiar la herramienta de compresión de respaldos?

Por defecto passgesh comprime los respaldos utilizando lzip con extensión *.lz, defina la variable PASSGESH_COMPRESS_TOOL para cambiar la herramienta de compresión y PASSGESH_COMPRESS_EXTENSION para cambiar la extensión de los respaldos:

export PASSGESH_COMPRESS_TOOL=gzip
export PASSGESH_COMPRESS_EXTENSION=gz

Changelog


Copyright © 2020 Ricardo García Jiménez

Este programa es software libre: puede redistribuirlo y/o modificarlo bajo los términos de la Licencia General Pública de GNU publicada por la Free Software Foundation, ya sea la versión 3 de la Licencia, o (a su elección) cualquier versión posterior.