Is a Slack command to manage shared passwords between the members of a channel in Slack.

This project was build focused in establishing a communication where the trustness between parties is not required, using the asymmetric algorithm RSA to share encrypted information point to point and where the only participant allowed to read the stored passwords is the Password Server, who is different and independent for each client.

• /pass or /pass list list the available passwords in the channel.
• /pass <secret> or /pass show <secret> retrieve a one time use link with the secret content, this link expires in 15 minutes.
• /pass insert <secret> retrieve a link with an editor to create a secret, this link expires in 15 minutes.
• /pass remove <secret> make unreachable the secret, to complete deletion in necessary doing it manually from the s3 password storage.
• /pass register <password_server_url> this is the command used for the initial setup, it is only necessary to execute it once.

Been Alice and Bob members of the same Slack group, they need to share the password of the service "Bar". This is the process that they need to follow to share it. In this example Alice will create the secret and Bob will consult it.

• Alice: Requests a link to create the secret (/pass insert Bar)
• Proxy Server: Generates an unique editor link, valid for 15 minutes
• Slack: Shows the editor link, only visible for Alice
• Alice: Follows the link
• Proxy Server: Requests the the public key to the Password Server and send it to the editor
• Editor: Displays itself in Alice's browser
• Alice: Writes the shared secret
• Alice: Press the "Create" button
• Editor: Encrypts the secret before sending the request
• Editor: Sends the request to the Proxy Server
• Proxy Server: Sends the encrypted secret to the Password Server (note that this secret is indecipherable for this server)
• Password Server: Stores the encrypted secret in the configured S3 bucket.

Note: Editor and Proxy Server are the same server, but Editor represents the frontend view.

• Bob: Requests a link to see the secret (/pass Bar or /pass show Bar)
• Proxy Server: Requests the secret to the password server using the Slack team name and channel id
• Password server: Reads and decrypt the secret
• Password server: Generates one time use link with the secret, valid for 15 minutes (using One-Time Secret API)
• Password server: Encrypts the link with the Proxy Server public key
• Password server: Sends the encrypted link to the Proxy Server
• Proxy server: Decrypts the one time use link
• Proxy server: Sends the link to Slack
• Slack: Shows the link only visible for Bob
• Bob: Follows the link
• Onetimesecret: Shows and destroys the secret