Home

Welcome to the gsenha-api wiki!

Introduction

GSenha-API is a password manager, but not an usual one. Its architecture was designed to avoid information leakage in the case of a compromise. It is possible to store a password and share it among a group of users in a secure way, and also store a personal password, just for yourself. Storing a personal password is just like using another well-known password manager like KeePass, PasswordSafe, Password Gorilla and others. The goal in GSenha is to be able to store a password and allow other users to have access to it in a secure way, without backdoors and no shared secret keys. This is done with asymmetric cryptography (private and public keys).

General Documentation

• Architeture
• How to deploy
• Understand gsenha logs
• Generating keys

API Documentation

• API Concepts - Errors and JSON format
• GET /healthcheck: Healthcheck
• POST /add/user: Add a user
• POST /login: Login
• POST /add/password/personal: Add a personal password
• POST /add/password/shared: Add a shared password
• POST /add/password/personal/external: Add a password to another user
• POST /add/password/shared/external: Add a password to another group
• GET /get/passwords: Get all passwords
• GET /get/groups: Get all groups
• GET /get/mygroups: Get your groups
• GET /get/folders: Get your folders
• GET /get/tree: Get your directory tree
• POST /unlock: Unlock shared passwords to a new user - part 1
• POST /unlocking: Unlock shared passwords to a new user - part 2
• POST /add/folder: Add a folder
• POST /delete/folder: Delete a folder
• POST /update/password: Update a password
• DELETE /delete/password/:idPassword: Delete a password
• POST /search/password: Get a specific password