QTPass Guide: Difference between revisions

From Bibliotheca Anonoma
m (fix link)
(add new knowledge)
 
(One intermediate revision by the same user not shown)
Line 22: Line 22:
Install using Chocolatey (package manager):
Install using Chocolatey (package manager):
* Install Chocolatey package manager:
* Install Chocolatey package manager:
** https://chocolatey.org/install
https://chocolatey.org/install
* Install QTPass package:
* Install QTPass package:
** <code>>choco install qtpass</code>
<code>>choco install qtpass</code>


Configure git
Configure git
Line 31: Line 31:
Configure GPG
Configure GPG
* TODO Kleopatra setup
* TODO Kleopatra setup
* Verify by listing installed keys
<code> >gpg --list-keys </code>


Configure QTPass
Configure QTPass
* The settings window is opened by clicking on the slider icon at the top of the main window.
* Set path to Git executable
* Set path to Git executable
<code>C:/Program Files/Git/bin/git.exe</code>
* Set path to GPG executable
* Set path to GPG executable
TODO
<code>C:/Program Files (x86)/GnuPG/bin/gpg.exe</code>
* Set path to PWGen executable
<code>C:/Program Files (x86)/PWGen/PWGen.exe</code>
TODO: Figure out how to make PWGen work.
* Set key to use, the window to do this is opened by clicking on the person sillouette icon at the top of the main window.
* Create a profile in the settings window "Profiles" tab.
* (If needed) Initialize the git repo at the storage location:
<code>> git init C:\Users\Me\password-store</code>




=== Testing QTPass ===
=== Testing QTPass ===
TODO
TODO
Create a test entry in a test folder
* Create a test entry in a test folder
* TODO
TODO


Read back test entry
* Read back test entry
* TODO
TODO


=== Using a smartcard ===
=== Using a smartcard ===
TODO yubikey 5 smartcard
* TODO yubikey 5 smartcard


=== Using QTPass ===
=== Using QTPass ===
Line 54: Line 65:
* Read saved password / credentials
* Read saved password / credentials


* Renaming a password entry
Renaming an entry in the UI can rename the file to what you tell it to rename to, omitting the .gpg extention that is normally present on the file itself.
This can be fixed by going to the password store folder and adding the .gpg file extention
=== Migration into QTPass ===
=== Migration into QTPass ===
TODO bulk import of credentials
TODO bulk import of credentials
Line 61: Line 75:


* Tools for mass-import
* Tools for mass-import
TODO


* Manual import
* Manual import
 
TODO




Line 70: Line 85:
==== "could not read encryption key to use, .gpg-id file missing or invalid." ====
==== "could not read encryption key to use, .gpg-id file missing or invalid." ====
* Tracing error cause:
* Tracing error cause:
<br>Message originates in either of these two functions:
** Message originates in either of these two functions:
<br>"void ImitatePass::Insert(QString file, QString newValue, bool overwrite) {"
"void ImitatePass::Insert(QString file, QString newValue, bool overwrite) {"
<br>https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L95
https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L95
<br>or
or
<br>"void ImitatePass::reencryptPath(const QString &dir) {"
"void ImitatePass::reencryptPath(const QString &dir) {"
<br>https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L298
https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L298
* Resolution:
TODO
 
 
==== "fatal: not a git repository (or any of the parent directories): .git" ====
* Error message:
"fatal: not a git repository (or any of the parent directories): .git"
* Tracing error cause:


* Resolution: TODO
* Resolution: TODO
Manually initializing a git repo in the new password store location fixes this.
In folder of password storage:
<code> > git init . </code>




==== "fatal: not a git repository (or any of the parent directories): .git" ====
==== "fatal: not a git repository (or any of the parent directories): .git" ====
* Symptoms:
After enabling the use of PWGen for password creation, attempting to create a password results in PWGen opening with an error message followed by possible crash of QTPass.
* Error message:
PWGen encountered 1 error(s) during startup:
1) Unknown command line switch(es):
"-1"; "--secure"; "--capitalize"; "--numerals".
* Tracing error cause:
* Tracing error cause:
PWGen probably changed how it accepts arguments?
* Resolution:
TODO


* Resolution: TODO


=== Handy seeming links ===
=== Handy seeming links ===

Latest revision as of 03:34, 6 July 2020

QTPass Guide[edit]

  • Windows 10 is assumed.
  • Yubikey 5 smartcard is assumed.
  • Key generation is outside the scope of this article.
  • Ctrl-S is responsible for making this, but you can join in if you like.


Installation[edit]

Download software - git, gpg, qtpass (Preparation for install)

  • git
  • gpg
  • qtpass

TODO

Install software - git, gpg, qtpass

  • git
  • gpg
  • qtpass

TODO


Install using Chocolatey (package manager):

  • Install Chocolatey package manager:
https://chocolatey.org/install
  • Install QTPass package:

>choco install qtpass

Configure git

  • TODO Git setup

Configure GPG

  • TODO Kleopatra setup
  • Verify by listing installed keys

>gpg --list-keys

Configure QTPass

  • The settings window is opened by clicking on the slider icon at the top of the main window.
  • Set path to Git executable

C:/Program Files/Git/bin/git.exe

  • Set path to GPG executable

C:/Program Files (x86)/GnuPG/bin/gpg.exe

  • Set path to PWGen executable

C:/Program Files (x86)/PWGen/PWGen.exe

TODO: Figure out how to make PWGen work.
  • Set key to use, the window to do this is opened by clicking on the person sillouette icon at the top of the main window.
  • Create a profile in the settings window "Profiles" tab.
  • (If needed) Initialize the git repo at the storage location:

> git init C:\Users\Me\password-store


Testing QTPass[edit]

TODO

  • Create a test entry in a test folder
TODO
  • Read back test entry
TODO

Using a smartcard[edit]

  • TODO yubikey 5 smartcard

Using QTPass[edit]

TODO normal basic usage

  • Add new password / credentials
  • Read saved password / credentials
  • Renaming a password entry
Renaming an entry in the UI can rename the file to what you tell it to rename to, omitting the .gpg extention that is normally present on the file itself.
This can be fixed by going to the password store folder and adding the .gpg file extention

Migration into QTPass[edit]

TODO bulk import of credentials

  • Pick a consistant naming & organization scheme

First line should be the password itself (Does QTPass do this for the user?)

  • Tools for mass-import
TODO
  • Manual import
TODO


Resolving specific errors[edit]

"could not read encryption key to use, .gpg-id file missing or invalid."[edit]

  • Tracing error cause:
    • Message originates in either of these two functions:
"void ImitatePass::Insert(QString file, QString newValue, bool overwrite) {"
https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L95

or

"void ImitatePass::reencryptPath(const QString &dir) {"
https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L298
  • Resolution:
TODO


"fatal: not a git repository (or any of the parent directories): .git"[edit]

  • Error message:
"fatal: not a git repository (or any of the parent directories): .git"
  • Tracing error cause:
  • Resolution: TODO

Manually initializing a git repo in the new password store location fixes this. In folder of password storage: > git init .


"fatal: not a git repository (or any of the parent directories): .git"[edit]

  • Symptoms:
After enabling the use of PWGen for password creation, attempting to create a password results in PWGen opening with an error message followed by possible crash of QTPass.
  • Error message:
PWGen encountered 1 error(s) during startup:
1) Unknown command line switch(es):
"-1"; "--secure"; "--capitalize"; "--numerals".
  • Tracing error cause:
PWGen probably changed how it accepts arguments?
  • Resolution:
TODO


Handy seeming links[edit]

QTPass homepage:

PWGen-win homepage:

Appears to be modern home of Kleopatra / Windows GPG:

Appears to be older home of Kleopatra / Windows GPG:

Pass homepage:

GoPass:

Smartcard-related: