From 80425bec2ed30851eebd3d66812225df58d7e8a8 Mon Sep 17 00:00:00 2001 From: Randall Winkhart Date: Fri, 8 Dec 2023 18:19:57 -0500 Subject: [PATCH] Add pointer for future sshyp release v1.5.2 --- pointers/v1.5.2 | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 pointers/v1.5.2 diff --git a/pointers/v1.5.2 b/pointers/v1.5.2 new file mode 100644 index 0000000..4132b49 --- /dev/null +++ b/pointers/v1.5.2 @@ -0,0 +1,5 @@ +[sshyp-mfa] +desc = reads mfa/2fa secrets from sshyp entries to generate and copy totp/Steam otp keys to the clipboard +usage = sshyp / copy -m

to add mfa data to a sshyp entry, insert it into the SECOND notes line for a given entry using the following format:

otpauth:///?secret=&issuer=&algorithm=&digits=&period=

what to put in each of the above spaces:

is almost always 'totp', but in the case of Steam, it needs to be set to 'steam'.
is a part of the Authenticator backup format, but it is not used in sshyp-mfa. Set to anything.
refers to the secret used to generate your MFA key. This is usually directly provided by the issuer, but it is sometimes hidden and more easily retrieved by copying it from a QR-compatible MFA app (such as Aegis).
is a part of the Authenticator backup format, but it is not used in sshyp-mfa. Set to anything.
refers to the algorithm used to generate your MFA key based on your secret. This is almost always 'sha1'.
refers to the intended length of your MFA key. This is almost always '6', but in the case of Steam, it needs to be set to '5'.
refers to the interval at which a new MFA key needs to be generated. This is almost always '30', for 30 seconds.

examples:

GitHub (standard 6-digit totp):
otpauth://totp/MyNameIsBob?secret=YUGBSG65SG9SDBSDF56SBFVSC86SBVD6&issuer=GitHub&algorithm=sha1&digits=6&period=30

Steam (5-character totp):
otpauth://steam/SteamUser?secret=VGVG34GH2GJHVCK7HGVS7&issuer=Steam&algorithm=sha1&digits=5&period=30

for more information, visit:

https://github.com/rwinkhart/sshyp-labs/wiki/sshyp-mfa +exe = https://raw.githubusercontent.com/rwinkhart/sshyp-labs/v1.5.1.3/extensions/sshyp-mfa/sshyp-mfa.py +ini = https://raw.githubusercontent.com/rwinkhart/sshyp-labs/v1.5.1.3/extensions/sshyp-mfa/sshyp-mfa.ini