Skip to content

Commit 04d3425

Browse files
committed
README update
updated links
1 parent 7ae917f commit 04d3425

File tree

2 files changed

+21
-21
lines changed

2 files changed

+21
-21
lines changed

README.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
is a plugin for KeePass 2.x and provides a secure means of exposing KeePass entries via HTTP for clients to
44
consume.
55

6-
This plugin is primarily intended for use with [PassIFox for Mozilla Firefox](https://github.com/pfn/passifox/) and [chromeIPass for Google Chrome](https://chrome.google.com/webstore/detail/chromeipass/ompiailgknfdndiefoaoiligalphfdae?hl=en).
6+
This plugin is primarily intended for use with [chromeIPass for Google Chrome](https://github.com/alan-null/chromeIPass).
77

88
## Features
99
* returns all matching entries for a given URL
@@ -29,7 +29,7 @@ This plugin is primarily intended for use with [PassIFox for Mozilla Firefox](ht
2929

3030
## Non-Windows / Manual Windows installation
3131

32-
1. Download [KeePassHttp](https://raw.github.com/pfn/keepasshttp/master/KeePassHttp.plgx)
32+
1. Download [KeePassHttp](https://github.com/alan-null/chromeIPass/releases)
3333
2. Copy it into the KeePass directory
3434
* default directory in Ubuntu14.04: /usr/lib/keepass2/
3535
* default directory in Arch: /usr/share/keepass
@@ -45,7 +45,7 @@ KeePass needs Mono. You can find detailed [installation instructions on the offi
4545

4646
Perry has tested KeePassHttp with Mono 2.6.7 and it appears to work well.
4747
With Mono 2.6.7 and a version of KeePass lower than 2.20 he could not get the plgx file to work on linux.
48-
If the plgx file does also not work for you, you can try the two DLL files KeePassHttp.dll and Newtonsoft.Json.dll from directory [mono](https://github.com/pfn/keepasshttp/tree/master/mono) which should work for you.
48+
If the plgx file does also not work for you, you can try the two DLL files KeePassHttp.dll and Newtonsoft.Json.dll from directory [mono](https://github.com/alan-null/keepasshttp/tree/master/mono) which should work for you.
4949

5050
With newer versions of Mono and KeePass it seems that the plgx file works pretty fine.
5151
More information about it are contained in the following experience report.
@@ -67,7 +67,7 @@ mono v2.10.8:
6767

6868
I have no problems using "KeePassHttp.plgx". I simply dropped the .plgx-file in my KeePass folder, and it works.
6969

70-
I'm currently using KeePass v2.22.
70+
I'm currently using KeePass v2.22.
7171
Nevertheless, until KeePass v2.21 I used the 2 suggested .dll's and it worked fine too.
7272

7373
Usually I only use chromeIPass, but I did a short test
@@ -85,11 +85,11 @@ KeePassHttp works out-of-the-box. You don't have to explicitely configure it.
8585

8686
You can open the options dialog with menu: Tools > KeePassHttp Options
8787

88-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/menu.jpg" alt="menu" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/menu.jpg)
88+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/menu.jpg" alt="menu" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/menu.jpg)
8989

9090
The options dialog will appear:
9191

92-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/options-general.png" alt="options-general" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/options-general.png)
92+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/options-general.png" alt="options-general" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/options-general.png)
9393

9494
General tab
9595

@@ -103,35 +103,35 @@ General tab
103103
6. removes all shared encryption-keys which are stored in the currently selected database. Every inquirer has to reauthenticate.
104104
7. removes all stored permissions in the entries of the currently selected database.
105105

106-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/options-advanced.png" alt="options-advanced" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/options-advanced.png)
106+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/options-advanced.png" alt="options-advanced" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/options-advanced.png)
107107

108108
Advanced tab
109109

110110
8. KeePassHttp no longer asks for permissions to retrieve entries, it always allows access.
111111
9. KeePassHttp no longer asks for permission to update an entry, it always allows updating them.
112112
10. Searching for entries is no longer restricted to the current active database in KeePass but is extended to all opened databases!
113113
- __Important:__ Even if another database is not connected with the inquirer, KeePassHttp will search and retrieve entries of all opened databases if the active one is connected to KeePassHttp!
114-
11. if activated KeePassHttp also search for string fields which are defined in the found entries and start with "KPH: " (note the space after colon). __The string fields will be transfered to the client in alphabetical order__. You can set string fields in the tab _Advanced_ of an entry.
115-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/advanced-string-fields.png" alt="advanced tab of an entry" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/advanced-string-fields.png)
114+
11. if activated KeePassHttp also search for string fields which are defined in the found entries and start with "KPH: " (note the space after colon). __The string fields will be transfered to the client in alphabetical order__. You can set string fields in the tab _Advanced_ of an entry.
115+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/advanced-string-fields.png" alt="advanced tab of an entry" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/advanced-string-fields.png)
116116

117117
## Tips and Tricks
118118

119119
### Support multiple URLs for one username + password
120120
This is already implemented directly in KeePass.
121121

122-
1. Open the context menu of an entry by clicking right on it and select _Duplicate entry_:
123-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/keepass-context-menu.png" alt="context-menu-entry" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/keepass-context-menu.png)
122+
1. Open the context menu of an entry by clicking right on it and select _Duplicate entry_:
123+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/keepass-context-menu.png" alt="context-menu-entry" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/keepass-context-menu.png)
124124

125-
2. Check the option to use references for username and password:
126-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/keepass-duplicate-entry-references.png" alt="mark checkbox references" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/keepass-duplicate-entry-references.png)
125+
2. Check the option to use references for username and password:
126+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/keepass-duplicate-entry-references.png" alt="mark checkbox references" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/keepass-duplicate-entry-references.png)
127127

128128
3. You can change the title, URL and evertything of the copied entry, but not the username and password. These fields contain a _Reference Key_ which refers to the _master entry_ you copied from.
129129

130130
## Troubleshooting
131131

132132
__First:__ If an error occures it will be shown as notification in system tray or as message box in KeePass.
133133

134-
Otherwise please check if it could be an error of the client you are using. For passIFox and chromeIPass you can [report an error here](https://github.com/pfn/passifox/issues/).
134+
Otherwise please check if it could be an error of the client you are using. For passIFox and chromeIPass you can [report an error here](https://github.com/alan-null/chromeIPass/issues/).
135135

136136

137137
If you are having problems with KeePassHttp, please tell us at least the following information:
@@ -143,12 +143,12 @@ If you are having problems with KeePassHttp, please tell us at least the followi
143143

144144
### HTTP Listener error message
145145

146-
Maybe you get the following error message:
147-
[<img src="https://raw.github.com/pfn/keepasshttp/master/documentation/images/http-listener-error.png" alt="http listener error" width="300px" />](https://raw.github.com/pfn/keepasshttp/master/documentation/images/http-listener-error.png)
146+
Maybe you get the following error message:
147+
[<img src="https://raw.github.com/alan-null/keepasshttp/master/documentation/images/http-listener-error.png" alt="http listener error" width="300px" />](https://raw.github.com/alan-null/keepasshttp/master/documentation/images/http-listener-error.png)
148148

149149
In old versions the explaining first part of the message does not exist!
150150

151-
This error occurs because you have multiple copies of KeePassHttp in your KeePass directory! Please check __all__ PLGX- and DLL-files in your _KeePass directory and all sub-directories_ whether they are a copy of KeePassHttp.
151+
This error occurs because you have multiple copies of KeePassHttp in your KeePass directory! Please check __all__ PLGX- and DLL-files in your _KeePass directory and all sub-directories_ whether they are a copy of KeePassHttp.
152152
__Note:__ KeePass does _not_ detect plugins by filename but by extension! If you rename _KeePassHttp.plgx_ to _HelloWorld.plgx_ it is still a valid copy of KeePassHttp.
153153

154154
If you _really_ have only one copy of KeePassHttp in your KeePass directory another application seems to use port 19455 to wait for signals. In this case try to stop all applications and restart everyone again while checking if the error still occurs.
@@ -174,7 +174,7 @@ http://www.host.com/subdomain2|7
174174

175175
__Result:__ second entry is returned
176176

177-
177+
178178
## Security
179179

180180
For security reasons KeePassHttp communicates only with the symmetric-key algorithm AES.
@@ -226,7 +226,7 @@ This is the only point at which an administrator snooping traffic will be able t
226226

227227
### Generic HTTP request
228228
(based on packet sniffing and code analyssis)
229-
Generic HTTP request is json sent in POST message. Cipher, by means of OpenSSL library is `AES-256-CBC`, so key is 32 byte long.
229+
Generic HTTP request is json sent in POST message. Cipher, by means of OpenSSL library is `AES-256-CBC`, so key is 32 byte long.
230230

231231
```
232232
Host: localhost:19455
@@ -254,7 +254,7 @@ Request, without key, seems like initialization of every key assignation session
254254
"RequestType":"test-associate",
255255
"TriggerUnlock":false
256256
}
257-
```
257+
```
258258

259259
Response: (without success)
260260
```javascript
@@ -273,7 +273,7 @@ Response: (without success)
273273
}
274274
```
275275

276-
If you have key, you can test with request like this:
276+
If you have key, you can test with request like this:
277277
```javascript
278278
{
279279
"Nonce":"+bG+EpbCR4jSnjROKAAw4A==", // random 128bit vector, base64 encoded
File renamed without changes.

0 commit comments

Comments
 (0)