From 957d1890db9448d5985f795c27d0b84ad47ed0a2 Mon Sep 17 00:00:00 2001
From: varjolintu <sami.vanttinen@protonmail.com>
Date: Wed, 11 Oct 2017 15:08:58 +0300
Subject: [PATCH] Updated the protocol

---
 README.md | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 3972f10..6dbffe9 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ Encrypted messages are built with these JSON parameters:
 - action - `test-associate`, `associate`, `get-logins`, `get-logins-count`, `set-login`...
 - message - Encrypted message, base64 encoded
 - nonce - 24 bytes long random data, base64 encoded. This must be the same when responding to a request.
+- clientID - 24 bytes long random data, base64 encoded. This is used to identify different browsers if multiple are used with proxy application.
 
 ### change-public-keys
 Request:
@@ -46,7 +47,8 @@ Request:
 	"action": "change-public-keys",
 	"publicKey": "<current public key>",
 	"proxyPort": "<UDP port for proxy applications>",
-	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q"
+	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -61,7 +63,7 @@ Response (success):
 ```
 
 ### get-databasehash
-Request:
+Request (unencrypted):
 ```javascript
 {
 	"action": "get-databasehash"
@@ -91,7 +93,8 @@ Request:
 {
 	"action": "associate",
 	"message": encryptedMessage
-	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q"
+	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -112,7 +115,8 @@ Unencrypted message:
 {
 	"action": "test-associate",
 	"id": "<saved database identifier>",
-	"key": "<saved database public key>"
+	"key": "<saved database public key>",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -141,7 +145,8 @@ Request:
 ```javascript
 {
 	"action": "generate-password",
-	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q"
+	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -175,7 +180,8 @@ Request:
 {
 	"action": "get-logins",
 	"message": encryptedMessage
-	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q"
+	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -220,7 +226,8 @@ Request:
 {
 	"action": "set-login",
 	"message": encryptedMessage
-	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q"
+	"nonce": "tZvLrBzkQ9GxXq9PvKJj4iAnfPT0VZ3Q",
+	"clientID": "<clientID>"
 }
 ```
 
@@ -275,4 +282,4 @@ Feel free to support this project:
 - Donate via [PayPal](https://paypal.me/varjolintu)
 - Donate via Bitcoin: 1LHbD69CcmpLW5hjUXs2MGJhw3GxwqLdw3
 
-Also consider donating to [KeePassXC](https://flattr.com/submit/auto?fid=x7yqz0&url=https%3A%2F%2Fkeepassxc.org) and passifox teams [(1)](https://github.com/smorks/passifox),[(2)](https://github.com/projectgus/passifox),[(3)](https://github.com/pfn/passifox). They are doing great job.
\ No newline at end of file
+Also consider donating to [KeePassXC](https://flattr.com/submit/auto?fid=x7yqz0&url=https%3A%2F%2Fkeepassxc.org) and passifox teams [(1)](https://github.com/smorks/passifox),[(2)](https://github.com/projectgus/passifox),[(3)](https://github.com/pfn/passifox). They are doing great job.