Instalación:

Uso

Global

Barra de pestañas

Base de datos

Copiar al portapapeles

Cuando una credencial está seleccionada:

• Enter sobre Usuario copia el nombre de usuario.
• Enter sobre Contraseña copia la contraseña.

Abrir archivo

Al seleccionar Abrir, aparece una ventana emergente de texto. Dentro de la ventana, puede presionar Tab para navegar por las bases de datos abiertas recientemente.

Puede ingresar la ruta absoluta o relativa a la base de datos. Si el archivo no existe, se creará si la ruta especificada es válida.

Las rutas de archivos recientes se almacenan en $HOME/.config/klip/recents.

Seguridad

Toda la lógica de cifrado se encuentra en src/Security.cpp

Derivación de clave

• Al crear una base de datos, se solicita una contraseña maestra.
• Se deriva una clave criptográfica de la contraseña y una sal aleatoria única usando crypto_pwhash de libsodium, basado en Argon2id en modo INTERACTIVO (parámetros de costo ajustables contra ataques de fuerza bruta).

Cifrado

• La base de datos se cifra usando crypto_secretbox_easy con la clave derivada y un nonce aleatorio.
• Este algoritmo proporciona detección de manipulación mediante un MAC.

Formato de almacenamiento

• El archivo cifrado se almacena en binario con el siguiente formato:

Proceso de descifrado

• La clave se deriva usando la contraseña proporcionada por el usuario y la sal almacenada.
• Los datos se descifran usando crypto_secretbox_open_easy.
• Si la contraseña es incorrecta o el archivo ha sido modificado, la verificación MAC falla y la operación se rechaza.

Contribuciones

Las contribuciones siempre son bienvenidas. Si encuentra un error o desea ayudar con nuevas funciones, puede:

• Abrir un issue en el repositorio.
• Abrir un pull request.
• Enviarme un correo electrónico a [email protected]

Idea de contribución

Necesito ayuda con la detección de teclas de flecha:

Por el momento, las teclas normales se detectan correctamente, pero las teclas de flecha siempre se interpretan como una sola pulsación de la tecla ESC en lugar de la secuencia de escape completa.

Si tiene experiencia con entrada de terminal (termios, secuencias de escape ANSI, etc.), realmente agradecería su ayuda.

La lógica para leer las pulsaciones de teclas se encuentra en src/term/term.cpp, especialmente en la función read_char y es utilizada por la clase App en la función start ubicada en src/ui/app/app.cpp.

Si desea contribuir, intente limitar los cambios a la función read_char o a la clase Terminal, para que el resto del proyecto no necesite ser modificado.