[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 [export-to-libmutton] desc = exports sshyp entries to ~/.local/share/sshyp.export for use with libmutton v0.3.X usage = sshyp export

this extension does not export to a format compatible with libmutton v0.4.X or later!!

for use with libmutton v0.4.X or later, run the output of this extension through the gpgToRCW binaries provided at https://github.com/rwinkhart/sshyp-labs/releases/tag/v2.0.0 exe = https://raw.githubusercontent.com/rwinkhart/sshyp-labs/main/extensions/export-to-libmutton/export-to-libmutton.py ini = https://raw.githubusercontent.com/rwinkhart/sshyp-labs/main/extensions/export-to-libmutton/export-to-libmutton.ini