search

hackforla / admin-governance

Hack for LA's Core Team proceedings
2 stars 5 forks source link

Enabling two-factor authentication on your github account #20

Closed ExperimentsInHonesty closed 3 years ago

ExperimentsInHonesty commented 5 years ago

Overiew

Hack for LA requires two factor authentication (2FA) for Project Admins and it is recommended for all members.

Jump to Action Item: Setting up 2FA

What is 2FA?

Two-factor authentication, or 2FA, is an extra layer of security used when logging into websites or apps. With 2FA, you have to log in with your username and password and provide another form of authentication that only you know or have access to.

If you would like to read more information from github about 2FA: https://help.github.com/en/articles/securing-your-account-with-two-factor-authentication-2fa

Why setup 2FA now?

------------

Action Item - Setting up 2FA

GitHub's guide to setting up 2FA. - takes about 2 min.

ExperimentsInHonesty commented 5 years ago

You might encounter a challenge using the git CLI after enabling 2-factor auth. Here are steps to get CLI auth working again:

  1. Try pushing code from the CLI, if you get rejected unexpectedly it’s 2FA (if you enabled it)
  2. Clear your cached GH credentials
  3. Create a token at GH.com, which you’ll use as your CLI password

Thanks to @wesrowe for providing the instructions

thekaveman commented 5 years ago

It should also be noted that if you clone via the ssh URL for a repo e.g. 

git@github.com:hackforla/governance.git

instead of the https URL e.g.

https://github.com/hackforla/governance.git

then you probably won't run in to any issues after enabling 2FA, as you already use an SSH key.

Read more about connecting to GitHub with SSH.

ExperimentsInHonesty commented 3 years ago

Added 2FA guide to the website.https://www.hackforla.org/guide-pages/2FA