passed/README.md

PassED

Discord Demo

EMail, but for passwords.

Did you ever run into the issue of needing to share a password with someone in a secure manner and you did not know how?

You want to send it to them by EMail, but there it will surely get logged along the way.

You want to write it send it to them over WhatsApp, but that's not that secure.

You want to write it on paper, but everyone can read that.

PassED solves these issues by allowing you to generate single-use URLs that contain your password.

How it works

When you create a password URL, PassED firstly encrypts the password in your browser using AES-GCM. It then uploads the encrypted password to the server, which responds with an ID that uniquely identifies that password. The AES Key and IV is then stored in the URL, along with the ID.

When someone views the password, PassED looks at the URL. It knows the password ID, AES Key and IV. It reaches out to the server, asks for a password with the ID from the URL, and then decrypts it with the AES Key and IV.

This model ensures that a malicous host can not read the passwords.

Installation

Installation is done with docker compose.

services:
  "passed":
    build: "https://git.1e99.eu/1e99/passed.git"
    volumes:
      - "./passed:/etc/passed"
    environment:
      - "PASSED_STORE_TYPE=dir"
      - "PASSED_STORE_DIR_PATH=/etc/passed"
    ports:
      - "3000:3000"

Configuration

Configuration is done with environment variables.

• PASSED_ADDRESS: Specifies the address that PassED should listen on, defaults to :3000
• PASSED_STORE_TYPE: Specify which store to use to save passwords, defaults to ram:
  • ram: Stores all passwords in RAM, they are lost on restart
  • dir: Stores all passwords in a directory. Requires PASSED_STORE_DIR_PATH to be set to the directory, defaults to passwords. PassED will not create the directory.
• STORE_CLEAR_EXPIRED_INTERVAL: Specifies the delay in seconds to wait between clearing expired passwords, defaults to 30.