google / google-authenticator-libpam

Apache License 2.0
1.75k stars 280 forks source link

Where is the content of the configuration file documented? #238

Open mrandreastoth opened 7 months ago

mrandreastoth commented 7 months ago

Where is the content of ~/.google_authenticator documented to allow it to be properly edited?

ThomasHabets commented 7 months ago

In FILEFORMAT.

Sorry for not saying that in the other bug. I thought it wasn't documented, but apparently I misremembered.

ThomasHabets commented 7 months ago

That file looks correct, but not complete. It doesn't include the grace period feature.

But for your purposes I don't think (the optional) grace periods matter.

mrandreastoth commented 7 months ago

No worries and thanks for the link 👍

mrandreastoth commented 7 months ago

By the way, which is the grace period question out of the following...?

Setup options.

ThomasHabets commented 7 months ago

Grace period is currently not part of the user config, but instead a PAM module wide option. See README.

I would not recommend enabling grace periods, and would not want the choice of enabling it to be up to the user. A possible alternative implementation would be to have a module option of allowing grace period, and then letting users enable it.