547c1267bc
unset GNUPGHOME variable
...
if not done, in the next step you get error:
gpg: keyblock resource '/home/..../gnupg-workspace/pubring.kbx': No such file or directory
gpg: no writable keyring found: Not found
4 years ago
03f0e40558
Merge branch 'master' of https://github.com/Amolith/YubiKey-Guide into Amolith-master
4 years ago
767b84eb3b
Add option to retrieve additionaly entropy from YubiKey itself
4 years ago
0e7dabeeeb
change defaults and add info to #Require touch
...
As mentioned in #197 , the previous behaviour would require users to
touch their key any time an authentication, signing, or encryption
operation was performed. In some situations, this behaviour would be
undesirable and the only way to revert it would be fully resetting the
key and starting from scratch. Rather than using `fixed`, this commit
simply turns the feature `on` so the user can change it later if they
wish.
Additionally, a note about the other policies was included so users can
decide for themselves which fits their situation better.
4 years ago
9bb54914b4
Merge branch 'master' into update-python-refs
4 years ago
697a7d8fb9
Merge pull request #203 from bengim/bengim-patch-PyOpenSSL
...
fixing wrong cryptography version
4 years ago
2187610c1d
Update README.md
...
fixing wrong cryptography version by explicitly installing PyOpenSSL
4 years ago
58b7c819d7
Python2 is EOL, update packages/references to Py3
4 years ago
8a95de3e3f
Correct spelling
4 years ago
a2bc415f84
Update wording
...
Ensure that is clear that we do not need to modify keys or even plug the yubikey
4 years ago
8a08a8ac15
Update notation section
4 years ago
c9ea04db2c
Add notations section
4 years ago
f6f2c26e90
Fix usage inconsistency
...
Master key shall only be used to certify other keys. The usage indicator in
README.md is inconsistently shown as SC and C.
4 years ago
78164e8bfd
Set touch policy to fixed.
...
Setting the touch policy to `on` does not prevent the policy from
later being turned off again. Setting it to `fixed` is more secure
because it can not be turned off.
If someone wants to disable the touch policy they can always restore
the keys from the backups created in the guide.
4 years ago
e1055025fe
Add information on potential PIN issues and how to debug them
...
I missed the error message when attempting to set a PIN of only 5 characters due
to the UI repeating the options below it.
Pinentry happily stores the bogus PIN and even counts down the retry counter
when entering the correct (default) one. This can be resolved by unblocking the
PIN.
Once I ran the gpg-agent with debug output (a tip found in the added link), the
issue was obvious.
4 years ago
ccb8b0130a
Stack rank secure environment and add a few tips
4 years ago
0bd52ed7d8
Merge pull request #185 from vald-phoenix/fix-borken-anchor
...
Fix broken anchor
4 years ago
1cf9656b33
Fix order of revocation command.
...
According to 'man gpg' the order of arguments should be
gpg [--homedir name] [--options file] [options] command [args]
In this case '--gen-revoke' is the command, '$KEYID' is an argument and
'--output $GNUPGHOME/revoke.asc' is an option. Previously this was
incorrect (option came first) and would spawn an error.
4 years ago
de13c8dba6
Include --expert when editing master key
...
This is specifically during setup when rotating keys.
4 years ago
4c1d538c60
Fix broken anchor
...
There are two anchors with the same name and this breaks navigation.
4 years ago
aea317b527
Clarified wording
4 years ago
07134a4e4f
GPG keys on multiple computers
...
I feel like this took me longer to figure out than it should have.
4 years ago
93cbbd9d8b
Address throw-keyids issue with mailvelope to fix #178
4 years ago
46d1d89115
Split export pubkey from backup to fix #175
4 years ago
bf38b94a65
Disambiguate backup volume label to fix #176 .
4 years ago
aad01ffde4
Merge pull request #180 from vald-phoenix/yubikey-reset-by-ykman
...
Describe ykman PGP keys reset
4 years ago
3be47a8c32
Merge pull request #179 from vald-phoenix/multiple-yubikeys
...
Describe card serial number error
4 years ago
a1a4a303f9
Merge pull request #177 from apiraino/revoke-cert
...
Add instructions to create a revoke certificate
4 years ago
afd3fafcc5
Merge pull request #170 from murphy83/Abort-Trick
...
Added some additonal text describing alternatives that may be used
4 years ago
44d76ac5ab
Describe card serial number error
4 years ago
6108558645
Describe ykman PGP keys reset
4 years ago
2698cecd4c
Add instruction to create a revoke certificate
4 years ago
b5adb349ad
Add steps for renewing (not rotating) sub-keys
...
As discussed in issue #164 , the current section on Rotating Keys
presents two alternatives: replacing the existing keys with a newly
generated key or extending the validity of existing keys by changing
their expiration. However, it only provides instructions for the
first approach. This commit adds instructions for renewing sub-keys.
I am far from an expert, and am submitting this change mostly in hopes
that it will provide documentation for the next time I need to renew
my sub-keys. I would welcome any changes or clarifications others
would care to offer.
4 years ago
db1d86cdd8
Added some additonal text describing alternatives that may be used
4 years ago
2c2cec316c
Bump Debian version, license year
4 years ago
2fc50760db
Merge pull request #160 from rvl/nixos
...
Add instructions for NixOS
4 years ago
51ed654e43
Merge pull request #159 from rvl/multiple-yubikeys
...
Add more detail about what to do with multiple YubiKeys
4 years ago
bb5184a0b3
Add instructions for NixOS
...
I just tested these steps on a spare laptop.
4 years ago
b45174f185
Add more detail about what to do with multiple YubiKeys
4 years ago
6cd76216c5
Add information about setting the primary user ID
4 years ago
8f10cd5819
Fix gnupg package name for Arch
...
`gnupg2` has been [removed since March 2012](https://lists.archlinux.org/pipermail/arch-dev-public/2012-March/022690.html )
4 years ago
bb0a0d1ac8
fix broken links
4 years ago
e4a063e0f0
Update GitHub instructions on Windows
...
Add command to instruct Git to use WinGPG
4 years ago
1b5a2fefd8
Formatting cleanup
4 years ago
be7addad3c
Use larger partition sizes to fix #149 .
4 years ago
908d3172a4
Fix typo in table of contents link
4 years ago
04127d566b
Document issue #145 and fix #142
4 years ago
11d6e1aff6
Fix url formatting
5 years ago
701d9eb50f
Update Debian version and fix #137
5 years ago
35e443f8cc
Mention yubikey-touch-detector
5 years ago
137300a713
Added a fix for failing ssh / GUI pinentry
5 years ago
010accf864
Add --keyserver flag pointing to Debian keyserver
...
Fixes #131
5 years ago
4524c11632
Added important note about pin caching #135
5 years ago
5f150b68e2
More lines with old debian version corrected
5 years ago
754e480792
New Debian version: 10.1.0
...
Before curl returned http/404
5 years ago
13b9a92985
Update VM option
5 years ago
0f5df64094
Update README.md
...
Added primary source stating confirming that devices are read only in all but a few circumstances and that Keys ("secrets") cannot be read after being written to the device
5 years ago
541f8717e6
Merge pull request #126 from vorburger/patch-2
...
clarify that SSH_AUTH_SOCK should only be set locally, not on the remote server
5 years ago
42065a3b65
put additional information into single line
5 years ago
18320b0562
Merge pull request #128 from vorburger/patch-4
...
add 'sshd -eddd' Troubleshooting tip
5 years ago
57e712b830
Merge pull request #129 from vorburger/patch-5
...
fix link to YubiKey (non-NEO) Manager (fixes #124 )
5 years ago
877a4a7e99
Merge pull request #127 from vorburger/patch-3
...
simplify Agent Forwarding (RemoteForward typically not required)
5 years ago
8e8c138362
fix link to YubiKey (non-NEO) Manager ( fixes #124 )
5 years ago
ae35e707b6
add 'sshd -eddd' Troubleshooting tip
5 years ago
dd1a3ce4a8
simplify Agent Forwarding (RemoteForward typically not required)
5 years ago
de193ee363
clarify that SSH_AUTH_SOCK should only be set locally, not on the remote server
5 years ago
8ba087efe4
fix link to Remote Machines (Agent Forwarding) in TOC
5 years ago
5bbad1fc4c
Mention forwarding risk and Ubuntu multiverse repository, fix #116 .
5 years ago
e1d5e6fb9d
Fix typo from #122
5 years ago
f8880975b8
DOC: justify why you would want to sign your new key
5 years ago
5df1226971
DOC: notes an adding more emails
5 years ago
de7675f7a9
DOC: add section on signing with existing key
5 years ago
96c15ba3f3
Merge pull request #120 from timcooijmans/patch-1
...
Describe how to enable mailvelope on MacOS
5 years ago
3ae1656f5d
Update README.md
...
When adding GPG SSH agent configuration to shell rc file, redirect output of gpg-connect-agent to /dev/null so that it doesn't output `OK` every time you bring up a new shell
5 years ago
2309e2903d
Fix formatting
5 years ago
e7d2507c47
Add description on how to enable mailvelope
5 years ago
399127c43d
Move output option to earlier in command
...
The output option dosen't seem to work on Windows when it is at the end of the command. Moving it to earlier in the command fixes this issue.
5 years ago
f36447a85b
State that `set-touch` used to be `touch`
5 years ago
6482036e17
Bump debian version and fix some grammar.
5 years ago
fddefb5245
Fix 'Require Touch' syntax
...
The syntax to change Yubikey touch configurations has changed. Updating this accordingly.
5 years ago
48bf452e4b
Feature simpler multiple key workaround
5 years ago
09f3822a19
Link to multiple keys discussions. Fix #19 . Fix #112 .
5 years ago
1544d14689
Fix link to supply chain attacks
5 years ago
b745f1d90e
Add card reset steps, clean up formatting.
5 years ago
46601736f6
Adding link to summary for 'Using multiple YubiKey with same GPG keys' section
5 years ago
b101259a27
Multiple Yubikey with same GPG Keys, serial number issue, GnuPG workaround to switch to another key
5 years ago
1b9fc107c0
Fix date string format
5 years ago
4552bb45e1
Correct date invocation
...
The correct syntax is `date +FORMAT`
5 years ago
04bef18b0c
Add section on key rotation to fix #101
5 years ago
7661d79b51
Mention Thunderbird, clean up agent forwarding. Fix #85 .
5 years ago
f8d6dec18f
Better openbsd backup instructions, slimmer TOC
5 years ago
bf05e0e7c4
Better backup and testing instructions
5 years ago
a6bc874713
Increment debian image version
5 years ago
c5e1d96d84
fix(link): update links to latest version (old ones 404)
5 years ago
5007059085
Fix link anchor issue
...
fix 'Save public key for identity file configuration' markdown link
fix 'Remote Machines (agent forwarding)' markdown link
5 years ago
13c8fcf647
no need to support the monopoly
5 years ago
6d4035252a
Add Verify Yubikey section
5 years ago
3ed8f56557
Add hint for setting up gpg-agent socket
...
On my system (Linux Mint) `gpgconf --list-dirs agent-ssh-socket` does return all dirs and not only the one for agent-ssh-socket hence `ssh-add -L` was failing. This is a hint for other people to troubleshoot this behaviour.
5 years ago
e4cb903ef4
debian iso has change from 9.6.0 -> 9.7.0
5 years ago
e05dc4b5bd
Update license and formatting
5 years ago
457e22d473
Move install instructions to the top
...
Section `Creating keys` ends with `Disable networking for the
remainder of the setup.`. All instructions that require a network
should be before this sentence.
5 years ago
303cb25d4d
Update license year, style and grammar
5 years ago
3f4480db25
Update openbsd instructions
5 years ago
381088ba79
Merge pull request #92 from tacaswell/doc_arch_install
...
DOC: add install instructions for Arch linux and RHEL
5 years ago
7dbc05977e
DOC: update for packages to install on RHEL
5 years ago
9e7a3225ae
DOC: add install instructions for Arch linux
5 years ago
7115f9a385
Master key should have Certify-capability only!
5 years ago
bba51c10cc
Fix typo
...
IdentityFiles can be passed to ssh via `-i`, not `-l`.
The next paragraph mentions the correct argument.
ref commit 52c8324fa2drduh/YubiKey-Guide#65
5 years ago
8ea5900d4e
Style and console formatting, tips for multiple key use
5 years ago
ee71716ed7
Added pull request suggestions
5 years ago
c28b33372c
Moved Agent Forwarding section to before the WSL one
5 years ago
b44f6131ef
Further amendments to Agent Forwarding
5 years ago
7eed0ccef8
Improvements to Agent Forwarding section, following feedback in:
...
https://github.com/drduh/YubiKey-Guide/issues/85
5 years ago
3a872d40fe
Fix keyserver command order to fix #86
5 years ago
8f724a4df5
Add addition note about red hokey output
5 years ago
19b1297c22
Merge pull request #84 from hughobrien/mention-tmpfs
...
describe tmpfs clearing rather than init system (debian uses tmpfs)
5 years ago
3174935f99
Merge pull request #83 from hughobrien/gpg-conf-key-origin
...
remove broken gpg option (debian 9.6)
5 years ago
a6431962a6
remove broken gpg option (debian 9.6)
...
As per [0], the --with-key-origin option is experimental.
0: https://www.gnupg.org/documentation/manuals/gnupg/GPG-Input-and-Output.html#index-with_002dkey_002dorigin
5 years ago
0f6e9948d7
mention debian-live user/pass in case of screen lock
5 years ago
80d5c0ed6c
describe tmpfs clearing rather than init system (debian uses tmpfs)
5 years ago
94919459a6
Update gpg prefs, style and fix #21 .
5 years ago
7746c3381a
Emphasize keytocard danger and fix inconsistency.
...
This commit applies a few editorial cleanups to the document:
1. `keytocard` operations now contained emphasized warnings to convey
that these operations are destructive. I unknowingly made this
mistake a few years ago and only learned of it recently. For that
reason, we should go out of our way on user's behalf with due
diligence warnings.
2. `$KEYID` was not uniformly used throughout the document in various
command line input literals. This is now fixed.
3. `YubiKey` was often represented as `Yubikey` and other
inconsistent forms throughout the document. This is now fixed,
except in cases of URL, command output, etc.
6 years ago
a68fa27309
Merge pull request #79 from Wheest/master
...
Agent Forwarding
6 years ago
4e23c63bb4
Agent Forwarding
...
Was looking at how to access on remote machines, is a standard ssh workflow, but might be useful to have it here too.
6 years ago
86e03e6d09
final draft
6 years ago
ee30767612
final draft
6 years ago
ffd7b674c8
updated draft
6 years ago
95624e2c48
first draft
6 years ago
1c15d89a54
maow
6 years ago
92467bc126
test
6 years ago
f39b92ae45
test sign
6 years ago
2b5891294a
Update README.md
...
continuing
6 years ago
afc8580b0d
Update README.md
...
test
6 years ago
d818b03cdc
Grammar and lint. Fix #73 .
6 years ago
857adb26a2
Update live Debian version to 9.6.0
6 years ago
472d85d12b
fix typo
6 years ago
f1a97fc6d5
Note about gpg public key
6 years ago
6f76e6a197
Update README.md
...
gpg option to edit card info is now `--card-edit` and not `--edit-card`
6 years ago
d02766389d
Add packages to apt-get list to fix gpg --recv and srm commands
...
Two commands mentioned later in the document won't work without two packages that don't come pre-installed with the Debian LiveCD: dirmngr and secure-delete.
6 years ago
96af4d3b3b
Merge pull request #70 from jwilk-forks/gpg-verify
...
Fix live image integrity check
6 years ago
d7a14b078c
Fix live image integrity check
...
"gpg SHA512SUMS.sign" would do the right thing only if the file actually
contained a detached signature.
Use explicit and robust "gpg --verify SHA512SUMS.sign SHA512SUMS"
instead.
6 years ago
3be71bd253
Fix typos
6 years ago
27bef99239
Massive style revision and version update
6 years ago
34a5502477
typos
6 years ago
52c8324fa2
Expand on ssh identies usage.
6 years ago
aad57241e9
Fix key label, consistency.
6 years ago
b67776a2b2
Fix TOC, spelling.
6 years ago
d33252848d
Added information on `gpg-agent`.
6 years ago
840b4069f2
Fix "signingkey" typo
6 years ago
dad5bcd5fc
Added comment on GitHub Authetication for only Windows
6 years ago
Rudy Gevaert